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

Header Parameters

X-Nimbu-Site*

Site identifier

Typestring
Required

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,
"code": "string"
}

Playground

Authorization
Headers
Variables
Key
Value
Body

Samples

Part of Nimbu, built by Zenjoy.