Skip to main content

Endpoint

POST /cases/{id}/input

Auth

x-api-key: your-api-key

Purpose

Accepts human input for a case that is paused in INPUT_NEEDED.

Path parameters

ParameterTypeRequiredNotes
idstringYesThe target case ID.

Request body

FieldTypeRequiredNotes
inputRequestIdstringYesMust match the active request from the webhook.
providedContextstringYesThe answer or context Offload should use next.

Example request

{
  "inputRequestId": "input-request-123",
  "providedContext": "Yes, next Monday is acceptable. Ask them to send the signed form by 5 PM PT."
}

Example response

{
  "ok": true,
  "data": {
    "caseId": "case_123",
    "inputRequestId": "input-request-123",
    "accepted": true
  }
}
202 Accepted means the input was queued successfully. The case continues asynchronously after that.

Conflict cases

This endpoint returns 409 when:
  • the case is not in INPUT_NEEDED
  • the input request is no longer PENDING
  • the provided inputRequestId no longer matches the active request

Errors

StatusCodeMeaning
400INVALID_REQUESTMissing case ID or invalid body
401UNAUTHORIZEDMissing or invalid API key
403FORBIDDENThe case belongs to another client
404CASE_NOT_FOUNDNo case exists for that ID
409CASE_NOT_WAITING_FOR_INPUTThe case is not paused for input
409INPUT_REQUEST_NOT_PENDINGThe active request is already resolved
409INPUT_REQUEST_MISMATCHThe input request ID is stale or incorrect
500INTERNAL_ERRORThe input could not be accepted