> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiderx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update an audience segment

> 오디언스 세그먼트를 업데이트합니다.



## OpenAPI

````yaml /openapi/adm.openapi.ko-0.2.2.json patch /audiences/segments
openapi: 3.1.0
info:
  description: >-
    ## 소개

    Data Management API는 광고 및 추천 시스템이 활용하는 **다양한 데이터를** 종합적으로 관리해, Decision API가
    정확하고 효율적으로 작동할 수 있도록 돕습니다.


    캠페인이나 지면을 신규 등록하고 수정·삭제하는 것은 물론, **로그 및 통계 분석을** 통해 시스템 운영에 필요한 인사이트를 확보합니다.
    이렇게 확보된 데이터와 통계는 Decision API에서 최적화된 광고·콘텐츠를 결정하는 데 활용되며, 전체 광고·추천 시스템의 성능
    향상에 이바지합니다.
  title: Data Management APIs
  version: 0.1.3
servers: []
security: []
tags:
  - name: Audience Targeting
  - description: >
      오디언스 관리 API를 사용하여 오디언스 관련 데이터를 통합할 수 있습니다.


      참고:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Audience
  - description: >
      광고 타겟팅 및 성과 최적화를 위한 사용자 활동 로그 수집 API.


      활동 로그는 광고 상호작용 여부와 관계없이 모든 사용자의 상품 조회, 검색, 장바구니 추가, 구매 등 실제 사용자 행동을 기록합니다.


      참고:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Activity Log
  - description: >
      오디언스 속성 API로 오디언스 속성 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Attribute
  - description: >
      오디언스 세그먼트 API로 오디언스 세그먼트 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Segment
  - description: >
      광고 타겟팅 및 성과 최적화를 위한 사용자 활동 로그 수집 API.


      활동 로그는 광고 상호작용 여부와 관계없이 모든 사용자의 상품 조회, 검색, 장바구니 추가, 구매 등 실제 사용자 행동을 기록합니다.


      참고:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Activity Log
  - description: >
      오디언스 속성 API로 오디언스 속성 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Attribute
  - description: >
      오디언스 세그먼트 API로 오디언스 세그먼트 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Segment
  - description: 분석 API는 대시보드 및 A2 메트릭 데이터에 액세스할 수 있습니다.
    name: Analytic
  - description: >-
      결제 정보를 관리하는 결제 API입니다.

      A2는 리테일 플랫폼에서 사용하는 결제 시스템과 통합되도록 구성되어 있습니다.


      결제를 통합하려면 먼저 외부 채널을 등록해야 합니다.

      결제 시스템과 통합하는 방법에 대한 자세한 내용은 [외부 채널
      페이지](https://docs.aiderx.io/guides/about-a2/en/external-channel)를 참고하세요.
    name: Billing
  - description: |
      캠페인 데이터를 관리하는 캠페인 API입니다.

      관련 문서:
      - [Campaign](https://docs.aiderx.io/guides/about-a2/en/campaign)
    name: Campaign
  - description: |
      소재 및 관련 리소스를 관리하는 크리에이티브 API입니다.

      관련 문서:
      - [Creative](https://docs.aiderx.io/guides/about-a2/en/creative)
    name: Creative
  - description: |
      배정 및 관련 리소스를 관리하는 할당 API입니다.

      관련 문서:
      - [Allocation](https://docs.aiderx.io/guides/about-a2/en/allocation)
    name: Allocation
  - description: |
      미디어 라이브러리 및 관련 리소스를 관리하는 미디어 라이브러리 API입니다.

      관련 문서:
      - [Media Library](https://docs.aiderx.io/guides/about-a2/en/media-library)
    name: Media Library
  - description: |
      소재 및 관련 리소스를 관리하는 크리에이티브 API입니다.

      관련 문서:
      - [Creative](https://docs.aiderx.io/guides/about-a2/en/creative)
    name: Creative
  - description: |
      배정 및 관련 리소스를 관리하는 할당 API입니다.

      관련 문서:
      - [Allocation](https://docs.aiderx.io/guides/about-a2/en/allocation)
    name: Allocation
  - description: |
      미디어 라이브러리 및 관련 리소스를 관리하는 미디어 라이브러리 API입니다.

      관련 문서:
      - [Media Library](https://docs.aiderx.io/guides/about-a2/en/media-library)
    name: Media Library
  - description: >
      카탈로그 관리 API는 카탈로그 및 관련 리소스를 관리하는 기능을 제공합니다.


      관련 문서:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Catalog
  - description: |
      지면 관리 API는 지면 및 관련 리소스를 관리하는 기능을 제공합니다.

      관련 문서:
      - [Placement](https://docs.aiderx.io/guides/about-a2/en/placement)
    name: Placement
  - description: |
      지면 카탈로그는 지면 정보를 구조화된 “광고 제품”으로 변환하여 광고주에게 쉽게 제시할 수 있습니다.

      관련 문서:
      - 업데이트 예정
    name: Placement Catalog
  - description: |
      지면 카탈로그는 지면 정보를 구조화된 “광고 제품”으로 변환하여 광고주에게 쉽게 제시할 수 있습니다.

      관련 문서:
      - 업데이트 예정
    name: Placement Catalog
  - description: >
      시스템 레벨 설정 및 자산(로고 및 구성 값)에 액세스하고 관리할 수 있는 시스템 API입니다.


      관련 문서:

      - [Yield Optimization
      Settings](https://docs.aiderx.io/guides/about-a2/en/yield-optimization)
    name: System
  - description: >
      인증 및 사용자 관리 기능을 제공합니다.


      관련 문서:

      - [Account and
      Budget](https://docs.aiderx.io/guides/about-a2/en/account-and-budget)
    name: Auth and User
  - description: 라이선스 관리 기능을 제공합니다.
    name: License
  - description: 라이선스 관리 기능을 제공합니다.
    name: License
paths:
  /audiences/segments:
    patch:
      tags:
        - Audience Segment
      summary: Update an audience segment
      description: 오디언스 세그먼트를 업데이트합니다.
      operationId: handle_update_audience_segment_audiences_segments_patch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceSegmentUpdateSchema'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceSegmentReadSchema'
          description: Successful Response
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPExceptionResponse'
          description: Bad Request
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPExceptionResponse'
          description: Forbidden
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - OAuth2PasswordBearer: []
components:
  schemas:
    AudienceSegmentUpdateSchema:
      description: 오디언스 세그먼트 수정 스키마
      properties:
        approximated_size:
          anyOf:
            - type: integer
            - type: 'null'
          description: 예상 세그먼트 크기
          title: Approximated Size
        created_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: 생성 일시
          title: Created At
        deprecated_properties:
          additionalProperties:
            items: {}
            type: array
          description: 더 이상 사용하지 않는 속성 목록
          title: Deprecated Properties
          type: object
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: 세그먼트 설명
          title: Description
        id:
          format: uuid
          title: Id
          type: string
        management_type:
          description: 세그먼트 관리 유형
          enum:
            - selfmanaged
            - systemmanaged
          title: Management Type
          type: string
        name:
          description: 세그먼트 이름
          title: Name
          type: string
        owner_id:
          description: 소유자 ID
          format: uuid
          title: Owner Id
          type: string
        properties:
          additionalProperties:
            items: {}
            type: array
          default: {}
          description: |-
            세그먼트 속성

            키는 AudienceAttribute.code, 값은 AudienceAttributeValue.value 목록
          title: Properties
          type: object
        updated_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: 변경 일시
          title: Updated At
      required:
        - name
        - management_type
        - owner_id
        - id
      title: AudienceSegmentUpdateSchema
      type: object
    AudienceSegmentReadSchema:
      description: 오디언스 세그먼트 조회 스키마
      properties:
        approximated_size:
          anyOf:
            - type: integer
            - type: 'null'
          description: 예상 세그먼트 크기
          title: Approximated Size
        created_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: 생성 일시
          title: Created At
        deprecated_properties:
          additionalProperties:
            items: {}
            type: array
          description: 더 이상 사용하지 않는 속성 목록
          title: Deprecated Properties
          type: object
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: 세그먼트 설명
          title: Description
        id:
          format: uuid
          title: Id
          type: string
        management_type:
          description: 세그먼트 관리 유형
          enum:
            - selfmanaged
            - systemmanaged
          title: Management Type
          type: string
        name:
          description: 세그먼트 이름
          title: Name
          type: string
        'no':
          title: 'No'
          type: integer
        owner_id:
          description: 소유자 ID
          format: uuid
          title: Owner Id
          type: string
        properties:
          additionalProperties:
            items: {}
            type: array
          description: |-
            세그먼트 속성

            키는 AudienceAttribute.code, 값은 AudienceAttributeValue.value 목록
          title: Properties
          type: object
        updated_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: 변경 일시
          title: Updated At
      required:
        - name
        - management_type
        - owner_id
        - id
        - 'no'
      title: AudienceSegmentReadSchema
      type: object
    HTTPExceptionResponse:
      description: HTTP 오류 응답
      properties:
        detail:
          description: 오류에 대한 상세 설명
          title: Detail
          type: string
      required:
        - detail
      title: HTTPExceptionResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    OAuth2PasswordBearer:
      flows:
        password:
          scopes: {}
          tokenUrl: auth/jwt/login
      type: oauth2

````