Beta

The Partner Trading API v1 is in beta — endpoints and response shapes may still change.

Developers
Cru World Wine
API v1 · REST & MCP
Your addresses

Remove an inbond address

Prepares removing an inbond address from the customer's account: the one they added last at a warehouse from list_inbond_addresses. Their default billing or delivery address is never removed. This only prepares the instruction: it returns a summary and a confirmation_code and changes nothing until confirm_instruction is called with that code, after the customer agrees.

STAGEremove_inbond_addressLIVE
Needsaddresses:writeRESTDELETE /addresses/inbond/{id}Try it
Prepares inbond_address.remove, and changes nothing

With a connected app’s token, Cru checks the request against live data and either refuses it with a reason or returns a summary and a confirmation code. Nothing happens until confirm_instruction is called with that code — once, within 15 minutes, after the customer says yes.

With partner keys, carried out straight away

A partner key is offered this tool opening “Removes” instead of “Prepares removing”. It is carried out at once, with no confirmation step, and takes a required reference as its last argument, so sending the same one again returns the first result. It returns the action’s result as the REST response’s data gives it, with replayed, and is marked destructiveHint. Partner keys over MCP →

Arguments

1 REQUIRED
ARGUMENTDESCRIPTION
inbond_address_idinteger · ≥ 1 · required The address's warehouse, from list_inbond_addresses.

Any other argument is refused with a tool error that lists what the tool accepts. Numbers may also be sent as strings, and booleans as "true" or 1.

Returns

STRUCTUREDCONTENT

Once confirmed: inbond_address, the address removed, as list_inbond_addresses showed it.

The same object also comes as JSON text in content, for hosts that read only that. What a staging tool returns →

Errors

A refusal — a wine that is not on Cru, a price out of range — comes back as a result with isError: true and a message worded for the assistant to act on. A connection without addresses:write is not offered this tool, and calling it anyway returns 403 with a JSON-RPC error naming the scope. Missing or invalid credentials return 401. Conventions every tool shares →

UP NEXT Confirm an instruction

API credentials

Enter the client key and secret issued by Cru. They are kept for this browser tab’s session — a reload keeps them, closing the tab or clearing them ends them.

Credentials are never included in copied examples, and are redacted from anything the console prints back.

Request API access

Tell us who you are and what you want to build. Cru issues a client key and secret for your organisation, scoped to what you need.

Markets you trade in (choose one or more)

We use what you send here to reply about API access, and for nothing else. Cloudflare Turnstile checks the form for bots (privacy policy).