AI observability
dataset_items

Create a new immutable item version from editable fields.

patch/api/projects/{project_id}/dataset_items/{dataset_item_id}/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/dataset_items/{dataset_item_id}/
  • Auth: HTTP bearer

Path parameters

dataset_item_idstring uuid required
project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Request body

base_versioninteger required

Current item version observed by the caller.

metadataobject

Replacement metadata object. Send an empty object to clear it.

Response

idstring uuid required

Stable dataset item ID shared by every version.

datasetstring uuid required

Dataset that owns the item.

client_item_idstring nullable required

Optional caller-owned stable key that cannot be changed.

versioninteger required
version_idstring uuid required

ID of this immutable item version.

dataset_revisioninteger required

Dataset revision that introduced this item version.

dataset_revision_idstring uuid required

ID of the dataset revision that introduced this item version.

archivedboolean required
metadataobject required

JSON object with item metadata.

source_trace_idstring nullable required
source_event_idstring nullable required
source_timestampstring date-time nullable required
created_atstring date-time required

When the stable item was created.

updated_atstring date-time nullable required

When the item last received a new version.

version_created_atstring date-time required

When this immutable version was created.

team_idinteger required

Project that owns the item.

Changes

No recorded changes to this operation across all 1 revision of this API.