Error

A valid request URL is required to generate request examples

{
  "redirect_to": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>",
  "client_name": "<string>",
  "redirect_to": {
    "kind": "loopback",
    "host": "<string>",
    "scheme": "<string>"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

API Reference

Decline an AI assistant's connection request

Declines a request read with GET /mcp/consent: nothing is granted. The client is told (redirect_to carries error=access_denied) only when its redirect URI is on this computer (loopback): anyone can register any other, and following it would turn a click on Cancel into a redirect to a stranger’s page. Works while AI assistants are off for the store or the Depict app is not installed on it, so a refused request can still be answered. Side effect: the request is used up (declining it again answers 404).

DELETE

/

mcp

/

consent

Error

A valid request URL is required to generate request examples

{
  "redirect_to": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>",
  "client_name": "<string>",
  "redirect_to": {
    "kind": "loopback",
    "host": "<string>",
    "scheme": "<string>"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Authorizations

Authorization

string

header

required

Shopify App Bridge session token of the embedded Depict: Search & Merchandising app. The shop in the token determines the merchant; merchant_id parameters must belong to that shop.

Query Parameters

txn

string

required

The mcp_txn parameter of the Settings link the assistant's sign-in opened.

Pattern: ^[A-Za-z0-9_-]{20,}$

Response

Declined; follow redirect_to when it is not null.

redirect_to

string | null

required

The assistant's OAuth redirect carrying error=access_denied, for a redirect URI on this computer (loopback): navigate the top-level window there so the assistant stops waiting. Null for any other redirect URI, which anyone can register: nothing is sent, and the assistant times out on its own.