← Back to schema index

CommitBeneficiaryImportResponse

Response from `POST /v1/beneficiaries/imports/{id}/commit` (HTTP 202). Minimal JSON:API envelope with the job ID and its new status (`committing`). The worker executes the commit; poll `GET /v1/beneficiaries/imports/{id}` until `completed` or `failed`.

Properties

FieldTypeDescription
dataobjectMain response payload. Shape varies by endpoint (object, array, or JSON:API envelope with `type`, `id`, `attributes`).
type*stringJSON:API resource type. Always `beneficiary_import`.
id*stringNumeric job ID expressed as a string.
attributes*objectJob attributes returned after commit (transition status).
status*stringNew status after enqueuing the commit. The only possible value is `committing`.
metaobjectResponse metadata including API version, route prefix, unique request identifier, and the server timestamp in UTC.
versionstringAPI version that processed the request.
api_versionstringAPI route prefix version (e.g. `v1`).
request_idstringUnique request identifier (hex).
datetimeobjectCompanion descriptor present in every response's meta block (and in outgoing webhook payloads). Lets clients assert the timezone contract without re-reading the spec.
timezone*stringAlways `UTC` — the canonical timezone for every datetime field in the body.
format*stringAlways `ISO 8601` — explicit `Z` suffix on every datetime.
linksobjectPagination or related links, present only when the endpoint returns a paginated collection.

Used in operations

  • POST /v1/beneficiaries/imports/{id}/commit