Skip to main content
GET
Error

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

The pending request.

client_name
string | null
required

The name the assistant registered under, e.g. Claude Code; null when it gave none. Anyone can register any name: redirect_to is what identifies where the code goes.

client_id
string
required

The OAuth client id the assistant registered.

redirect_to
object
required

Where approving sends the browser, and with it the authorization code, read from the redirect URI the client registered: its name is free text, this is where the code goes. loopback: an app on this computer (http or https on localhost, 127.0.0.1 or [::1]); https: a website; http: a website without TLS; custom: an app's own URL scheme, with no host.

scopes
enum<string>[]
required

What it asks for that Depict grants: depict:read reads the store's data, depict:write changes it.

Available options:
depict:read,
depict:write
shop
string | null
required

The store's myshopify domain; null when it has none.

merchant_id
string
required

The store the assistant would act on.