Skip to main content
GET
List Content Agent slots

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours from the Promptwatch dashboard under Settings > API Keys.

Query Parameters

page
integer
default:1

Page number (1-based). Ignored when fromDate/toDate are set.

Required range: x >= 1
size
integer
default:25

Page size (max 100). Ignored when fromDate/toDate are set.

Required range: 1 <= x <= 100
orderBy
enum<string>
default:publishAt

Sort field for paginated list.

Available options:
publishAt,
publishedAt,
generateBy,
priorityScore,
createdAt
sortOrder
enum<string>
default:asc
Available options:
asc,
desc
statuses
enum<string>[]

Filter by slot status. SUPPRESSED is excluded by default.

Available options:
PLANNED,
GENERATING,
REVIEW,
APPROVED,
SCHEDULED,
PUBLISHED,
DEFERRED,
SUPPRESSED,
FAILED
fromDate
string<date-time>

Inclusive lower bound on publishAt. When set with toDate, returns an unpaginated calendar window (max 500).

toDate
string<date-time>

Inclusive upper bound on publishAt. Use with fromDate for a calendar window.

Response

Default Response

slots
object[]
required

Scheduled content pieces for the current page or date window.

page
integer
required

Page number (1-based)

size
integer
required

Page size

total
integer
required

Total items matching the request

totalPages
integer
required

Total pages for this page size