Skip to main content
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

MethodPathDescription
POST/public/content-intelligence/{id}/actMark recommendation as acted on
POST/public/content-intelligence/bulk-dismissBulk 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

NameTypeRequiredDescription
idstring (UUID)YesRecommendation ID

​
Request body

NameTypeRequiredDescription
article_idstring (UUID)YesID 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"}'

​
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

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

​
Bulk dismiss recommendations

POST /public/content-intelligence/bulk-dismiss
Dismiss up to 50 recommendations in a single request.

​
Request body

NameTypeRequiredDescription
idsstring[] (UUID)YesArray 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"]}'

​
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

CodeDescription
200Success (dismissed_count may be less than provided IDs)
400Invalid request body
401Missing or invalid API key
403API key does not have content_intelligence:write scope
429Rate limit exceeded
500Internal 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"]
    }
  }
}
Last modified on March 12, 2026