Skip to main content
POST
/
v1
/
embed
/
form-submit
/
{sessionId}
/
upload-image
Upload a form image
curl --request POST \
  --url https://api.craftkit.dev/v1/embed/form-submit/{sessionId}/upload-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'
{
  "url": "https://cdn.craftkit.dev/embed-uploads/proj/sess/abc.png"
}

Authorizations

​
Authorization
string
header
required

Short-lived embed session JWT minted by POST /v1/embed/sessions. Used by the iframe form-submit / upload-image endpoints and accepted (alongside a partner key) by builder template creation.

Path Parameters

​
sessionId
string<uuid>
required

The embed session id (must match the JWT subject).

Body

multipart/form-data
​
file
file
required

The image file (image/* only, max 10 MB).

Response

Uploaded.

​
url
string<uri>
required