PostHog · Capability

PostHog API — notebooks

PostHog API — notebooks. 20 operations. Lead operation: notebooks. Self-contained Naftiko capability covering one Posthog business surface.

Run with Naftiko Posthognotebooks

What You Can Do

GET
Notebookslist — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks
POST
Notebookscreate — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks
GET
Notebooksallactivityretrieve — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/activity
GET
Notebooksrecordingcommentsretrieve — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/recording-comments
GET
Notebooksretrieve — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}
PUT
Notebooksupdate — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}
PATCH
Notebookspartialupdate — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}
DELETE
Notebooksdestroy — Hard delete of this model is not allowed. Use a patch API call to set "deleted" to true
/v1/api/projects/{project-id}/notebooks/{short-id}
GET
Notebooksactivityretrieve — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/activity
POST
Notebookscollabsavecreate — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/collab/save
GET
Notebookscollabstreamretrieve — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/collab/stream
POST
Notebookshogqlexecutecreate — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/hogql/execute
POST
Notebookskernelconfigcreate — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/kernel/config
GET
Notebookskerneldataframeretrieve — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/kernel/dataframe
POST
Notebookskernelexecutecreate — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/kernel/execute
POST
Notebookskernelexecutestreamcreate — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/kernel/execute/stream
POST
Notebookskernelrestartcreate — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/kernel/restart
POST
Notebookskernelstartcreate — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/kernel/start
GET
Notebookskernelstatusretrieve — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/kernel/status
POST
Notebookskernelstopcreate — The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.
/v1/api/projects/{project-id}/notebooks/{short-id}/kernel/stop

MCP Tools

api-interacting-notebooks-this-feature

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

read-only idempotent
api-interacting-notebooks-this-feature-2

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

api-interacting-notebooks-this-feature-3

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

read-only idempotent
api-interacting-notebooks-this-feature-4

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

read-only idempotent
api-interacting-notebooks-this-feature-5

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

read-only idempotent
api-interacting-notebooks-this-feature-6

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

idempotent
api-interacting-notebooks-this-feature-7

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

idempotent
hard-delete-this-model-is

Hard delete of this model is not allowed. Use a patch API call to set "deleted" to true

idempotent
api-interacting-notebooks-this-feature-8

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

read-only idempotent
api-interacting-notebooks-this-feature-9

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

api-interacting-notebooks-this-feature-10

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

read-only idempotent
api-interacting-notebooks-this-feature-11

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

api-interacting-notebooks-this-feature-12

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

api-interacting-notebooks-this-feature-13

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

read-only idempotent
api-interacting-notebooks-this-feature-14

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

api-interacting-notebooks-this-feature-15

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

api-interacting-notebooks-this-feature-16

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

api-interacting-notebooks-this-feature-17

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

api-interacting-notebooks-this-feature-18

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

read-only idempotent
api-interacting-notebooks-this-feature-19

The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes without announcement.

Capability Spec

