Accept a CMS publication command - Sorank

POST

/

profiles

/

{profile_id}

/

articles

/

{id}

/

publications

Error

A valid request URL is required to generate request examples

{
  "data": {
    "publication": {
      "article_id": "11111111-1111-4111-8111-111111111111",
      "status": "idle",
      "target": null,
      "provider": null,
      "public_url": null,
      "updated_at": "2026-09-24T09:00:00+00:00"
    },
    "receipt": {
      "operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "accepted",
      "resource_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  },
  "meta": {
    "request_id": "<string>",
    "operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

{
  "data": {
    "publication": {
      "article_id": "11111111-1111-4111-8111-111111111111",
      "status": "idle",
      "target": null,
      "provider": null,
      "public_url": null,
      "updated_at": "2026-09-24T09:00:00+00:00"
    },
    "receipt": {
      "operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "accepted",
      "resource_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  },
  "meta": {
    "request_id": "<string>",
    "operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "The current article generation quota is exhausted.",
    "request_id": "33333333-3333-4333-8333-333333333333",
    "retryable": false
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "The current article generation quota is exhausted.",
    "request_id": "33333333-3333-4333-8333-333333333333",
    "retryable": false
  }
}

Authorizations

Authorization

string

header

required

Authorization-code grant with PKCE S256, exact scopes, explicit resource audience and a persisted consent grant. Obtain endpoint URLs from server discovery in the target environment. Refresh tokens remain client-bound.

FlowAuthorization Code

Authorization URL: /oauth/authorize
Token URL: /oauth/token
Refresh URL: /oauth/token

Scopes1

articles:publish

Schedule and manage CMS publication.

Headers

Idempotency-Key

string

required

Opaque client command key of 1 to 128 visible ASCII characters. UUID recommended; reuse only for the same command.

Required string length: 1 - 128

Pattern: ^[!-~]+$

Path Parameters

profile_id

string<uuid>

required

Profile UUID; must be in the grant allowlist and currently accessible to the actor.

id

string<uuid>

required

Resource UUID, scoped by the path profile or persisted operation receipt.

Body

application/json

target

enum<string>

required

Available options:

draft,

live

cms_category_ids

string[]

Maximum array length: 1

Required string length: 1 - 256

Response

Remote publication command receipt and current state.

data

object

required

Show child attributes

meta

object

required

Show child attributes

Error

A valid request URL is required to generate request examples

{
  "data": {
    "publication": {
      "article_id": "11111111-1111-4111-8111-111111111111",
      "status": "idle",
      "target": null,
      "provider": null,
      "public_url": null,
      "updated_at": "2026-09-24T09:00:00+00:00"
    },
    "receipt": {
      "operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "accepted",
      "resource_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  },
  "meta": {
    "request_id": "<string>",
    "operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

{
  "data": {
    "publication": {
      "article_id": "11111111-1111-4111-8111-111111111111",
      "status": "idle",
      "target": null,
      "provider": null,
      "public_url": null,
      "updated_at": "2026-09-24T09:00:00+00:00"
    },
    "receipt": {
      "operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "accepted",
      "resource_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  },
  "meta": {
    "request_id": "<string>",
    "operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "The current article generation quota is exhausted.",
    "request_id": "33333333-3333-4333-8333-333333333333",
    "retryable": false
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "The current article generation quota is exhausted.",
    "request_id": "33333333-3333-4333-8333-333333333333",
    "retryable": false
  }
}