Beladed Docs
Help Sign in Create account

Beladed Ads API

Audience Choice

beta

Audience Choice through the reviewed Beladed Ads contract.

POST/api/ads/placement/choice/{placementId}
curl --request POST 'https://api.beladed.dev/api/ads/placement/choice/id_demo_001' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "choiceData": {
    "selection": "option_a",
    "userId": "id_demo_001",
    "reason": "more_relevant"
  }
}'

Parameters

placementIdpathrequired

string — The placementId for this request.

Example: id_demo_001

Request body

Requestapplication/json
Schema
{
  "type": "object",
  "properties": {
    "choiceData": {
      "type": "object",
      "properties": {
        "selection": {
          "type": "string"
        },
        "userId": {
          "type": "string"
        },
        "reason": {
          "type": "string"
        }
      }
    }
  }
}
{
  "choiceData": {
    "selection": "option_a",
    "userId": "id_demo_001",
    "reason": "more_relevant"
  }
}

Responses

200The request succeeded.
Responseapplication/json
Schema
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "status": {
          "type": "string"
        }
      }
    },
    "requestId": {
      "type": "string"
    }
  }
}
{
  "data": {
    "id": "id_demo_001",
    "status": "available"
  },
  "requestId": "req_demo_001"
}

Errors

400invalid_request

The request did not satisfy the documented contract.

404not_found

The requested public or account-owned resource was not found.

429rate_limited

Retry after the current product limit resets.

Reliability

Idempotency
No public Idempotency-Key guarantee is declared; use a stable client reference and confirm resource state before retrying.
Pagination
Not applicable.
Rate limit
Subject to current account, product, and abuse-protection limits. Honor Retry-After when returned.
Webhook events
No related public event is declared.

Contract provenance

This operation is published from reviewed repository contracts. Source metadata is included for traceability without exposing internal implementation details.

Route owner
../beladed-api-cloudflare/src/functions/ads.js
Handler owner
../beladed-api-cloudflare/src/functions/core/AdsPlacement.js
Verified
2026-07-11
Type to search the complete public documentation catalog.