Skip to content

Create or update an asset​

POST
/themes/{theme_id}/assets

Authorizations​

bearerToken|siteContext
bearerToken

Personal access token tied to a user account. Requires the X-Nimbu-Site header to scope requests.

TypeHTTP (bearer)
+
siteContext

Identifier of the site context when authenticating with a personal access token.

TypeAPI Key (header: X-Nimbu-Site)
or
siteToken

Site-scoped API token that already encodes the site context.

TypeHTTP (bearer)

Parameters​

Path Parameters

theme_id*
Typestring
Required

Query Parameters

force

Force update when remote changes exist

Typeboolean

Request Body​

application/json
JSON
{
"name": "string",
"plain_text": "string",
"source": {
"__type": "string",
"filename": "string",
"content_type": "string",
"attachment": "string"
}
}

Responses​

asset created

application/json
JSON
{
"id": "string",
"url": "string",
"permalink": "string",
"public_url": "string",
"name": "string",
"folder": "string",
"path": "string",
"created_at": "string",
"updated_at": "string",
"changed_by": {
},
"changed_live": true
}

Playground​

Authorization
Variables
Key
Value
Body

Samples​