Documentation Index
Fetch the complete documentation index at: https://api-docs.hrizn.io/llms.txt
Use this file to discover all available pages before exploring further.
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
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"}'
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
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"]}'
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"]
}
}
}
