Provide Case Input

​

Endpoint

POST /cases/{id}/input

​

Purpose

​

Authentication

x-api-key: your-api-key

​

Path Parameters

​

Request Body

​

Example Request

curl -X POST "$OFFLOAD_BASE_URL/cases/4fc5904d-0e44-4ed3-aa57-c4a47ad0ae4f/input" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $OFFLOAD_API_KEY" \
  -d '{
    "inputRequestId": "c8c6a7ca-a913-4d13-8cd8-5887efb0531c",
    "providedContext": "Yes. A signed PDF is acceptable. Ask them to send it by Friday."
  }'

​

Successful Response

{
  "ok": true,
  "data": {
    "caseId": "4fc5904d-0e44-4ed3-aa57-c4a47ad0ae4f",
    "inputRequestId": "c8c6a7ca-a913-4d13-8cd8-5887efb0531c",
    "accepted": true
  }
}

​

What 202 Accepted Means

• the input passed validation
• the case was found and owned by the caller
• the internal queue accepted the follow-up work

• the worker already processed your answer
• the case has already left INPUT_NEEDED
• a reply was already sent

​

Transient State To Expect

• the API updates inputRequestStatus to RESOLVED
• the case can still be INPUT_NEEDED until the worker finishes

​

Conflict Errors

• the case is not currently waiting for input
• the active request is no longer pending
• the inputRequestId does not match the currently active request

​

Errors