Update an entry

Updates a channel entry. Non-master tokens must pass channel and entry update ACL checks. Public writes cannot publish entries directly; publication fields are normalized to draft for publishable channels. Master tokens bypass ACL unless use_acl=true and can update _acl, _owner, _status, and _publish_at.

Authorization

AuthorizationBearer <token>

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

In: header

X-Nimbu-Site<token>

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

In: header

Path Parameters

channel_id*string

Channel identifier

entry_id*string

Entry identifier

Query Parameters

use_acl?boolean

When true, applies customer ACL filtering to master-token requests.

Header Parameters

Session-Token?string

Customer session token used for channel and entry ACL filtering. X-Nimbu-Session-Token is also accepted.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

_acl?

_owner?string

_status?string

Publication state for publishable channels. Master-token writes can set it directly; public writes are normalized to draft.

Value in"draft" | "published" | "scheduled"

_publish_at?string

Publication datetime for scheduled entries in publishable channels.

Formatdate-time

[key: string]?any

Response Body

`application/json`

curl -X PUT "https://example.com/channels/string/entries/string" \  -H "Content-Type: application/json" \  -d '{}'

{
  "id": "string",
  "url": "http://example.com",
  "short_id": "string",
  "slug": "string",
  "channel": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "title_field_value": "string",
  "_status": "draft",
  "_publish_at": "2019-08-24T14:15:22Z",
  "_acl": {
    "property1": {
      "create": true,
      "read": true,
      "update": true,
      "delete": true
    },
    "property2": {
      "create": true,
      "read": true,
      "update": true,
      "delete": true
    }
  },
  "_owner": "string"
}