> ## 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 Creatives

> ## 크리에이티브 등록

크리에이티브 정보를 캐시에 저장합니다.  
광고 제공 중 광고 응답을 구성하는 데 사용됩니다.



## OpenAPI

````yaml /openapi/decision.api.ko-0.2.2.json post /api/cache/creatives
openapi: 3.1.0
info:
  contact:
    email: a2support@aiderx.io
    name: A2 Support
    url: https://aiderx.io
  description: |-
    ### 소개
    이 문서는 Decision API의 Ad Serving API 및 Recommendation API 구성 요소를 다룹니다.
  title: Decision APIs
  version: v0.2.2
  x-logo:
    altText: A2 Logo
    url: >-
      https://cdn.prod.website-files.com/668de9e1f25ab5675d87758d/6690cf1bdce95af5e3522c25_a2_logo_800_250.png
servers: []
security: []
tags:
  - description: |
      광고 전환, 노출, 클릭 로그를 수신하는 API — 광고 성능 추적 및 최적화에 필수적입니다.
    name: Ad Serving
  - description: >-
      광고 서빙 서버 캐시 관리 API


      ### **중요**

      Serving 서버의 광고 또는 추천 관련 캐시 데이터를 직접 조작하는 경우, Ad Manager를 통해 광고 또는 추천 데이터를
      **동시에 수정하지 않을 것을 강력히 권장합니다.**

      Serving 서버에서 수행된 변경 사항은 Ad Manager에 반영되지 않으며,

      이는 **데이터 무결성**을 위협할 수 있습니다.
    name: Cache Management
  - description: 광고 서빙 서버 설정 API
    name: Configuration
  - description: |
      광고 전환, 노출, 클릭 로그를 수신하는 API — 광고 성능 추적 및 최적화에 필수적입니다.
    name: Ad Serving
paths:
  /api/cache/creatives:
    post:
      tags:
        - Cache Management
      summary: Update Creatives
      description: |-
        ## 크리에이티브 등록

        크리에이티브 정보를 캐시에 저장합니다.  
        광고 제공 중 광고 응답을 구성하는 데 사용됩니다.
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/Creative'
              type: array
        required: true
      responses:
        '204':
          description: 성공
        '404':
          description: 크리에이티브를 찾을 수 없습니다.
        '500':
          description: 내부 서버 오류.
      security:
        - '': []
components:
  schemas:
    Creative:
      properties:
        banner:
          default:
            ext: {}
            img: ''
            link:
              ext: {}
              url: ''
          description: >-
            Banner creative content (custom format). Note: This format is not
            identical to OpenRTB's banner object.
        cid:
          description: Campaign ID this creative belongs to.
          type: string
        description:
          description: Optional description of the creative.
          type:
            - string
            - 'null'
        height:
          description: Height of the creative in pixels.
          format: uint32
          minimum: 0
          type: integer
        id:
          description: Unique identifier for the creative (UUID v4).
          type: string
        name:
          description: Human-readable name of the creative.
          type: string
        native:
          default:
            ext: {}
            link:
              ext: {}
              url: ''
          description: >-
            Native creative content (custom format). Note: This format is not
            identical to OpenRTB's native object.
        owner_id:
          description: Owner ID of the creative (e.g., advertiser or account owner).
          type: string
        status:
          description: Status of the creative (e.g., "active", "inactive").
          type: string
        type:
          description: >-
            Type of the creative (e.g., "banner", "video", "native"). Refer to:
            `a2_adm/db/models/creative.py:Creative`
          type: string
        video:
          $ref: '#/components/schemas/Video'
          default:
            adm: ''
            ctype: 2
            dur: 0
            ext:
              cdn: ''
              linear: 1
              url: ''
            mime:
              - video/mp4
          description: >-
            Video creative content (custom format). Note: This format is not
            identical to OpenRTB's video object.
        width:
          description: Width of the creative in pixels.
          format: uint32
          minimum: 0
          type: integer
      required:
        - cid
        - height
        - id
        - name
        - owner_id
        - status
        - type
        - width
      type: object
    Video:
      properties:
        adm:
          type:
            - string
            - 'null'
        api:
          items:
            $ref: '#/components/schemas/ApiFramework'
          type:
            - array
            - 'null'
        ctype:
          anyOf:
            - $ref: '#/components/schemas/CreativeSubtypesAudioVideo'
            - type: 'null'
        curl:
          type:
            - string
            - 'null'
        dur:
          format: uint32
          minimum: 0
          type:
            - integer
            - 'null'
        ext: true
        mime:
          items:
            type: string
          type:
            - array
            - 'null'
      type: object
    ApiFramework:
      oneOf:
        - enum:
            - VPAID1_0
            - VPAID2_0
            - MRAID1_0
            - ORMMA
            - MRAID2_0
            - MRAID3_0
            - OMID1_0
            - SIMID1_0
            - SIMID1_1
          type: string
        - additionalProperties: false
          properties:
            VendorSpecific:
              format: uint16
              minimum: 0
              type: integer
          required:
            - VendorSpecific
          type: object
    CreativeSubtypesAudioVideo:
      oneOf:
        - enum:
            - VAST1_0
            - VAST2_0
            - VAST3_0
            - VAST1_0Wrapper
            - VAST2_0Wrapper
            - VAST3_0Wrapper
            - VAST4_0
            - VAST4_0Wrapper
            - DAAST1_0
            - DAAST1_0Wrapper
            - VAST4_1
            - VAST4_1Wrapper
            - VAST4_2
            - VAST4_2Wrapper
          type: string
        - additionalProperties: false
          properties:
            VendorSpecific:
              format: uint16
              minimum: 0
              type: integer
          required:
            - VendorSpecific
          type: object

````