Create an immutable embedded collection only when every declared SDK installation supports the bound schema version. Identical retries return the original submission credential; handle it as a secret.

post/v1/collections

Request

  • Base URL: http://127.0.0.1:8080
  • URL: http://127.0.0.1:8080/v1/collections
  • Auth: HTTP bearer

Headers

X-Likerts-Workspacestring

Required for human OAuth access; service credentials are already workspace-bound.

Request body

idempotencyKeystring required
surveyIdstring required
versioninteger required
placementstring required
expiresAtstring date-time

Optional future expiry, at most 90 days from creation.

responseCapinteger

Response

Success

idstring uuid required
surveyIdstring uuid required
versioninteger required
placementstring required
tokenstring required

Opaque limited collection bearer credential; never parse its format. Returned on creation; cannot manage surveys or read responses.

acceptingboolean required
expiresAtstring date-time nullable required
responseCapinteger nullable required
revokedboolean required

Changes

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