Authorization

Use a server-side API key with the listed grants and permitted resource access.

cases:data:write

Request headers

X-Api-Keyrequired: Your server-side integration credential.
Idempotency-Keyrequired: Stable key for this intended action. Reuse it for retries of the same request.
If-Matchrequired: Current ETag for the resource being changed. A stale version returns 412.
Content-Typeapplication/json: Encode the request body as JSON.

Path parameters

idstring · required: Opaque identifier in the authorized resource scope. Nested identifiers must belong to their parent resource.
itemIdstring · required: Opaque identifier in the authorized resource scope. Nested identifiers must belong to their parent resource.

Request body

answerstring · required: The traveler’s answer to an ad-hoc question.

Response

201Created

Returns the authorized resource or result for this operation. List results use items, nextCursor, and hasMore.

Errors

Authentication failures return 401 or 403. Inaccessible resources return 404. Business and idempotency conflicts return 409. Rate limits return 429 with retry guidance.

Error handling guide

curl --request POST 'https://api.wincora.com/api/v1/tenant/cases/id_example/collection-items/itemId_example/answers' \ --header 'X-Api-Key: YOUR_API_KEY' \ --header 'Idempotency-Key: request-example-001' \ --header 'If-Match: "resource-version"' \ --header 'Content-Type: application/json' \ --data '{ "answer": "I will collect my passport in person." }'

const response = await fetch('https://api.wincora.com/api/v1/tenant/cases/id_example/collection-items/itemId_example/answers', { method: 'POST', headers: { "X-Api-Key": process.env.WINCORA_API_KEY, "Idempotency-Key": "request-example-001", "If-Match": "\"resource-version\"", "Content-Type": "application/json" }, body: JSON.stringify({ "answer": "I will collect my passport in person." }) }); if (!response.ok) throw new Error(await response.text()); const result = await response.json();

import os import requests response = requests.request( 'POST', 'https://api.wincora.com/api/v1/tenant/cases/id_example/collection-items/itemId_example/answers', headers={ "X-Api-Key": os.environ["WINCORA_API_KEY"], "Idempotency-Key": "request-example-001", "If-Match": "\"resource-version\"", "Content-Type": "application/json" }, json={ "answer": "I will collect my passport in person." }, timeout=30, ) response.raise_for_status() result = response.json()