Unreleased documentation. These pages follow the main branch and can change before the next release. For supported guidance, use v0.43.0.
actions.correct-address.start
const url = 'https://example.com/v1/actions/correct-address/proposals';const options = { method: 'POST', headers: { 'Idempotency-Key': 'example', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"input":{"addressLine":"example","city":"example","facilityId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","postalCode":"example"}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/v1/actions/correct-address/proposals \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: example' \ --data '{ "input": { "addressLine": "example", "city": "example", "facilityId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "postalCode": "example" } }'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”Optional W3C trace context. Responses carry Registry trace context for the request.
Idempotency key bound to the action route, selected profile, package revision, normalized action input, preconditions, and granted result contract.
Query Parameters
Section titled “Query Parameters”Select one compiled access profile. Required when the route has no default; otherwise omission uses its default.
Request Bodyrequired
Section titled “Request Bodyrequired”object
object
Example generated
{ "input": { "addressLine": "example", "city": "example", "facilityId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "postalCode": "example" }}Responses
Section titled “Responses”Proposal created
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
Example
{ "applicationStatus": { "mode": "automatic", "reason": "contract-changed", "recovery": "retry", "state": "awaiting-review" }, "attachments": { "additionalProperty": { "classification": "public", "links": { "additionalProperty": { "availability": { "reason": "pending-review", "recovery": "refresh" }, "method": "GET", "operation": "download" } }, "value": { "verificationStatus": "notRequired" } } }, "blockedReason": "package-changed", "decision": { "status": "approved" }, "links": { "additionalProperty": { "availability": { "reason": "pending-review", "recovery": "refresh" }, "method": "GET" } }, "state": "draft", "turn": "party"}Headers
Section titled “Headers”Caller-dependent responses must not be stored.
Strong Registry ETag for the created Proposal.
Relative URL of the created Proposal.
Trace context for this response.
Example
00-11111111111111111111111111111111-2222222222222222-01Problem response
object
Examples
{ "code": "request.invalid", "detail": "The request is invalid.", "status": 400, "title": "Bad Request", "traceId": "11111111111111111111111111111111", "type": "https://id.registrystack.org/problems/registry-breg/request/invalid"}Headers
Section titled “Headers”Caller-dependent responses must not be stored.
Trace context for this problem response.
Example
00-11111111111111111111111111111111-2222222222222222-01Problem response
object
Examples
{ "code": "authentication.refused", "detail": "The bearer credential is missing or refused.", "status": 401, "title": "Unauthorized", "traceId": "11111111111111111111111111111111", "type": "https://id.registrystack.org/problems/registry-breg/authentication/refused"}Headers
Section titled “Headers”Caller-dependent responses must not be stored.
Trace context for this problem response.
Example
00-11111111111111111111111111111111-2222222222222222-01Problem response
object
Examples
{ "code": "resource.not_found", "detail": "The requested resource was not found.", "status": 404, "title": "Not Found", "traceId": "11111111111111111111111111111111", "type": "https://id.registrystack.org/problems/registry-breg/resource/not_found"}Headers
Section titled “Headers”Caller-dependent responses must not be stored.
Trace context for this problem response.
Example
00-11111111111111111111111111111111-2222222222222222-01Problem response
object
Examples
{ "code": "idempotency.conflict", "detail": "The idempotency key is bound to another request.", "status": 409, "title": "Conflict", "traceId": "11111111111111111111111111111111", "type": "https://id.registrystack.org/problems/registry-breg/idempotency/conflict"}{ "code": "mutation.conflict", "detail": "The mutation conflicts with current state.", "status": 409, "title": "Conflict", "traceId": "11111111111111111111111111111111", "type": "https://id.registrystack.org/problems/registry-breg/mutation/conflict"}Headers
Section titled “Headers”Caller-dependent responses must not be stored.
Trace context for this problem response.
Example
00-11111111111111111111111111111111-2222222222222222-01Problem response
object
Examples
{ "code": "idempotency.expired", "detail": "The held response of the idempotency key expired; the key stays spent.", "status": 410, "title": "Gone", "traceId": "11111111111111111111111111111111", "type": "https://id.registrystack.org/problems/registry-breg/idempotency/expired"}Headers
Section titled “Headers”Caller-dependent responses must not be stored.
Trace context for this problem response.
Example
00-11111111111111111111111111111111-2222222222222222-01Problem response
object
Examples
{ "code": "precondition.failed", "detail": "The mutation precondition failed.", "status": 412, "title": "Precondition Failed", "traceId": "11111111111111111111111111111111", "type": "https://id.registrystack.org/problems/registry-breg/precondition/failed"}Headers
Section titled “Headers”Caller-dependent responses must not be stored.
Trace context for this problem response.
Example
00-11111111111111111111111111111111-2222222222222222-01Problem response
object
Examples
{ "code": "unsupported.media_type", "detail": "The request media type is not supported.", "status": 415, "title": "Unsupported Media Type", "traceId": "11111111111111111111111111111111", "type": "https://id.registrystack.org/problems/registry-breg/unsupported/media_type"}Headers
Section titled “Headers”Caller-dependent responses must not be stored.
Trace context for this problem response.
Example
00-11111111111111111111111111111111-2222222222222222-01Problem response
object
Examples
{ "code": "service.unavailable", "detail": "The Registry mutation service is unavailable.", "status": 503, "title": "Service Unavailable", "traceId": "11111111111111111111111111111111", "type": "https://id.registrystack.org/problems/registry-breg/service/unavailable"}Headers
Section titled “Headers”Caller-dependent responses must not be stored.
Trace context for this problem response.
Example
00-11111111111111111111111111111111-2222222222222222-01Problem response
object
Examples
{ "code": "request.timeout", "detail": "The request timed out.", "status": 504, "title": "Gateway Timeout", "traceId": "11111111111111111111111111111111", "type": "https://id.registrystack.org/problems/registry-breg/request/timeout"}Headers
Section titled “Headers”Caller-dependent responses must not be stored.
Trace context for this problem response.
Example
00-11111111111111111111111111111111-2222222222222222-01