Skip to main content
POST
/
creatives
Create a creative
curl --request POST \
  --url https://your_a2_service/creatives \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "banner",
  "banner": {
    "ext": {},
    "img": "",
    "link": {
      "ext": {},
      "url": ""
    }
  },
  "cid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "height": 0,
  "native": {
    "ext": {},
    "link": {
      "ext": {},
      "url": ""
    }
  },
  "status": "inactive",
  "updated_at": "2023-11-07T05:31:56Z",
  "video": {
    "adm": "",
    "ctype": 2,
    "dur": 0,
    "ext": {
      "cdn": "",
      "linear": 1,
      "link": {
        "ext": {},
        "url": ""
      },
      "url": ""
    },
    "mime": ""
  },
  "width": 0
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "no": 123,
  "owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "banner",
  "banner": {
    "ext": {},
    "img": "",
    "link": {
      "ext": {},
      "url": ""
    }
  },
  "cid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "height": 0,
  "native": {
    "ext": {},
    "link": {
      "ext": {},
      "url": ""
    }
  },
  "status": "inactive",
  "updated_at": "2023-11-07T05:31:56Z",
  "video": {
    "adm": "",
    "ctype": 2,
    "dur": 0,
    "ext": {
      "cdn": "",
      "linear": 1,
      "link": {
        "ext": {},
        "url": ""
      },
      "url": ""
    },
    "mime": ""
  },
  "width": 0
}

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.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Represents a creating creative entity.

​
name
string
required

The name of creative

​
owner_id
string<uuid>
required

The owner's id of creative

​
type
enum<string>
required

The type of creative

Available options:
banner,
video,
native
​
banner
Banner · object

Represents a banner creative with image, link, and optional extensions.

​
cid
string<uuid> | null

The id of the campaign the creative is used in

​
created_at
string<date-time>

The time the creative was created

​
description
string | null

The creative's description

​
height
integer | null
default:0

The height that will be shown

​
native
Native · object

Represents a native creative with link and optional extensions.

​
status
enum<string>
default:inactive

The status of creative

Available options:
active,
inactive
​
updated_at
string<date-time>

The time the creative was updated

​
video
Video · object

Represents a video creative with MIME type, URL, and optional extensions.

​
width
integer | null
default:0

The width that will be shown

Response

Successful Response

Represents a reading creative entity.

​
id
string<uuid>
required

The id of creative

​
name
string
required

The name of creative

​
no
integer
required

The no of creative

​
owner_id
string<uuid>
required

The owner's id of creative

​
type
enum<string>
required

The type of creative

Available options:
banner,
video,
native
​
banner
Banner · object

Represents a banner creative with image, link, and optional extensions.

​
cid
string<uuid> | null

The id of the campaign the creative is used in

​
created_at
string<date-time>

The time the creative was created

​
description
string | null

The creative's description

​
height
integer | null
default:0

The height that will be shown

​
native
Native · object

Represents a native creative with link and optional extensions.

​
status
enum<string>
default:inactive

The status of creative

Available options:
active,
inactive
​
updated_at
string<date-time>

The time the creative was updated

​
video
Video · object

Represents a video creative with MIME type, URL, and optional extensions.

​
width
integer | null
default:0

The width that will be shown