Loading API reference…
/internal/agent/organizations/{organizationId}/actionsRequires a signed execution capability for an enabled Chat profile and its active human turn. Task agents and service-token-only calls are rejected. The owner must explicitly request a decision; retrieved content and agent suggestions do not constitute approval.
agentExecutionCapability Short-lived capability scoped to one organization, profile, and task run or chat turn.
In: header
uuiduuidValue in
Value in
uuiduuiduuidValue in
Value in
Filter by whether an owner approval decision has been recorded.
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions"/internal/agent/organizations/{organizationId}/actions/{id}Requires a signed execution capability for an enabled Chat profile and its active human turn. Task agents and service-token-only calls are rejected. The owner must explicitly request a decision; retrieved content and agent suggestions do not constitute approval.
agentExecutionCapability Short-lived capability scoped to one organization, profile, and task run or chat turn.
In: header
uuiduuidcurl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions/497f6eca-6276-4993-bfeb-53cbbbba6f08"/internal/agent/organizations/{organizationId}/actions/{id}/approveRequires a signed execution capability for an enabled Chat profile and its active human turn. Task agents and service-token-only calls are rejected. The owner must explicitly request a decision; retrieved content and agent suggestions do not constitute approval.
agentExecutionCapability Short-lived capability scoped to one organization, profile, and task run or chat turn.
In: header
uuiduuidapplication/json
TypeScript Definitions
Use the request body type in TypeScript.
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions/497f6eca-6276-4993-bfeb-53cbbbba6f08/approve" \ -H "Content-Type: application/json" \ -d '{}'/internal/agent/organizations/{organizationId}/actions/{id}/rejectRequires a signed execution capability for an enabled Chat profile and its active human turn. Task agents and service-token-only calls are rejected. The owner must explicitly request a decision; retrieved content and agent suggestions do not constitute approval.
agentExecutionCapability Short-lived capability scoped to one organization, profile, and task run or chat turn.
In: header
uuiduuidapplication/json
TypeScript Definitions
Use the request body type in TypeScript.
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions/497f6eca-6276-4993-bfeb-53cbbbba6f08/reject" \ -H "Content-Type: application/json" \ -d '{}'/internal/agent/organizations/{organizationId}/actions/{id}/reconcileRequires a signed execution capability for an enabled Chat profile and its active human turn. Task agents and service-token-only calls are rejected. The owner must explicitly request a decision; retrieved content and agent suggestions do not constitute approval.
agentExecutionCapability Short-lived capability scoped to one organization, profile, and task run or chat turn.
In: header
uuiduuidapplication/json
TypeScript Definitions
Use the request body type in TypeScript.
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions/497f6eca-6276-4993-bfeb-53cbbbba6f08/reconcile" \ -H "Content-Type: application/json" \ -d '{ "outcome": "succeeded", "note": "string" }'/internal/agent/organizations/{organizationId}/inboxRequires a signed execution capability for an enabled Chat profile and its active human turn. Task agents and service-token-only calls are rejected. The owner must explicitly request a decision; retrieved content and agent suggestions do not constitute approval.
agentExecutionCapability Short-lived capability scoped to one organization, profile, and task run or chat turn.
In: header
Organization identifier.
uuidOpaque nextCursor from the previous page. Keep the ordering unchanged; restart after changing filters.
length <= 20001 <= value <= 100Value in
Value in
Value in
Value in
uuiduuidapplication/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/inbox"{ "success": true, "statusCode": 200, "message": "Human inbox items listed.", "data": []}/internal/agent/organizations/{organizationId}/inbox/summaryRequires a signed execution capability for an enabled Chat profile and its active human turn. Task agents and service-token-only calls are rejected. The owner must explicitly request a decision; retrieved content and agent suggestions do not constitute approval.
agentExecutionCapability Short-lived capability scoped to one organization, profile, and task run or chat turn.
In: header
Organization identifier.
uuidapplication/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/inbox/summary"{ "success": true, "statusCode": 200, "message": "Inbox summary found.", "data": { "questions": 1, "notifications": 2, "approvals": 1, "reconciliation": 0, "total": 4 }}/internal/agent/organizations/{organizationId}/inbox/{inboxItemId}Returns the question or notification, structured presentation and recorded response. The purpose is task for ordinary task handoffs and learning_input for a verified, non-blocking learning question. Learning questions never ask the owner to approve uncertain lessons. Requires a signed execution capability for an enabled Chat profile and its active human turn. Task agents and service-token-only calls are rejected. The owner must explicitly request a decision; retrieved content and agent suggestions do not constitute approval.
agentExecutionCapability Short-lived capability scoped to one organization, profile, and task run or chat turn.
In: header
Organization identifier.
uuidHuman inbox item identifier.
uuidapplication/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/inbox/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "success": true, "statusCode": 200, "message": "Human inbox item found.", "data": { "id": "fa37c769-25f9-4bf7-9acd-98f8464d87db", "status": "open" }}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 404, "message": "Human inbox item was not found.", "error": { "code": "human_inbox_item_not_found" }}{ "success": false, "statusCode": 409, "message": "Human inbox item is no longer open.", "error": { "code": "human_inbox_item_not_open" }}/internal/agent/organizations/{organizationId}/inbox/{inboxItemId}/respondRecords one immutable human response. Repeating the same response is idempotent; a different response conflicts. Task questions resolve their own blocker. A learning_input question retains the completed source task unchanged and atomically records a backend-owned refresh request. The scheduler coalesces answered inputs into a fresh cycle after any active learning finishes; ordinary operations do not wait for these answers. Requires a signed execution capability for an enabled Chat profile and its active human turn. Task agents and service-token-only calls are rejected. The owner must explicitly request a decision; retrieved content and agent suggestions do not constitute approval.
agentExecutionCapability Short-lived capability scoped to one organization, profile, and task run or chat turn.
In: header
Organization identifier.
uuidHuman inbox item identifier.
uuidapplication/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/inbox/497f6eca-6276-4993-bfeb-53cbbbba6f08/respond" \ -H "Content-Type: application/json" \ -d '{ "response": "Use the EU tax region." }'{ "success": true, "statusCode": 200, "message": "Human inbox item found.", "data": { "id": "fa37c769-25f9-4bf7-9acd-98f8464d87db", "status": "open" }}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 404, "message": "Human inbox item was not found.", "error": { "code": "human_inbox_item_not_found" }}{ "success": false, "statusCode": 409, "message": "Human inbox item is no longer open.", "error": { "code": "human_inbox_item_not_open" }}/internal/agent/organizations/{organizationId}/inbox/{inboxItemId}/acknowledgeRequires a signed execution capability for an enabled Chat profile and its active human turn. Task agents and service-token-only calls are rejected. The owner must explicitly request a decision; retrieved content and agent suggestions do not constitute approval.
agentExecutionCapability Short-lived capability scoped to one organization, profile, and task run or chat turn.
In: header
Organization identifier.
uuidHuman inbox item identifier.
uuidapplication/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/inbox/497f6eca-6276-4993-bfeb-53cbbbba6f08/acknowledge"{ "success": true, "statusCode": 200, "message": "Human inbox item found.", "data": { "id": "fa37c769-25f9-4bf7-9acd-98f8464d87db", "status": "open" }}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 404, "message": "Human inbox item was not found.", "error": { "code": "human_inbox_item_not_found" }}{ "success": false, "statusCode": 409, "message": "Human inbox item is no longer open.", "error": { "code": "human_inbox_item_not_open" }}/internal/agent/organizations/{organizationId}/insights/refreshQueues due work in the existing collector. Repeated requests share collection checkpoints; active leases, provider backoff and recent collections are preserved. Does not change the hourly cadence or schedules. Only ready connections with built-in metrics are eligible; custom MCP operations remain available through their normal integration tools. Requires the active profile; execution capabilities cannot select another profile. Shares aggregate business metrics with every enabled profile in the organization; live integration grants remain separate. Rechecks verified account identity and enforced resource scope on list, query and receipt retrieval.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidapplication/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/insights/refresh" \ -H "Content-Type: application/json" \ -d '{ "agentProfileId": "893be164-fc8f-4a17-b111-305214ac1c57" }'{ "success": true, "statusCode": 0, "message": "string", "data": { "status": "queued", "queued": 0, "unchanged": 0, "connectorKeys": [ "string" ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}/internal/agent/organizations/{organizationId}/insights/metricsSources retain stable IDs and include resourceName when discovered. preferred marks a selected working default, not an authorization boundary. Missing reporting capabilities use unsupported_capability coverage; collection in progress uses collecting independently for each dataset. Requires the active profile; execution capabilities cannot select another profile. Shares aggregate business metrics with every enabled profile in the organization; live integration grants remain separate. Rechecks verified account identity and enforced resource scope on list, query and receipt retrieval.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuiduuidapplication/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/insights/metrics?agentProfileId=497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "success": true, "statusCode": 0, "message": "string", "data": { "publicationRevision": 0, "definitionsRevision": 0, "definitions": [ { "key": "string", "version": 1, "name": "string", "description": "string", "unit": "string", "currency": true, "measurementKind": "gauge", "sourceTimezone": "organization", "reportingTimezone": "string", "ownership": "builtin", "hash": "string", "calculation": { "kind": "formula", "expression": { "nodes": [ { "kind": "constant", "value": "string" } ], "root": 0 }, "nonOverlappingScopes": true }, "dimensions": [ "string" ], "grains": [ "day" ], "sourceIds": [ "string" ], "recalculation": { "status": "pending", "reason": "string" } } ], "sources": [ { "id": "string", "identity": { "provider": "string", "accountId": "string", "resourceId": "string", "dataset": "payments", "environment": "live" }, "resourceName": "string", "preferred": true, "connectorKeys": [ "string" ], "connected": true, "coverage": { "status": "complete", "reason": "collecting", "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "provisional": true, "reporting": { "timezone": "string", "accountTimezone": "string", "lagHours": 0, "computedAt": "2019-08-24T14:15:22Z", "cached": true, "attribution": { "model": "meta_explicit", "windows": [ "string" ], "reportTime": "impression", "conversionEvent": "string" }, "approximateDistinct": true, "thresholded": true, "dataLossFromOtherRow": true, "sampling": [ { "read": "string", "population": "string" } ], "eventRetentionMonths": 1, "userRetentionMonths": 1, "truncation": [ { "type": "string", "before": "2019-08-24", "ranges": [ { "from": "2019-08-24", "to": "2019-08-24" } ] } ] } }, "lastCollectedAt": "2019-08-24T14:15:22Z" } ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}/internal/agent/organizations/{organizationId}/insights/queryPins one publication revision and retains a citable result. Up to twelve calendar months, twenty selections, one hundred series, ten thousand points, five MiB and thirty seconds. Values are exact decimal strings. Sources, currencies, definition versions, actual timezone boundaries and coverage remain separate. Currency conversion preserves original amounts and retains the period_end_reference_v1 historical ECB rate policy, actual rate and date. The same service serves the UI and profile-scoped oblivectl insight queries. Requires the active profile; execution capabilities cannot select another profile. Shares aggregate business metrics with every enabled profile in the organization; live integration grants remain separate. Rechecks verified account identity and enforced resource scope on list, query and receipt retrieval.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidapplication/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/insights/query" \ -H "Content-Type: application/json" \ -d '{ "agentProfileId": "893be164-fc8f-4a17-b111-305214ac1c57", "query": { "metrics": [ { "key": "string", "version": 1, "sourceIds": [ "string" ] } ], "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "grain": "day", "groupBy": [ "string" ], "filters": { "property1": [ "string" ], "property2": [ "string" ] } } }'{ "success": true, "statusCode": 0, "message": "string", "data": { "receiptId": "4937ce52-e283-4321-b00f-c29b6dd5d0e9", "definitionPreview": true, "publicationRevision": 0, "generatedAt": "2019-08-24T14:15:22Z", "request": { "metrics": [ { "key": "string", "version": 1, "sourceIds": [ "string" ], "resourceIds": [ "string" ] } ], "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "grain": "day", "groupBy": [ "string" ], "filters": { "property1": [ "string" ], "property2": [ "string" ] }, "currency": "string" }, "series": [ { "metric": { "key": "string", "version": 1, "hash": "string" }, "sourceIds": [ "string" ], "resourceIds": [ "string" ], "unit": "string", "timezone": "string", "currency": "string", "dimensions": { "property1": "string", "property2": "string" }, "points": [ { "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "value": "string", "numerator": "string", "denominator": "string", "coverage": { "status": "complete", "reason": "collecting", "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "provisional": true, "reporting": { "timezone": "string", "accountTimezone": "string", "lagHours": 0, "computedAt": "2019-08-24T14:15:22Z", "cached": true, "attribution": { "model": "meta_explicit", "windows": [ "string" ], "reportTime": "impression", "conversionEvent": "string" }, "approximateDistinct": true, "thresholded": true, "dataLossFromOtherRow": true, "sampling": [ { "read": "string", "population": "string" } ], "eventRetentionMonths": 1, "userRetentionMonths": 1, "truncation": [ { "type": "string", "before": "2019-08-24", "ranges": [ { "from": "2019-08-24", "to": "2019-08-24" } ] } ] } }, "collectedAt": "2019-08-24T14:15:22Z", "conversion": { "policy": "period_end_reference_v1", "value": "string", "currency": "string", "rates": [ { "rate": "string", "date": "2019-08-24", "provider": "ecb", "originalCurrency": "string" } ], "coverage": { "status": "complete", "reason": "collecting", "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "provisional": true, "reporting": { "timezone": "string", "accountTimezone": "string", "lagHours": 0, "computedAt": "2019-08-24T14:15:22Z", "cached": true, "attribution": { "model": "meta_explicit", "windows": [ "string" ], "reportTime": "impression", "conversionEvent": "string" }, "approximateDistinct": true, "thresholded": true, "dataLossFromOtherRow": true, "sampling": [ { "read": "string", "population": "string" } ], "eventRetentionMonths": 1, "userRetentionMonths": 1, "truncation": [ { "type": "string", "before": "2019-08-24", "ranges": [ { "from": "2019-08-24", "to": "2019-08-24" } ] } ] } } } } ] } ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}/internal/agent/organizations/{organizationId}/insights/receipts/{receiptId}Read a retained query result after checking current access Requires the active profile; execution capabilities cannot select another profile. Shares aggregate business metrics with every enabled profile in the organization; live integration grants remain separate. Rechecks verified account identity and enforced resource scope on list, query and receipt retrieval.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuiduuiduuidapplication/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/insights/receipts/497f6eca-6276-4993-bfeb-53cbbbba6f08?agentProfileId=497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "success": true, "statusCode": 0, "message": "string", "data": { "receiptId": "4937ce52-e283-4321-b00f-c29b6dd5d0e9", "definitionPreview": true, "publicationRevision": 0, "generatedAt": "2019-08-24T14:15:22Z", "request": { "metrics": [ { "key": "string", "version": 1, "sourceIds": [ "string" ], "resourceIds": [ "string" ] } ], "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "grain": "day", "groupBy": [ "string" ], "filters": { "property1": [ "string" ], "property2": [ "string" ] }, "currency": "string" }, "series": [ { "metric": { "key": "string", "version": 1, "hash": "string" }, "sourceIds": [ "string" ], "resourceIds": [ "string" ], "unit": "string", "timezone": "string", "currency": "string", "dimensions": { "property1": "string", "property2": "string" }, "points": [ { "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "value": "string", "numerator": "string", "denominator": "string", "coverage": { "status": "complete", "reason": "collecting", "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "provisional": true, "reporting": { "timezone": "string", "accountTimezone": "string", "lagHours": 0, "computedAt": "2019-08-24T14:15:22Z", "cached": true, "attribution": { "model": "meta_explicit", "windows": [ "string" ], "reportTime": "impression", "conversionEvent": "string" }, "approximateDistinct": true, "thresholded": true, "dataLossFromOtherRow": true, "sampling": [ { "read": "string", "population": "string" } ], "eventRetentionMonths": 1, "userRetentionMonths": 1, "truncation": [ { "type": "string", "before": "2019-08-24", "ranges": [ { "from": "2019-08-24", "to": "2019-08-24" } ] } ] } }, "collectedAt": "2019-08-24T14:15:22Z", "conversion": { "policy": "period_end_reference_v1", "value": "string", "currency": "string", "rates": [ { "rate": "string", "date": "2019-08-24", "provider": "ecb", "originalCurrency": "string" } ], "coverage": { "status": "complete", "reason": "collecting", "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "provisional": true, "reporting": { "timezone": "string", "accountTimezone": "string", "lagHours": 0, "computedAt": "2019-08-24T14:15:22Z", "cached": true, "attribution": { "model": "meta_explicit", "windows": [ "string" ], "reportTime": "impression", "conversionEvent": "string" }, "approximateDistinct": true, "thresholded": true, "dataLossFromOtherRow": true, "sampling": [ { "read": "string", "population": "string" } ], "eventRetentionMonths": 1, "userRetentionMonths": 1, "truncation": [ { "type": "string", "before": "2019-08-24", "ranges": [ { "from": "2019-08-24", "to": "2019-08-24" } ] } ] } } } } ] } ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}{ "success": true, "statusCode": 0, "message": "string", "error": { "code": "string", "issues": [ {} ] }, "meta": {}}/internal/agent/organizations/{organizationId}/knowledgeChecks the organization and enabled acting profile. General organization knowledge is shared; department and restricted-source records retain their audience and current integration permissions. Source versions, retention time and validity bound reuse; evidence integrity is not a guarantee of factual correctness. No historical file tree is automatically hydrated.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuiduuidlength <= 2001 <= value <= 50uuidapplication/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/knowledge?agentProfileId=497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "success": true, "statusCode": 0, "message": "string", "data": { "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "metadata": { "key": "string", "title": "string", "finding": "string", "applicability": "string", "visibility": "organization", "requiredConnectorKeys": [ "string" ], "sourceVersions": [ { "source": "string", "version": "string", "connectorKey": "string" } ], "evidence": [ { "runId": "78c33d18-170c-44d3-a227-b3194f134f73", "path": "string", "sha256": "string" } ], "validUntil": "2019-08-24T14:15:22Z", "sourceTaskId": "b46343f0-19a2-4701-a438-6edf056909b2", "sourceRunId": "f56f10c5-743d-477c-a57d-2d752452e421", "authorProfileKey": "string", "department": "growth", "retainedAt": "2019-08-24T14:15:22Z" }, "freshness": "current", "supersededBy": "608778cc-35f6-47d1-a540-9bcbfdf24101" } ], "nextCursor": "53a4a333-2825-45a4-80d2-5f430d088f36" }, "meta": {}}/internal/agent/organizations/{organizationId}/knowledge/{knowledgeId}Checks the organization and enabled acting profile. General organization knowledge is shared; department and restricted-source records retain their audience and current integration permissions. Source versions, retention time and validity bound reuse; evidence integrity is not a guarantee of factual correctness. No historical file tree is automatically hydrated.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuiduuiduuidapplication/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/knowledge/497f6eca-6276-4993-bfeb-53cbbbba6f08?agentProfileId=497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "success": true, "statusCode": 0, "message": "string", "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "metadata": { "key": "string", "title": "string", "finding": "string", "applicability": "string", "visibility": "organization", "requiredConnectorKeys": [ "string" ], "sourceVersions": [ { "source": "string", "version": "string", "connectorKey": "string" } ], "evidence": [ { "runId": "78c33d18-170c-44d3-a227-b3194f134f73", "path": "string", "sha256": "string" } ], "validUntil": "2019-08-24T14:15:22Z", "sourceTaskId": "b46343f0-19a2-4701-a438-6edf056909b2", "sourceRunId": "f56f10c5-743d-477c-a57d-2d752452e421", "authorProfileKey": "string", "department": "growth", "retainedAt": "2019-08-24T14:15:22Z" }, "freshness": "current", "supersededBy": "608778cc-35f6-47d1-a540-9bcbfdf24101", "procedure": [ "string" ] }, "meta": {}}/internal/agent/organizations/{organizationId}/learningOperator and Chat read all enabled learning profiles. Departments read organization and own-profile conclusions. Learned conclusions do not grant connector or mutation authority. Missing memory is null. Disabled profiles are excluded.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidRequired with the service token. Execution capabilities supply the authoritative acting profile.
uuidapplication/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/learning"{ "success": true, "statusCode": 0, "message": "string", "data": [ { "profileKey": "string", "profileName": "string", "department": "growth", "memory": { "kind": "profile_memory", "profileKey": "string", "revision": 1, "watermarkTaskId": "023859b5-2793-427e-a028-3a460435c0b3", "lessons": [ { "key": "string", "lesson": "string", "sourceTaskIds": [ "e4637db2-e2d0-4ad1-a6b6-4e31232d78bc" ], "evidence": [ { "runId": "78c33d18-170c-44d3-a227-b3194f134f73", "path": "string", "sha256": "string" } ], "humanInboxItemIds": [ "b2732a79-0f5e-40b3-bc7b-2f46370ece85" ], "createdAt": "2019-08-24T14:15:22Z", "supersedes": "string", "origin": "verified_learning" } ], "suggestions": [ { "key": "string", "title": "string", "rationale": "string", "prompt": "string", "evidence": [ { "runId": "78c33d18-170c-44d3-a227-b3194f134f73", "path": "string", "sha256": "string" } ] } ], "lastLearnedAt": "2019-08-24T14:15:22Z", "cycleStartedAt": "2019-08-24T14:15:22Z", "sourceTaskId": "b46343f0-19a2-4701-a438-6edf056909b2" }, "inputs": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "profileKey": "string", "sourceTaskId": "b46343f0-19a2-4701-a438-6edf056909b2", "status": "open", "question": "string", "presentation": { "title": "string", "summary": "string", "businessImpact": "string", "recommendation": "string", "options": [ { "id": "string", "label": "string", "description": "string" }, { "id": "string", "label": "string", "description": "string" } ], "recommendedOptionId": "string" }, "response": "string", "resolvedAt": "2019-08-24T14:15:22Z" } ] } ], "meta": {}}/internal/agent/organizations/{organizationId}/learning/{profileKey}Operator and Chat read all enabled learning profiles. Departments read organization and own-profile conclusions. Learned conclusions do not grant connector or mutation authority. Missing memory is null. Disabled profiles are excluded.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuid^[a-z0-9]+(?:-[a-z0-9]+)*$1 <= length <= 100Required with the service token. Execution capabilities supply the authoritative acting profile.
uuidapplication/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/learning/string"{ "success": true, "statusCode": 0, "message": "string", "data": { "profileKey": "string", "profileName": "string", "department": "growth", "memory": { "kind": "profile_memory", "profileKey": "string", "revision": 1, "watermarkTaskId": "023859b5-2793-427e-a028-3a460435c0b3", "lessons": [ { "key": "string", "lesson": "string", "sourceTaskIds": [ "e4637db2-e2d0-4ad1-a6b6-4e31232d78bc" ], "evidence": [ { "runId": "78c33d18-170c-44d3-a227-b3194f134f73", "path": "string", "sha256": "string" } ], "humanInboxItemIds": [ "b2732a79-0f5e-40b3-bc7b-2f46370ece85" ], "createdAt": "2019-08-24T14:15:22Z", "supersedes": "string", "origin": "verified_learning" } ], "suggestions": [ { "key": "string", "title": "string", "rationale": "string", "prompt": "string", "evidence": [ { "runId": "78c33d18-170c-44d3-a227-b3194f134f73", "path": "string", "sha256": "string" } ] } ], "lastLearnedAt": "2019-08-24T14:15:22Z", "cycleStartedAt": "2019-08-24T14:15:22Z", "sourceTaskId": "b46343f0-19a2-4701-a438-6edf056909b2" }, "inputs": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "profileKey": "string", "sourceTaskId": "b46343f0-19a2-4701-a438-6edf056909b2", "status": "open", "question": "string", "presentation": { "title": "string", "summary": "string", "businessImpact": "string", "recommendation": "string", "options": [ { "id": "string", "label": "string", "description": "string" }, { "id": "string", "label": "string", "description": "string" } ], "recommendedOptionId": "string" }, "response": "string", "resolvedAt": "2019-08-24T14:15:22Z" } ] }, "meta": {}}/internal/agent/organizations/{organizationId}/learning/{profileKey}/refreshReturns the active root learning task or creates a pending one for the scheduler. Concurrent scheduled and manual requests coalesce under a database lock. Operator and Chat may refresh enabled profiles; a department may refresh only itself. Verification and stale executions cannot refresh. No suggestions execute and no run budget resets.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuid^[a-z0-9]+(?:-[a-z0-9]+)*$1 <= length <= 100Required with the service token. Execution capabilities supply the authoritative acting profile.
uuidapplication/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/learning/string/refresh"{ "success": true, "statusCode": 0, "message": "string", "data": { "taskId": "e6e9d88a-9b63-468a-aec3-b7a11de27af8", "identifier": "string", "status": "pending" }, "meta": {}}/internal/agent/organizations/{organizationId}/tasks/{taskRef}/runsRequires the active organization capability and enabled profile. Reads are organization-wide across departments; write ownership and integration permissions are unchanged. Trashed task roots are excluded. Files must be retained terminal-run outputs. Results preserve source task/run identities. Follow pagination for older evidence; history is not automatically hydrated. File chunks are UTF-8 or base64 with byte offsets; partial checksums are not marked verified. Legacy files without worker receipts are marked unrecorded.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidTask UUID or identifier.
1 <= length <= 40961 <= value <= 10020application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/runs"{}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}{}/internal/agent/organizations/{organizationId}/runs/{runId}Returns public run state, taskIdentifier, committed outcome/checkpoint payloads in evidence, and evidenceNextCursor. Pass that cursor to read the next evidence page. No leases, credentials, context snapshots, or raw transcripts are returned. Requires an enabled profile and same-organization task read access.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidSource run UUID in the current organization.
1 <= length <= 40961 <= value <= 10020application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/runs/string"{ "success": true, "statusCode": 200, "data": { "id": "5874578b-65c7-4d72-b3de-2bc24a8b421e", "taskId": "b12e12e7-68df-4ba8-a72a-32eb80d60b64", "agentProfile": { "id": "8abf91f2-5785-44c7-bfb2-508fa85a8f8d", "key": "engineering", "name": "Engineering", "kind": "department", "department": "engineering", "status": "enabled" }, "attempt": 1, "mode": "execute", "status": "succeeded", "logState": "complete", "model": "gpt-5", "output": { "kind": "task_result", "result": { "kind": "completed", "summary": "Created and verified the onboarding plan.", "artifacts": [], "completion": { "version": 1, "taskVersion": 1, "taskGraphRevision": 1, "completionRevision": 1, "runIds": [ "5874578b-65c7-4d72-b3de-2bc24a8b421e" ], "disposition": "passed", "checks": [ { "criterionIndex": 0, "evaluator": "backend", "status": "passed", "summary": "The required JSON output matched its declared structure.", "evidence": [ { "kind": "file", "runId": "5874578b-65c7-4d72-b3de-2bc24a8b421e", "path": "outputs/onboarding-plan.json", "uri": "s3://oblive/organizations/example/runs/example/outputs/onboarding-plan.json", "size": 1280, "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "mediaType": "application/json" } ] } ] } } }, "error": null, "usage": { "inputTokens": 0, "outputTokens": 0, "toolCalls": 0, "costMinorUnits": 0 }, "startedAt": "2026-01-01T00:01:00.000Z", "finishedAt": "2026-01-01T00:03:00.000Z", "createdAt": "2026-01-01T00:01:00.000Z", "updatedAt": "2026-01-01T00:01:00.000Z", "taskIdentifier": "ENG-3", "evidence": [], "evidenceNextCursor": null }}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}{}/internal/agent/organizations/{organizationId}/runs/{runId}/filesRequires the active organization capability and enabled profile. Reads are organization-wide across departments; write ownership and integration permissions are unchanged. Trashed task roots are excluded. Files must be retained terminal-run outputs. Results preserve source task/run identities. Follow pagination for older evidence; history is not automatically hydrated. File chunks are UTF-8 or base64 with byte offsets; partial checksums are not marked verified. Legacy files without worker receipts are marked unrecorded.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidSource run UUID in the current organization.
1 <= length <= 40961 <= value <= 10020application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/runs/string/files"{}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}{}/internal/agent/organizations/{organizationId}/runs/{runId}/files/contentRequires the active organization capability and enabled profile. Reads are organization-wide across departments; write ownership and integration permissions are unchanged. Trashed task roots are excluded. Files must be retained terminal-run outputs. Results preserve source task/run identities. Follow pagination for older evidence; history is not automatically hydrated. File chunks are UTF-8 or base64 with byte offsets; partial checksums are not marked verified. Legacy files without worker receipts are marked unrecorded.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidSource run UUID in the current organization.
1 <= length <= 10240 <= value <= 900719925474099101 <= value <= 262144655361 <= length <= 512application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/runs/string/files/content?path=string"{}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}{}/internal/agent/organizations/{organizationId}/statusToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidapplication/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/status"{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/work-dispatchToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidapplication/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/work-dispatch" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/context/promotionsToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidapplication/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/context/promotions" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "statusCode": 201, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/organization/researchUses backend-managed research providers and immutable evidence storage. The execution capability must belong to an admitted, eligible research task run. Collection is fenced by generation, pass, cycle, and lease. Department runs reuse deep evidence.
agentExecutionCapability Short-lived capability scoped to one organization, profile, and task run or chat turn.
In: header
Organization identifier.
uuidapplication/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/organization/research"{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/tasks/{taskRef}/context-revisions/promoteToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidTask UUID or identifier.
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/context-revisions/promote" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/tasksToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidapplication/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks"{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/tasksToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidapplication/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "statusCode": 201, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/tasks/{taskRef}Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidTask UUID or identifier.
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string"{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/tasks/{taskRef}Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidTask UUID or identifier.
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/tasks/{taskRef}/dependenciesToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidTask UUID or identifier.
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/dependencies"{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/tasks/{taskRef}/dependenciesToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidTask UUID or identifier.
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/dependencies" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "statusCode": 201, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/tasks/{taskRef}/cancelToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidTask UUID or identifier.
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/cancel" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/tasks/{taskRef}/retryToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidTask UUID or identifier.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/retry"{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/tasks/{taskRef}/human-inboxPrefer a concise business presentation with optional choices. Technical diagnostics are retained separately and collapsed by default. Legacy message-only input remains supported; a question opens only after fenced worker completion.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidTask UUID or identifier.
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/human-inbox" \ -H "Content-Type: application/json" \ -d '{ "sourceRunId": "f56f10c5-743d-477c-a57d-2d752452e421", "authorAgentProfileId": "e3bb8867-a70f-4497-b7e2-c1dcae2a8773", "kind": "question", "idempotencyKey": "string" }'{ "success": true, "statusCode": 201, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/tasks/{taskRef}/outcomesStages only agent-authored semantic outcomes for the caller's active task run. Execution-scoped agents cannot submit the worker-owned execution variant. The backend validates mode, task, run, task version, graph revision, and idempotency. A deferred outcome is legal only in execute/research and requires summary, future UTC resumeAt and continuationPath beneath outputs/. Worker completion requires a nonempty current-run continuation receipt and artifact before scheduling the same task; spent credits, owner and graph are preserved. Deferral cannot replace a human/action handoff, and exhausted work fails explicitly. A child review amendment records a repair proposal and wakes its ancestor coordinator at worker finalization; only a coordinator amendment applies the repairs and consumes its replan allowance. The coordinator reopens addressed waiting reviews for another review after their dependencies finish. Action-interrupt IDs remain valid when the named run-owned actions finish before finalization; unresolved actions block continuation, and completed receipts are retained without replaying their effects. Verification behavior is read-only: it is used by profile learning and retained pre-cutover task states, and its capability permits reads plus the one mode-legal verification outcome only.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidTask UUID or identifier.
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/outcomes" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "statusCode": 201, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/schedulesToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidapplication/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/schedules"{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/schedulesToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidapplication/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/schedules" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "statusCode": 201, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/schedules/{scheduleRef}/pauseToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidSchedule UUID or stable key.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/schedules/string/pause"{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/schedules/{scheduleRef}/resumeToken used by trusted agent runtimes.
In: header
Organization identifier.
uuidSchedule UUID or stable key.
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/schedules/string/resume"{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/schedules/{scheduleRef}Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidSchedule UUID or stable key.
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/schedules/string"{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/schedules/{scheduleRef}Edits the name, timing or task instructions without changing ownership, provenance, execution history or paused status. Requires the updatedAt value from a current read; a concurrent edit returns 409. Platform-managed schedules cannot be changed through this endpoint. Department agents can edit only their own schedules; Chat and Operator can edit user schedules across departments.
Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidSchedule UUID or stable key.
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/schedules/string" \ -H "Content-Type: application/json" \ -d '{ "expectedUpdatedAt": "2026-09-28T10:00:00.000Z", "trigger": { "kind": "interval", "everyMinutes": 1440, "timezone": "UTC" }, "nextRunAt": "2026-09-29T09:00:00.000Z", "task": { "objective": "Report sales and highlight changes that need attention." } }'{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}/internal/agent/organizations/{organizationId}/schedules/{scheduleRef}Token used by trusted agent runtimes.
In: header
Organization identifier.
uuidSchedule UUID or stable key.
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/schedules/string"{ "success": true, "statusCode": 200, "message": "Control-plane operation completed.", "data": {}}{ "success": false, "statusCode": 400, "message": "Validation failed.", "error": { "code": "validation_failed" }}{ "success": false, "statusCode": 401, "message": "Invalid agent service token or execution capability.", "error": { "code": "agent_unauthorized" }}{ "success": false, "statusCode": 404, "message": "Control-plane entity was not found.", "error": { "code": "not_found" }}{ "success": false, "statusCode": 409, "message": "Control-plane state conflict.", "error": { "code": "state_conflict" }}length <= 2000length <= 2000Value in
1 <= length <= 20001 <= length <= 200^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuid^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuid1 <= length <= 20000items <= 5^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuid^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidValue in
1 <= length^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$date-time1 <= length <= 500^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$date-time