Skip to content

Reject an identity-link proposal

POST
/api/v1/identity-link-proposals/{id}/reject
curl --request POST \
--url http://localhost:11044/api/v1/identity-link-proposals/example/reject \
--header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'

Tombstones the identity — automatic matching will never re-propose it — and dismisses the proposal.

id
required
string

Notification id of the proposal

Rejected

Media type*/*
object

Not permitted — the proposal targets another world

Media type*/*

A refusal with a machine-readable code and a plain-language message. ApiErrorAdvice answers it for a failed validation, a missing resource or a conflicting state, and some controllers answer it directly

object
code
required

Machine-readable key to branch on, such as validation_failed, unknown_field, not_found or conflict. Open: a surface may answer codes of its own

string
detail

Extra context where there is some, such as the fields a body may carry; null otherwise

string
message
required

A plain-language explanation, written to be shown. Never carries an exception message

string

No such pending proposal

Proposal payload could not be parsed

Media type*/*

A refusal with a machine-readable code and a plain-language message. ApiErrorAdvice answers it for a failed validation, a missing resource or a conflicting state, and some controllers answer it directly

object
code
required

Machine-readable key to branch on, such as validation_failed, unknown_field, not_found or conflict. Open: a surface may answer codes of its own

string
detail

Extra context where there is some, such as the fields a body may carry; null otherwise

string
message
required

A plain-language explanation, written to be shown. Never carries an exception message

string