posthog-notebooks.yaml Raw ↑
naftiko: 1.0.0-alpha2
info:
  label: PostHog API — notebooks
  description: 'PostHog API — notebooks. 20 operations. Lead operation: notebooks. Self-contained Naftiko capability covering
    one Posthog business surface.'
  tags:
  - Posthog
  - notebooks
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    POSTHOG_API_KEY: POSTHOG_API_KEY
capability:
  consumes:
  - type: http
    namespace: posthog-notebooks
    baseUri: ''
    description: PostHog API — notebooks business capability. Self-contained, no shared references.
    resources:
    - name: api-projects-project_id-notebooks
      path: /api/projects/{project_id}/notebooks/
      operations:
      - name: notebookslist
        method: GET
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: contains
          in: query
          type: string
          description: Filter for notebooks that match a provided filter.
        - name: created_by
          in: query
          type: string
          description: The UUID of the Notebook's creator
        - name: date_from
          in: query
          type: string
          description: Filter for notebooks created after this date & time
        - name: date_to
          in: query
          type: string
          description: Filter for notebooks created before this date & time
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
        - name: user
          in: query
          type: string
          description: If any value is provided for this parameter, return notebooks created by the logged in user.
      - name: notebookscreate
        method: POST
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-notebooks-activity
      path: /api/projects/{project_id}/notebooks/activity/
      operations:
      - name: notebooksallactivityretrieve
        method: GET
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-projects-project_id-notebooks-recording_comments
      path: /api/projects/{project_id}/notebooks/recording_comments/
      operations:
      - name: notebooksrecordingcommentsretrieve
        method: GET
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-projects-project_id-notebooks-short_id
      path: /api/projects/{project_id}/notebooks/{short_id}/
      operations:
      - name: notebooksretrieve
        method: GET
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
      - name: notebooksupdate
        method: PUT
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: notebookspartialupdate
        method: PATCH
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: notebooksdestroy
        method: DELETE
        description: Hard delete of this model is not allowed. Use a patch API call to set "deleted" to true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
    - name: api-projects-project_id-notebooks-short_id-activity
      path: /api/projects/{project_id}/notebooks/{short_id}/activity/
      operations:
      - name: notebooksactivityretrieve
        method: GET
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
    - name: api-projects-project_id-notebooks-short_id-collab-save
      path: /api/projects/{project_id}/notebooks/{short_id}/collab/save/
      operations:
      - name: notebookscollabsavecreate
        method: POST
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-notebooks-short_id-collab-stream
      path: /api/projects/{project_id}/notebooks/{short_id}/collab/stream/
      operations:
      - name: notebookscollabstreamretrieve
        method: GET
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
    - name: api-projects-project_id-notebooks-short_id-hogql-execute
      path: /api/projects/{project_id}/notebooks/{short_id}/hogql/execute/
      operations:
      - name: notebookshogqlexecutecreate
        method: POST
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-notebooks-short_id-kernel-config
      path: /api/projects/{project_id}/notebooks/{short_id}/kernel/config/
      operations:
      - name: notebookskernelconfigcreate
        method: POST
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-notebooks-short_id-kernel-dataframe
      path: /api/projects/{project_id}/notebooks/{short_id}/kernel/dataframe/
      operations:
      - name: notebookskerneldataframeretrieve
        method: GET
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
    - name: api-projects-project_id-notebooks-short_id-kernel-execute
      path: /api/projects/{project_id}/notebooks/{short_id}/kernel/execute/
      operations:
      - name: notebookskernelexecutecreate
        method: POST
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-notebooks-short_id-kernel-execute-stream
      path: /api/projects/{project_id}/notebooks/{short_id}/kernel/execute/stream/
      operations:
      - name: notebookskernelexecutestreamcreate
        method: POST
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-notebooks-short_id-kernel-restart
      path: /api/projects/{project_id}/notebooks/{short_id}/kernel/restart/
      operations:
      - name: notebookskernelrestartcreate
        method: POST
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-notebooks-short_id-kernel-start
      path: /api/projects/{project_id}/notebooks/{short_id}/kernel/start/
      operations:
      - name: notebookskernelstartcreate
        method: POST
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-notebooks-short_id-kernel-status
      path: /api/projects/{project_id}/notebooks/{short_id}/kernel/status/
      operations:
      - name: notebookskernelstatusretrieve
        method: GET
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
    - name: api-projects-project_id-notebooks-short_id-kernel-stop
      path: /api/projects/{project_id}/notebooks/{short_id}/kernel/stop/
      operations:
      - name: notebookskernelstopcreate
        method: POST
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: short_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: bearer
      token: '{{env.POSTHOG_API_KEY}}'
  exposes:
  - type: rest
    namespace: posthog-notebooks-rest
    port: 8080
    description: REST adapter for PostHog API — notebooks. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/api/projects/{project-id}/notebooks
      name: api-projects-project-id-notebooks
      description: REST surface for api-projects-project_id-notebooks.
      operations:
      - method: GET
        name: notebookslist
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookslist
        with:
          contains: rest.contains
          created_by: rest.created_by
          date_from: rest.date_from
          date_to: rest.date_to
          limit: rest.limit
          offset: rest.offset
          user: rest.user
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: notebookscreate
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookscreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/activity
      name: api-projects-project-id-notebooks-activity
      description: REST surface for api-projects-project_id-notebooks-activity.
      operations:
      - method: GET
        name: notebooksallactivityretrieve
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebooksallactivityretrieve
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/recording-comments
      name: api-projects-project-id-notebooks-recording-comments
      description: REST surface for api-projects-project_id-notebooks-recording_comments.
      operations:
      - method: GET
        name: notebooksrecordingcommentsretrieve
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebooksrecordingcommentsretrieve
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}
      name: api-projects-project-id-notebooks-short-id
      description: REST surface for api-projects-project_id-notebooks-short_id.
      operations:
      - method: GET
        name: notebooksretrieve
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebooksretrieve
        with:
          short_id: rest.short_id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: notebooksupdate
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebooksupdate
        with:
          short_id: rest.short_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: notebookspartialupdate
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookspartialupdate
        with:
          short_id: rest.short_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: notebooksdestroy
        description: Hard delete of this model is not allowed. Use a patch API call to set "deleted" to true
        call: posthog-notebooks.notebooksdestroy
        with:
          short_id: rest.short_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/activity
      name: api-projects-project-id-notebooks-short-id-activity
      description: REST surface for api-projects-project_id-notebooks-short_id-activity.
      operations:
      - method: GET
        name: notebooksactivityretrieve
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebooksactivityretrieve
        with:
          short_id: rest.short_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/collab/save
      name: api-projects-project-id-notebooks-short-id-collab-save
      description: REST surface for api-projects-project_id-notebooks-short_id-collab-save.
      operations:
      - method: POST
        name: notebookscollabsavecreate
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookscollabsavecreate
        with:
          short_id: rest.short_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/collab/stream
      name: api-projects-project-id-notebooks-short-id-collab-stream
      description: REST surface for api-projects-project_id-notebooks-short_id-collab-stream.
      operations:
      - method: GET
        name: notebookscollabstreamretrieve
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookscollabstreamretrieve
        with:
          short_id: rest.short_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/hogql/execute
      name: api-projects-project-id-notebooks-short-id-hogql-execute
      description: REST surface for api-projects-project_id-notebooks-short_id-hogql-execute.
      operations:
      - method: POST
        name: notebookshogqlexecutecreate
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookshogqlexecutecreate
        with:
          short_id: rest.short_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/kernel/config
      name: api-projects-project-id-notebooks-short-id-kernel-config
      description: REST surface for api-projects-project_id-notebooks-short_id-kernel-config.
      operations:
      - method: POST
        name: notebookskernelconfigcreate
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookskernelconfigcreate
        with:
          short_id: rest.short_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/kernel/dataframe
      name: api-projects-project-id-notebooks-short-id-kernel-dataframe
      description: REST surface for api-projects-project_id-notebooks-short_id-kernel-dataframe.
      operations:
      - method: GET
        name: notebookskerneldataframeretrieve
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookskerneldataframeretrieve
        with:
          short_id: rest.short_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/kernel/execute
      name: api-projects-project-id-notebooks-short-id-kernel-execute
      description: REST surface for api-projects-project_id-notebooks-short_id-kernel-execute.
      operations:
      - method: POST
        name: notebookskernelexecutecreate
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookskernelexecutecreate
        with:
          short_id: rest.short_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/kernel/execute/stream
      name: api-projects-project-id-notebooks-short-id-kernel-execute-stream
      description: REST surface for api-projects-project_id-notebooks-short_id-kernel-execute-stream.
      operations:
      - method: POST
        name: notebookskernelexecutestreamcreate
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookskernelexecutestreamcreate
        with:
          short_id: rest.short_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/kernel/restart
      name: api-projects-project-id-notebooks-short-id-kernel-restart
      description: REST surface for api-projects-project_id-notebooks-short_id-kernel-restart.
      operations:
      - method: POST
        name: notebookskernelrestartcreate
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookskernelrestartcreate
        with:
          short_id: rest.short_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/kernel/start
      name: api-projects-project-id-notebooks-short-id-kernel-start
      description: REST surface for api-projects-project_id-notebooks-short_id-kernel-start.
      operations:
      - method: POST
        name: notebookskernelstartcreate
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookskernelstartcreate
        with:
          short_id: rest.short_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/kernel/status
      name: api-projects-project-id-notebooks-short-id-kernel-status
      description: REST surface for api-projects-project_id-notebooks-short_id-kernel-status.
      operations:
      - method: GET
        name: notebookskernelstatusretrieve
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookskernelstatusretrieve
        with:
          short_id: rest.short_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/notebooks/{short-id}/kernel/stop
      name: api-projects-project-id-notebooks-short-id-kernel-stop
      description: REST surface for api-projects-project_id-notebooks-short_id-kernel-stop.
      operations:
      - method: POST
        name: notebookskernelstopcreate
        description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking
          changes without announcement.
        call: posthog-notebooks.notebookskernelstopcreate
        with:
          short_id: rest.short_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: posthog-notebooks-mcp
    port: 9090
    transport: http
    description: MCP adapter for PostHog API — notebooks. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: api-interacting-notebooks-this-feature
      description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes
        without announcement.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-notebooks.notebookslist
      with:
        contains: tools.contains
        created_by: tools.created_by
        date_from: tools.date_from
        date_to: tools.date_to
        limit: tools.limit
        offset: tools.offset
        user: tools.user
      outputParameters:
      - type: object
        mapping: $.
    - name: api-interacting-notebooks-this-feature-2
      description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes
        without announcement.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-notebooks.notebookscreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: api-interacting-notebooks-this-feature-3
      description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes
        without announcement.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-notebooks.notebooksallactivityretrieve
      outputParameters:
      - type: object
        mapping: $.
    - name: api-interacting-notebooks-this-feature-4
      description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes
        without announcement.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-notebooks.notebooksrecordingcommentsretrieve
      outputParameters:
      - type: object
        mapping: $.
    - name: api-interacting-notebooks-this-feature-5
      description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes
        without announcement.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-notebooks.notebooksretrieve
      with:
        short_id: tools.short_id
      outputParameters:
      - type: object
        mapping: $.
    - name: api-interacting-notebooks-this-feature-6
      description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes
        without announcement.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-notebooks.notebooksupdate
      with:
        short_id: tools.short_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: api-interacting-notebooks-this-feature-7
      description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes
        without announcement.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-notebooks.notebookspartialupdate
      with:
        short_id: tools.short_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: hard-delete-this-model-is
      description: Hard delete of this model is not allowed. Use a patch API call to set "deleted" to true
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: posthog-notebooks.notebooksdestroy
      with:
        short_id: tools.short_id
      outputParameters:
      - type: object
        mapping: $.
    - name: api-interacting-notebooks-this-feature-8
      description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes
        without announcement.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-notebooks.notebooksactivityretrieve
      with:
        short_id: tools.short_id
      outputParameters:
      - type: object
        mapping: $.
    - name: api-interacting-notebooks-this-feature-9
      description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes
        without announcement.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-notebooks.notebookscollabsavecreate
      with:
        short_id: tools.short_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: api-interacting-notebooks-this-feature-10
      description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes
        without announcement.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-notebooks.notebookscollabstreamretrieve
      with:
        short_id: tools.short_id
      outputParameters:
      - type: object
        mapping: $.
    - name: api-interacting-notebooks-this-feature-11
      description: The API for interacting with Notebooks. This feature is in early access and the API can have breaking changes
        without announcement.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-notebooks.notebookshogqlexecutecreate
      with:
        short_id: tools.short_id
        body: tools.body
      outp

# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/posthog/refs/heads/main/capabilities/posthog-notebooks.yaml