Loading API reference…
/organizations/{organizationId}/human-inboxOrganization 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/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/human-inbox"{ "success": true, "statusCode": 200, "message": "Human inbox items listed.", "data": []}/organizations/{organizationId}/inbox/summaryOrganization identifier.
uuidapplication/json
curl -X GET "https://example.com/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 }}/organizations/{organizationId}/human-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.
Organization identifier.
uuidHuman inbox item identifier.
uuidapplication/json
application/json
application/json
application/json
curl -X GET "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/human-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" }}/organizations/{organizationId}/human-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.
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/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/human-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" }}/organizations/{organizationId}/human-inbox/{inboxItemId}/acknowledgeOrganization identifier.
uuidHuman inbox item identifier.
uuidapplication/json
application/json
application/json
application/json
curl -X POST "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/human-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" }}