content_intelligence:write

content_intelligence:write The content_intelligence:write scope allows you to act on content intelligence recommendations and bulk-dismiss multiple recommendations at once. Use this scope in automation workflows that create content from recommendations and close the feedback loop.

Endpoints

Method	Path	Description
`POST`	`/public/content-intelligence/{id}/act`	Mark recommendation as acted on
`POST`	`/public/content-intelligence/bulk-dismiss`	Bulk dismiss recommendations

Act on a recommendation

POST /public/content-intelligence/{id}/act

Marks a recommendation as acted on, linking it to the article that was created from it. This closes the feedback loop so the pipeline knows the gap has been addressed.

Path parameters

Name	Type	Required	Description
`id`	string (UUID)	Yes	Recommendation ID

Request body

Name	Type	Required	Description
`article_id`	string (UUID)	Yes	ID of the article created from this recommendation

Example

curl -X POST https://api.app.hrizn.io/v1/public/content-intelligence/c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab/act \
  -H "X-API-Key: hzk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"article_id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890"}'

const res = await fetch(
  "https://api.app.hrizn.io/v1/public/content-intelligence/c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab/act",
  {
    method: "POST",
    headers: {
      "X-API-Key": "hzk_your_key_here",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ article_id: "a1b2c3d4-5e6f-7890-abcd-ef1234567890" }),
  }
);
const data = await res.json();

import requests

response = requests.post(
    "https://api.app.hrizn.io/v1/public/content-intelligence/c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab/act",
    headers={
        "X-API-Key": "hzk_your_key_here",
        "Content-Type": "application/json",
    },
    json={"article_id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890"},
)
data = response.json()

$ch = curl_init("https://api.app.hrizn.io/v1/public/content-intelligence/c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab/act");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "X-API-Key: hzk_your_key_here",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode(["article_id" => "a1b2c3d4-5e6f-7890-abcd-ef1234567890"]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch));

Response — `200 OK`

{
  "data": {
    "id": "c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab",
    "status": "acted_on",
    "acted_on_article_id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
    "updated_at": "2026-03-02T10:30:00.000Z"
  }
}

Status codes

Code	Description
`200`	Recommendation marked as acted on
`400`	Invalid request body
`401`	Missing or invalid API key
`403`	API key does not have `content_intelligence:write` scope
`404`	Recommendation or article not found, or recommendation not in active status
`429`	Rate limit exceeded
`500`	Internal server error

Bulk dismiss recommendations

POST /public/content-intelligence/bulk-dismiss

Dismiss up to 50 recommendations in a single request.

Request body

Name	Type	Required	Description
`ids`	string[] (UUID)	Yes	Array of recommendation IDs (1-50)

Example

curl -X POST https://api.app.hrizn.io/v1/public/content-intelligence/bulk-dismiss \
  -H "X-API-Key: hzk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab", "d4b2e9c3-8f5e-5b0d-c6f7-2345678901bc"]}'

const res = await fetch(
  "https://api.app.hrizn.io/v1/public/content-intelligence/bulk-dismiss",
  {
    method: "POST",
    headers: {
      "X-API-Key": "hzk_your_key_here",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      ids: [
        "c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab",
        "d4b2e9c3-8f5e-5b0d-c6f7-2345678901bc",
      ],
    }),
  }
);
const data = await res.json();

import requests

response = requests.post(
    "https://api.app.hrizn.io/v1/public/content-intelligence/bulk-dismiss",
    headers={
        "X-API-Key": "hzk_your_key_here",
        "Content-Type": "application/json",
    },
    json={"ids": [
        "c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab",
        "d4b2e9c3-8f5e-5b0d-c6f7-2345678901bc",
    ]},
)
data = response.json()

$ch = curl_init("https://api.app.hrizn.io/v1/public/content-intelligence/bulk-dismiss");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "X-API-Key: hzk_your_key_here",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode(["ids" => [
        "c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab",
        "d4b2e9c3-8f5e-5b0d-c6f7-2345678901bc",
    ]]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch));

Response — `200 OK`

{
  "data": {
    "dismissed_count": 2,
    "dismissed": [
      {
        "id": "c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab",
        "status": "dismissed",
        "updated_at": "2026-03-02T10:30:00.000Z"
      },
      {
        "id": "d4b2e9c3-8f5e-5b0d-c6f7-2345678901bc",
        "status": "dismissed",
        "updated_at": "2026-03-02T10:30:00.000Z"
      }
    ]
  }
}

Status codes

Code	Description
`200`	Success (dismissed_count may be less than provided IDs)
`400`	Invalid request body
`401`	Missing or invalid API key
`403`	API key does not have `content_intelligence:write` scope
`429`	Rate limit exceeded
`500`	Internal server error

Error response — Missing scope

If your API key does not include content_intelligence:write, any request to these endpoints returns:

{
  "error": {
    "code": "forbidden",
    "message": "This API key requires one of the following scopes: content_intelligence:write",
    "details": {
      "required_scopes": ["content_intelligence:write"]
    }
  }
}

Getting Started

Concepts

Guides

Scopes

Endpoints

Act on a recommendation

Path parameters

Request body

Example

Response — `200 OK`

Status codes

Bulk dismiss recommendations

Request body

Example

Response — `200 OK`

Status codes

Error response — Missing scope

​Endpoints

​Act on a recommendation

​Path parameters

​Request body

​Example

​Response — 200 OK

​Status codes

​Bulk dismiss recommendations

​Request body

​Example

​Response — 200 OK

​Status codes

​Error response — Missing scope

Endpoints

Act on a recommendation

Path parameters

Request body

Example

Response — `200 OK`

Status codes

Bulk dismiss recommendations

Request body

Example

Response — `200 OK`

Status codes

Error response — Missing scope