Landed
Public APIUploads
POST
/api/v1/uploads

Authorization

publishableKey
AuthorizationBearer <token>

Workspace publishable key (wk_pub_...). You can also send X-Landed-Widget-Key instead of Authorization.

In: header

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/v1/uploads" \  -F file="string"
{  "storageRefId": "string",  "url": "http://example.com",  "contentType": "string",  "sizeBytes": 0}
{  "error": "string"}

Submit feedback

Creates or continues a widget conversation and appends a customer-visible message from the customer. Internal notes and conversation captures are never created or returned on this seam.

Verify local or production setup

Call this from your product (browser or same-origin frontend) after install so Landed can mark local or production setup complete. Classification uses the request `Origin` header. Do not set, spoof, or strip `Origin` — use browser defaults (most browsers send `Origin` automatically on cross-origin requests). Prefer `landed.ping()` from `@landedso/sdk` or widget `init` when using those integrations; use this endpoint directly for custom REST integrations.