Content Updates

List Content Updates

post

Track content updates.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

brand_kit_idintegerRequired

The Brand Kit ID

Body

workspace_idintegerOptional

ID of the workspace to retrieve results from. If not provided, returns results from all workspaces the user belongs to.

brand_kit_idintegerOptional

Optional Brand Kit ID to filter content updates by

sortstring · enumOptional

Sort field. Prefix with - for descending.

Available sort fields:

• created_at/-created_at: Sort by creation date
• updated_at/-updated_at: Sort by last update date
• url/-url: Sort alphabetically by URL

Default: -created_atPossible values:

pageintegerOptional

Page number

Default: 1

per_pageinteger · max: 100Optional

Items per page

Default: 25

Responses

200

Successful response

application/json

400

Bad request - invalid parameters, filters, or sort options

401

Unauthorized - invalid or missing authentication token

404

Not found - resource does not exist

412

Precondition failed - AEO not configured for this brand kit

post/public_api/brand_kits/{brand_kit_id}/content_updates/list

POST /public_api/brand_kits/{brand_kit_id}/content_updates/list HTTP/1.1
Host: api.airops.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 188

{
  "workspace_id": 1,
  "brand_kit_id": 1,
  "filters": [
    {
      "field": "url",
      "operator": "EQUALS",
      "value": null
    }
  ],
  "includes": [
    "metadata_entries"
  ],
  "fields": [
    "id"
  ],
  "sort": "-created_at",
  "page": 1,
  "per_page": 25
}

{
  "data": [
    {
      "id": 1,
      "url": "text",
      "type": "page_published",
      "source": "track_event_step",
      "brand_kit_id": 1,
      "workspace_id": 1,
      "created_at": "text",
      "updated_at": "text",
      "change_detection": {},
      "metadata_entries": [
        {}
      ]
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 1,
    "total_count": 1,
    "total_pages": 1
  }
}

Create Content Updates

post

Track content updates.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

brand_kit_idintegerRequired

The Brand Kit ID

Body

urlstringRequired

The page URL to track

typestring · enumRequired

Type of content update

Possible values:

Responses

201

Successful response

application/json

400

Bad request - invalid parameters, filters, or sort options

401

Unauthorized - invalid or missing authentication token

404

Not found - resource does not exist

412

Precondition failed - AEO not configured for this brand kit

422

Unprocessable entity - validation failed

post/public_api/brand_kits/{brand_kit_id}/content_updates

POST /public_api/brand_kits/{brand_kit_id}/content_updates HTTP/1.1
Host: api.airops.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 90

{
  "url": "text",
  "type": "page_published",
  "custom_attributes": [
    {
      "key": "text",
      "value": "text"
    }
  ]
}

{
  "data": {
    "id": 1,
    "url": "text",
    "type": "page_published",
    "source": "track_event_step",
    "brand_kit_id": 1,
    "workspace_id": 1,
    "created_at": "text",
    "updated_at": "text",
    "change_detection": {},
    "metadata_entries": [
      {}
    ]
  }
}

Get Content Update

get

Track content updates.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

brand_kit_idintegerRequired

The Brand Kit ID

idintegerRequired

The resource ID

Responses

200

Successful response

application/json

400

Bad request - invalid parameters, filters, or sort options

401

Unauthorized - invalid or missing authentication token

404

Not found - resource does not exist

412

Precondition failed - AEO not configured for this brand kit

get/public_api/brand_kits/{brand_kit_id}/content_updates/{id}

GET /public_api/brand_kits/{brand_kit_id}/content_updates/{id} HTTP/1.1
Host: api.airops.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": {
    "id": 1,
    "url": "text",
    "type": "page_published",
    "source": "track_event_step",
    "brand_kit_id": 1,
    "workspace_id": 1,
    "created_at": "text",
    "updated_at": "text",
    "change_detection": {},
    "metadata_entries": [
      {}
    ]
  }
}

Destroy Content Updates

delete

Track content updates.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

brand_kit_idintegerRequired

The Brand Kit ID

idintegerRequired

The resource ID

Responses

200

Successful response

application/json

anyOptional

400

Bad request - invalid parameters, filters, or sort options

401

Unauthorized - invalid or missing authentication token

404

Not found - resource does not exist

412

Precondition failed - AEO not configured for this brand kit

delete/public_api/brand_kits/{brand_kit_id}/content_updates/{id}

DELETE /public_api/brand_kits/{brand_kit_id}/content_updates/{id} HTTP/1.1
Host: api.airops.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content