Remove an inbond address
Remove an inbond address from your account: the one you added last at an inbond warehouse, by its inbond_address_id from GET /addresses/inbond.
Your default billing or delivery address on Cru is not removed: choose another default on the Cru website first. Your other addresses are never changed.
How this write runs
inbond_address.remove| Partner credentialCLIENT-KEY · CLIENT-SECRET | Executes at once and answers 200. The body must carry a reference: send the identical request again after a timeout and Cru replays the first outcome instead of acting twice. |
| Connected appAuthorization: Bearer | Answers 202 with a confirmation code and does nothing else. It runs only when the app calls POST /confirmations/{code} within 15 minutes, after the customer agrees. |
Writes & confirmations, in full →
Path parameter
REQUIRED| idinteger | The inbond_address_id of the address’s warehouse, from GET /addresses/inbond. With more than one address of yours there, the one added last is removed. |
Request body
APPLICATION/JSON| FIELD | DESCRIPTION |
|---|---|
| referencestring · 1–50 chars · partners: required | Your idempotency key: letters and digits, then . _ : or - allowed. Required on a partner credential’s write and kept for good, so a retry with it can never act twice. Ignored for connected apps. |
Any other field is refused with VALIDATION_UNKNOWN_PARAMETER / 400.
A partner credential sends {"reference": "…"} as the JSON body.
Response fields
200 OK · 202 AcceptedA partner credential gets 200 and the address removed. A connected app gets 202 and a confirmation.
Executed 200
actionstring
The action that ran, such as bid.place.
statusstring
completed.
inbond_addressobject
The address removed, as GET /addresses/inbond listed it.
Staged 202
confirmation.codestring
cnf_ and 43 more characters. A secret: the only handle on the instruction, valid for 15 minutes, once.
confirmation.actionstring
The action staged, such as bid.place.
confirmation.statusstring
pending.
confirmation.expires_atdatetime
RFC 3339 UTC.
confirmation.previewobject
summary, then the address as GET /addresses/inbond lists it.
Errors
No inbond address of yours at that warehouse returns NOT_FOUND / 404, and an id that is not a whole number of 1 or more VALIDATION_INVALID_VALUE / 422. Your default billing or delivery address, or an address already gone when a connected app confirms, is TRADE_REFUSED / 422. Missing or invalid credentials return AUTH_INVALID_CREDENTIALS / 401. A credential without addresses:write gets AUTH_INSUFFICIENT_SCOPE / 403. View all error codes →