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

> 
Stores allocation information between placements and campaigns.
Used to determine eligible campaigns during mediation.




## OpenAPI

````yaml /openapi/decision.api.en-0.2.2.json post /api/cache/allocations
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/allocations:
    post:
      tags:
        - Cache Management
      summary: Update Allocations
      description: |

        Stores allocation information between placements and campaigns.
        Used to determine eligible campaigns during mediation.
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/Allocation'
              type: array
        required: true
      responses:
        '204':
          description: Success
        '404':
          description: Allocation not found.
        '500':
          description: Internal Server Error.
      security:
        - '': []
components:
  schemas:
    Allocation:
      properties:
        cid:
          description: Campaign id
          type:
            - string
            - 'null'
        crid:
          description: Creative id
          type:
            - string
            - 'null'
        ext:
          $ref: '#/components/schemas/AllocationExt'
          description: for various configuration
        last_comment:
          description: Last comment
          type: string
        'no':
          description: ID of the allocation
          format: int64
          type: integer
        status:
          description: Status
          type: string
        tagid:
          description: Placement ID
          type: string
      required:
        - ext
        - last_comment
        - 'no'
        - status
        - tagid
      type: object
    AllocationExt:
      properties:
        frequency_capping:
          $ref: '#/components/schemas/FrequencyCapping'
      required:
        - frequency_capping
      type: object
    FrequencyCapping:
      properties:
        enabled:
          description: >-
            Enables frequency capping (1: enabled, 0: disabled). When enabled,
            user-level ad delivery limits are enforced.
          format: int32
          type: integer
        limit_multiple_click:
          description: >-
            Prevents multiple clicks from the same user on the same ad. 1 to
            enable, 0 to disable.
          format: int32
          type: integer
        user_limit_count:
          description: >-
            Maximum number of impressions allowed per user during
            `user_limit_days`.
          format: int32
          type: integer
        user_limit_days:
          description: >-
            Duration in days over which user impressions are counted. Used in
            combination with `user_limit_count`.
          format: int32
          type: integer
      required:
        - enabled
        - limit_multiple_click
        - user_limit_count
        - user_limit_days
      type: object

````