API endpointsPublish requestsList the Organization's publish requests, newest first, optionally narrowed to one Connected Profile or status GET

List the Organization's publish requests, newest first, optionally narrowed to one Connected Profile or status

GET
/v1/publish-requests

List the Organization's publish requests, newest first, optionally narrowed to one Connected Profile or status.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

limit?integer
Range1 <= value <= 100
cursor?string

Opaque cursor for fetching the next result page.

Length1 <= length
status?||||||
connectedProfileId?string
Length1 <= length

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/publish-requests"
{  "data": [    {      "publishRequestId": "string",      "status": "created",      "statusUrl": "string",      "contentType": "string",      "variant": "string",      "connectedProfileId": "string",      "groupId": "string",      "clientItemId": "string",      "scheduledAt": "string",      "workflowId": "string",      "externalId": "string",      "error": null,      "createdAt": "string",      "updatedAt": "string",      "startedAt": "string",      "succeededAt": "string",      "failedAt": "string",      "cancelledAt": "string"    }  ],  "nextCursor": "string",  "hasMore": true}
{  "error": {    "code": "validation_error",    "message": "string",    "meta": {      "property1": null,      "property2": null    }  }}

List surfaces available for a provider through Koil GET

List surfaces available for a provider through Koil.

Submit one or more publish requests POST

Submit one or more publish requests. Each item creates provider content — a post, a comment, a reply, a message — through a Connected Profile. Every item's `args` is validated against its content type's publish input first and the submission is rejected whole if any item fails; each item then runs independently with its own `pub_*` ledger entry. Requires an `Idempotency-Key`.