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

> 
Stores creative information in the cache.
Used to build ad responses during ad serving.




## OpenAPI

````yaml /openapi/decision.api.en-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: >+

    ### Introduction

    The Decision API is responsible for selecting and distributing ads or
    content based on user requests or contextual information, all in real time.

    Its rapid response and dynamic capabilities enable the **optimal** ad or
    recommendation to be served, ensuring users receive the highest possible
    value.


    A variety of algorithms, machine learning models, and rule-based logic can
    be applied, allowing the system to **adapt flexibly** to constantly changing
    conditions.

  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: >

      Ad Serving APIs for requesting ads and configuring cache settings and
      other parameters of the ad serving modules.
    name: Ad Serving
  - description: >-

      APIs for manipulating caches of the serving server.


      ### **Important**

      If you directly manipulate the cached data related to advertising or
      recommendations on the Serving server,

      we **strongly advise** against also modifying the advertising or
      recommendation data through the Ad Manager.


      Alternatively, we **recommend** handling any advertising or recommendation
      data modifications via the Ad Manager APIs.

      Any changes made on the Serving server will **not** be reflected in the Ad
      Manager,

      which can compromise **data integrity**.
    name: Cache Management
  - description: |-

      APIs for manipulating configurations of the serving server
    name: Configuration
  - description: >

      APIs for receiving ad conversion, impression, and click logs — essential
      for tracking and optimizing advertisement performance.
    name: Ad Serving
paths:
  /api/cache/creatives:
    post:
      tags:
        - Cache Management
      summary: Update Creatives
      description: |

        Stores creative information in the cache.
        Used to build ad responses during ad serving.
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/Creative'
              type: array
        required: true
      responses:
        '204':
          description: Success
        '404':
          description: Creative not found.
        '500':
          description: Internal Server Error.
      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

````