Pull (purchase) datapoints

Purchase one or more material datapoints. Debits credits from the account and grants ongoing access.

POST/public/datapoints/pull

⚠

This endpoint is non-idempotent and billable. Each successful request debits credits. Wrap it in your own idempotency layer if you're calling it from a retry-able workflow.

Request body

Parameter	Type	Description
materialIdsrequired	string[]	Array of material UUIDs to purchase. 1–100 per request.

Response

200OK

{
  "pulledMaterialIds": ["m_8c2…", "m_a4d…"],
  "creditsDebited": 2
}

Errors

409Conflict when the account has insufficient credits.

Example

curl -s -X POST 'https://api.circa.ai/public/datapoints/pull' \
  -H 'x-api-key: circa_live_xxx' \
  -H 'x-team-id: TEAM_ID_FROM_OVERVIEW' \
  -H 'Circa-Version: 2026-05-11.obsidian' \
  -H 'Content-Type: application/json' \
  -d '{"materialIds": ["m_8c2…"]}'