Org Content

Get what a news item can be promoted to

GET/org-content/news/{id}/promotion
org-content:readget_news_promotionRead-only

Returns the organisation's distribution lists and investor classifications that promote can send to, each as {id, name}: lists ordered by name, classifications by id. Deleted lists and classifications are left out. Needs permission to manage the organisation's content. An unknown news item or one in another organisation returns 404. A draft or future item is returned as well. Changes nothing.

Path parameters

  • idstring (uuid)Required#

    The item's id.

Responses

200

The lists and classifications.

NewsPromotionOptionsEnvelope
{
  "data": {
    "distribution_lists": [
      {
        "id": 12,
        "name": "UK Investors"
      }
    ],
    "classifications": [
      {
        "id": 3,
        "name": "Professional"
      }
    ]
  }
}
401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
404

Resource not found (error.code = not_found).

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl https://your-org-domain/kong/core/api/v2/org-content/news/{id}/promotion\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"