Report unable to complete

Reports that the human could not complete the payer interaction.

This is an explicit operator outcome, distinct from passive timeout. Collate does not resume mutating automation after this handoff.

Returns

Returns handoff closure state and the authorization processing projection.

Authentication

AuthorizationBearer

API key passed as Authorization: Bearer <API_KEY>.

Path parameters

authorization_idstringRequired

Authorization ID returned by POST /v1/prior-authorizations.

handoff_idstringRequired

Manual handoff ID returned by POST /manual-handoffs.

Request

This endpoint expects an object.

reasonenumRequired

operatorNotesstring or nullOptional

Response

Successful Response

manualHandoffIdstring

stateenum

Allowed values:

authorizationobject

resultenum or null

reconciliationobject or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

413

Content Too Large Error

422

Unprocessable Entity Error

500

Internal Server Error

503

Service Unavailable Error

$	curl -X POST https://api.sandbox.trycollate.ai/v1/prior-authorizations/authorization_id/manual-handoffs/handoff_id/unable-to-complete \
>	-H "If-Match: If-Match" \
>	-H "Authorization: Bearer <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"reason": "channel_blocked"
>	}'

1	{
2	"manualHandoffId": "string",
3	"state": "offered",
4	"authorization": {
5	"id": "string",
6	"version": 1,
7	"status": "requires_action"
8	},
9	"result": "completed_reported",
10	"reconciliation": {
11	"id": "string",
12	"state": "pending"
13	}
14	}

Returns

Authentication

Path parameters

Headers

Request

Response

Errors

Authentication

Path parameters

Headers

Request

Response

Errors