Queue asynchronous knowledge changes
curl --request POST \
--url https://app.hookie.ai/admin/api/data-workspace/graph/mutations \
--header 'Content-Type: application/json' \
--data '
{
"mutations": [
{
"mutation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"node_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"expected_version": 1,
"display_name": "<string>",
"node_type": "<string>",
"properties": {},
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"relation_type": "<string>",
"edge_weight": 500000
}
]
}
'const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
mutations: [
{
mutation_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
node_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
expected_version: 1,
display_name: '<string>',
node_type: '<string>',
properties: {},
target_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
relation_type: '<string>',
edge_weight: 500000
}
]
})
};
fetch('https://app.hookie.ai/admin/api/data-workspace/graph/mutations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.hookie.ai/admin/api/data-workspace/graph/mutations"
payload = { "mutations": [
{
"mutation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"node_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"expected_version": 1,
"display_name": "<string>",
"node_type": "<string>",
"properties": {},
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"relation_type": "<string>",
"edge_weight": 500000
}
] }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text){}Knowledge graph
Queue asynchronous knowledge changes
Pro or Team. Workspace-scoped credentials only. Reads require read access; mutations require write access and X-Requested-With for cookie sessions. The authenticated workspace registry selects the database. At most 256 KiB per request, 500 pending mutations or 16 MiB per workspace. One durable coordinator per workspace schedules batches after 15 seconds. Acknowledgement means queued, not applied; poll mutation status. Database outages and backlog can delay visibility. Applied/resolved receipts are retained for at least 30 days; keep IDs stable across retries.
POST
/
admin
/
api
/
data-workspace
/
graph
/
mutations
Queue asynchronous knowledge changes
curl --request POST \
--url https://app.hookie.ai/admin/api/data-workspace/graph/mutations \
--header 'Content-Type: application/json' \
--data '
{
"mutations": [
{
"mutation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"node_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"expected_version": 1,
"display_name": "<string>",
"node_type": "<string>",
"properties": {},
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"relation_type": "<string>",
"edge_weight": 500000
}
]
}
'const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
mutations: [
{
mutation_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
node_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
expected_version: 1,
display_name: '<string>',
node_type: '<string>',
properties: {},
target_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
relation_type: '<string>',
edge_weight: 500000
}
]
})
};
fetch('https://app.hookie.ai/admin/api/data-workspace/graph/mutations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.hookie.ai/admin/api/data-workspace/graph/mutations"
payload = { "mutations": [
{
"mutation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"node_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"expected_version": 1,
"display_name": "<string>",
"node_type": "<string>",
"properties": {},
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"relation_type": "<string>",
"edge_weight": 500000
}
] }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text){}