v1

latestOpenAPI 3.0.12026-07-2318588.1 KB
Content Updates

List Content Updates

Track content updates.

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

Path parameters

brand_kit_idinteger required

The Brand Kit ID

Request body

workspace_idinteger

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

brand_kit_idinteger

Optional Brand Kit ID to filter content updates by

includesstring[]

Include related resources.

Available includes:

  • metadata_entries: Include metadata key-value pairs for each event
fieldsstring[]

Select additional fields to return.

Optional fields:

  • id: Unique identifier for the content update
  • url: The URL associated with the content update
  • type: Type of content update
  • source: Source that created the content update
  • brand_kit_id: ID of the associated Brand Kit
  • workspace_id: ID of the associated workspace
  • created_at: When the content update was created
  • updated_at: When the content update was last updated
  • change_detection: Change detection for this content update: detection status, the categories of detected changes, and whether a before/after diff is available. On a single-update fetch it also carries a nested changes array (the before/after diff). Null when change detection has not run for the update, including workspaces where it is not enabled.
sort'created_at' | '-created_at' | 'updated_at' | '-updated_at' | 'url' | '-url'

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
pageinteger

Page number

per_pageinteger

Items per page

Response

Successful response