Skip to main content
POST

Authorizations

x-api-key
string
header
required

API key with sm_ prefix. Get your key at https://sudomock.com/dashboard/api-keys

Body

application/json
mockup_type
enum<string> | null
Available options:
psd,
2d
session_kind
enum<string> | null
Available options:
setup,
customize
mockup_uuid
string | null

UUID of the mockup to customize

Example:

"c315f78f-d2c7-4541-b240-a9372842de94"

product_id
string | null

Product ID from the platform

Maximum string length: 255
Example:

"8342019283"

variant_id
string | null

Variant ID from the platform

Maximum string length: 255
Example:

"44912837465"

allowed_origin
string | null
Maximum string length: 2048
Example:

"https://your-store.example.com"

config
StudioConfigPatch · object | null

Optional session-only Studio config override. Not persisted.

action_id
string | null
Required string length: 1 - 64
Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$
Example:

"add-to-cart"

artwork
StudioArtworkInput · object

Response

200 - application/json

Successful Response

mockup_type
enum<string>
required
Available options:
psd,
2d
session
string
required
Example:

"sess_xQ8pM2vK7nR4tB1yH6zJ3wL5sD9fG0aC2eN8uV4iT7o"

expires_in
integer
required
Example:

900

message_session_id
string
required
Example:

"7d1b4a90-2e63-4f18-bb27-1c9a0e4d7f52"

bootstrap_secret
string
required
success
boolean
default:true