Skip to main content
POST
/
content-intelligence
/
{id}
/
act
Act on recommendation
curl --request POST \
  --url https://api.app.hrizn.io/v1/public/content-intelligence/{id}/act \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "article_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "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"
  }
}
Marks a recommendation as acted on, linking it to the article that was created based on the recommendation. This closes the feedback loop, letting the content intelligence pipeline know that the gap has been addressed. Scope required: content_intelligence:write

​
Path parameters

​
id
string
required
UUID of the content intelligence recommendation.

​
Request body

​
article_id
string
required
UUID of the article that was created from this recommendation.

​
Workflow

The typical workflow for acting on a recommendation:
1

List recommendations

Call GET /content-intelligence to find actionable recommendations.
2

Check the actionable_via field

Use GET /reference/content-intelligence-types to determine which endpoint to call based on suggestion_type. For example, missing_model_page maps to POST /model-landing-pages.
3

Create the content

Call the appropriate content creation endpoint. The response includes the new article’s id.
4

Link the recommendation

Call POST /content-intelligence/{id}/act with the article_id to mark the recommendation as acted on.
{
  "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"
  }
}
Only active recommendations can be acted on. Attempting to act on a dismissed, expired, or already acted-on recommendation will return a 404 error.

Authorizations

​
X-API-Key
string
header
required

Your Hrizn API key (prefix hzk_)

Path Parameters

​
id
string<uuid>
required

Content intelligence recommendation ID

Body

application/json
​
article_id
string<uuid>
required

ID of the article created from this recommendation.

Response

Recommendation marked as acted on

​
data
object
Last modified on March 12, 2026