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",
  "research_graph_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

import requests

url = "https://api.app.hrizn.io/v1/public/content-intelligence/{id}/act"

payload = {
    "article_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "research_graph_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    article_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    research_graph_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  })
};

fetch('https://api.app.hrizn.io/v1/public/content-intelligence/{id}/act', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    article_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    research_graph_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  })
};

fetch('https://api.app.hrizn.io/v1/public/content-intelligence/{id}/act', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.app.hrizn.io/v1/public/content-intelligence/{id}/act",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'article_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'research_graph_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

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

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",
  "research_graph_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

import requests

url = "https://api.app.hrizn.io/v1/public/content-intelligence/{id}/act"

payload = {
    "article_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "research_graph_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    article_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    research_graph_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  })
};

fetch('https://api.app.hrizn.io/v1/public/content-intelligence/{id}/act', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    article_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    research_graph_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  })
};

fetch('https://api.app.hrizn.io/v1/public/content-intelligence/{id}/act', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.app.hrizn.io/v1/public/content-intelligence/{id}/act",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'article_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'research_graph_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

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

Marks a recommendation as acted on, linking it to the article or IdeaCloud research graph 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

string

required

UUID of the content intelligence recommendation.

Request body

Provide exactly one target:

article_id

string

UUID of the article that was created from this recommendation.

research_graph_id

string

UUID of the IdeaCloud research graph that was created from this recommendation.

Workflow

The typical workflow for acting on a recommendation:

List recommendations

Call GET /content-intelligence to find actionable recommendations.

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.

Create the content

Call the appropriate content or IdeaCloud creation endpoint. The response includes the new article or research graph id.

Link the recommendation

Call POST /content-intelligence/{id}/act with either article_id or research_graph_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",
    "acted_on_research_graph_id": null,
    "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

string<uuid>

required

Content intelligence recommendation ID

Body

application/json

Option 1
Option 2

article_id

string<uuid>

required

ID of the article created from this recommendation.

research_graph_id

string<uuid>

ID of the IdeaCloud research graph created from this recommendation.

Response

Recommendation marked as acted on

data

object

Hide child attributes

data.id

string<uuid>

data.status

string

Example:

"acted_on"

data.acted_on_article_id

string<uuid> | null

data.acted_on_research_graph_id

string<uuid> | null

data.updated_at

string<date-time>

Last modified on June 4, 2026

Get summary

Dismiss recommendation

Overview

IdeaClouds

Content Intelligence

Content

Content Types

Compliance

Content Tools

Inventory

Site

Dealership Config

Social

Webhooks

Reference

Health

IdeaClouds

Content

Compliance

Content Tools

Inventory

Site

Webhooks

Content Intelligence

Reference

Social

Act on recommendation

Path parameters

Request body

Workflow

Authorizations

Path Parameters

Body

Response

​Path parameters

​Request body

​Workflow

Authorizations

Path Parameters

Body

Response

Path parameters

Request body

Workflow