Skip to content

Get dynamic content optimizations

POST
/dynamic-content-optimizations
curl --request POST \
--url https://portal.staging.arago-tech.com/dynamic-content-optimizations \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "ids": [ "63e2d42a27ad5f2b345ca124" ] }'

Get dynamic content optimizations for given IDs

The request to get dynamic content optimizations by their unique identifiers

Media typeapplication/json
Get dynamic content optimizations

The request to get dynamic content optimizations by their unique identifiers

object
ids
required
Dynamic Content Optimization IDs

The unique identifiers of the dynamic content optimizations to get

Array<string>
Example
[
"63e2d42a27ad5f2b345ca124"
]

A successful response.

Media typeapplication/json
object
dynamic_content_optimizations
Array<object>
DynamicContentOptimization

Dynamic content optimization details

object
id

Unique identifier for the dynamic content optimization.

string
destination_url

The destination URL for the dynamic content.

string
data

Arbitrary case-sensitive key-value pairs for dynamic content substitution at ad rendering time.

  • Maximum 100 entries.
  • Keys must be <= 32 characters.
  • Values must be <= 4096 characters.
object
<= 100 properties
key
additional properties
string
created_at
created at

The UTC created date of the dynamic content optimization

string format: date-time
updated_at
Updated At

The UTC last updated date of the dynamic content optimization

string format: date-time
Example
{
"dynamic_content_optimizations": [
{
"id": "63e2d42a27ad5f2b345ca124",
"destination_url": "https://example.com/landing",
"data": {
"CTAText": "50% off",
"Headline": "Summer Sales!"
},
"created_at": "2023-01-01T00:00:00Z",
"updated_at": "2023-01-01T00:00:00Z"
}
]
}

Bad request

Media typeapplication/json
object
Example
{
"error": {
"code": "BAD_REQUEST",
"details": [
{
"code": "MAX_ITEMS",
"field": "line_items",
"message": "value must contain no more than 3000 item(s)",
"params": {
"max": "3000"
}
}
],
"message": "Bad request"
}
}

Unauthorized

Media typeapplication/json
object
Example
{
"error": {
"code": "UNAUTHORIZED",
"message": "Unauthorized"
}
}

Internal server error

Media typeapplication/json
object
Example
{
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error"
}
}

An unexpected error response.

Media typeapplication/json
object
code
integer format: int32
message
string
details
Array<object>
object
@type
string
key
additional properties
any
Examplegenerated
{
"code": 1,
"message": "example",
"details": [
{
"@type": "example"
}
]
}