Submit an unmetered response.

Accepted responses are idempotent, counted for observability and never metered or charged.

post/v1/collections/{id}/responses

Request

  • Base URL: http://127.0.0.1:8080
  • URL: http://127.0.0.1:8080/v1/collections/{id}/responses
  • Auth: HTTP bearer

Path parameters

idstring required

Resource ID returned by creation.

Request body

idempotencyKeystring required
answersobject required

Question-ID keyed answers. Legacy and schema-v3 choice answers retain their documented wire types. Ranking is a complete option-ID permutation; matrix is a row-ID map to a column ID or nonempty column-ID array; constant_sum is an exact item-ID map to nonnegative integers totaling the configured total. The backend validates dynamic membership, sums, requiredness, routes and visibility.

metadataobject

Untrusted caller metadata; compact serialized JSON must be at most 4096 bytes.

Example request

{
  "idempotencyKey": "fixture-submission-0001",
  "answers": {
    "rating": 4,
    "reason": "speed",
    "improvements": [
      "payment"
    ],
    "comment": "Easy to use",
    "minutes": 2.5,
    "visitDate": "2026-09-06"
  },
  "metadata": {
    "placement": "checkout-success"
  }
}

Response

Success

responseIdstring uuid required
collectionIdstring uuid required
acceptedunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.