Publications

List publications

All the organisation's publications. status filters. Cursor-paginated: the response's nextCursor is sent back as cursor for the next page, null on the last one.

For tracking state, webhooks are better: publication.published arrives with the article URL the moment it goes live, while polling burns your rate limit without learning anything extra.

Required scope: PUBLICATIONS_READ.

get/partner/publications

Request

  • Base URL: https://app.comunicate.eu/api/v1
  • URL: https://app.comunicate.eu/api/v1/partner/publications
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.comunicate.eu/api/v1/oauth/authorize, token URL https://app.comunicate.eu/api/v1/oauth/token, scopes: PUBLICATIONS_READ)

Query parameters

statusstring

DRAFT, AWAITING_CONTENT, AWAITING_APPROVAL, APPROVED, QUEUED, UPLOADING_MEDIA, CREATING_POST, VERIFYING, SCHEDULED, PUBLISHED, RETRYING, FAILED, CANCELLED.

cursorstring uuid

The id of the last publication seen. Absent on the first page.

limitinteger

How many publications per page.

Response

OK

object required

Changes

No recorded changes to this operation across all 1 revision of this API.