Attach agents to document

POST/knowledge-base/{id}/agents

Link one or more agents to this knowledge document. The document's content will be synced to each agent's knowledge base at their provider. Paywalled — requires active subscription and sufficient credits.

Requires Authorization: Bearer <api_key>. Create a key in the Inspra dashboard under Workspace Settings → API Keys.

Path parameters

idstringrequired
UUID of the resource.

Body application/json

agent_idsstring[]required

Response 200 OK

Attach result with per-agent success/failure.

document_idstringuuidrequired
attachedstring[]required
failedobject[]required
2 fields
- agent_idstringuuidrequired
- errorstringrequired

Errors

400Bad Request
Validation failed / malformed request.
401Unauthorized
Missing, malformed, or invalid API key.
403Forbidden
Workspace unavailable, suspended, or paywalled.
404Not Found
Resource not found in this workspace.
429Too Many Requests
Workspace request limit exceeded; shared across all its API keys.