Update a Notebook Block

ExperimentalThis API is under active development and may change.

PUT /api/0/organizations/{organization_id_or_slug}/notebooks/{notebook_id}/blocks/{block_id}/

Update at least one of title, content, generationPrompt, config, or display. Send both notebook and block versions. The block kind cannot change. Returns the updated block. Requires a user or service account. Requires the organizations:investigations feature and open organization membership.

Path Parameters

organization_id_or_slug (string) REQUIRED: The ID or slug of the organization the resource belongs to.
notebook_id (string) REQUIRED: The ID of an investigation in this organization.
block_id (string) REQUIRED: The ID of an active block in this investigation.

Body Parameters

notebookVersion (integer) REQUIRED: Current notebook version from the latest detail response. Stale versions return 409.
version (integer) REQUIRED: Current block version from the latest block response. Stale versions return 409.
title (string): Block title. May be empty.
content (string): User-authored content. May be empty.
generationPrompt (string): Instructions used when executing the block. May be empty.
config (object): Block configuration object. Nested keys are preserved.
display (object): Display settings. Text uses type markdown; query uses table, line, bar, or area. Versioned settings use version 1. Charts require xAxis and non-empty yAxes. Defaults to Markdown for text and table for query.

Scopes

You need to authenticate via bearer auth token.

<auth_token> requires one of the following scopes:

org:admin
org:read
org:write

Copied

curl https://sentry.io/api/0/organizations/{organization_id_or_slug}/notebooks/{notebook_id}/blocks/{block_id}/ \
 -H 'Authorization: Bearer <auth_token>' \
 -X PUT \
 -H 'Content-Type: application/json' \
 -d '{}'

RESPONSESCHEMA

Copied
{
  "id": "12",
  "position": 0,
  "kind": "text",
  "title": "Summary",
  "content": "Checkout latency rose after the 2.4.0 release.",
  "generationPrompt": "",
  "generatedContent": "Checkout latency rose after the 2.4.0 release.",
  "output": {
    "schemaVersion": 1,
    "markdown": "Checkout latency rose after the 2.4.0 release."
  },
  "outputStatus": "available",
  "currentExecution": {
    "id": "40",
    "status": "completed",
    "executor": "code_mode",
    "schemaVersion": 1,
    "startedAt": "2026-11-10T18:00:00.000000Z",
    "completedAt": "2026-11-10T18:00:00.000000Z",
    "error": null
  },
  "config": {},
  "display": {
    "type": "markdown"
  },
  "dependencies": [],
  "parameterKeys": [],
  "version": 1,
  "staleAt": null,
  "createdBy": null,
  "lastEditedBy": null,
  "producerKey": "summary",
  "producerRevision": 1
}

Was this helpful?