Unlink an account

{
  "partnerMemberId": "partner_123456789",
  "biltMemberId": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "status": "unlinked"
}

{
  "error": "LINK_NOT_FOUND",
  "errorDescription": "<string>"
}

{
  "error": "LINK_NOT_FOUND",
  "errorDescription": "<string>"
}

{
  "error": "LINK_NOT_FOUND",
  "errorDescription": "<string>"
}

{
  "error": "MEMBER_ID_MISMATCH",
  "errorDescription": "Provided biltMemberId does not match the linked account"
}

{
  "error": "LINK_NOT_FOUND",
  "errorDescription": "<string>"
}

Implement POST /bilt/unlink-account on your server. Bilt calls it with the request below.

Authorization

string

header

required

The credential you issue to Bilt for the endpoints you host. Validate it on every request, before you read the body, and keep it out of logs.

application/json

partnerMemberId

string

required

Your member id on the link.

biltMemberId

string<uuid>

When sent, check that it matches the stored link before you unlink.

The link is ended.

status

string

required

Allowed value: "unlinked"

⌘I

{
  "partnerMemberId": "partner_123456789",
  "biltMemberId": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "status": "unlinked"
}

{
  "error": "LINK_NOT_FOUND",
  "errorDescription": "<string>"
}

{
  "error": "LINK_NOT_FOUND",
  "errorDescription": "<string>"
}

{
  "error": "LINK_NOT_FOUND",
  "errorDescription": "<string>"
}

{
  "error": "MEMBER_ID_MISMATCH",
  "errorDescription": "Provided biltMemberId does not match the linked account"
}

{
  "error": "LINK_NOT_FOUND",
  "errorDescription": "<string>"
}