Skip to main content
Retrieve a composition version

Authorizations

Authorization
string
header
required

A Tightknit admin API key, sent as Authorization: Bearer <key>.

Path Parameters

composition_id
string
required

The composition's id.

Pattern: ^cmps_[a-zA-Z0-9]{12}$
version_id
string
required

The composition version's id.

Pattern: ^cpvr_[a-zA-Z0-9]{12}$

Query Parameters

expand

Repeatable. Returns the named relation inline. One of: created_by.

Available options:
created_by

Response

Success

object
enum<string>
required

Always composition_version.

Available options:
composition_version
id
string
required

Unique identifier for the object.

Example:

"cpvr_5t1w8y3z6b2c"

created_at
string<date-time>
required

When this version was recorded.

composition_id
string
required

The id of the composition this is a version of.

Example:

"cmps_7h2k9m4n1p6q"

version_number
integer
required

Its number among the composition’s versions, counting from 1 and never reused.

Required range: x >= 1
label
string
required

The composition’s name as of this version.

version_label
string | null
required

The name a Studio user gave this version. Null for an unnamed one.

blocks
object[]
required

The message as this version held it.

source
enum<string>
required

What recorded it. One of:

  • manual_save: a deliberate save, including every save through the API.
  • autosave_checkpoint: Studio keeping an editing session’s content.
  • pre_delivery: the content a send went out with.
  • restore: an earlier version brought back.
Available options:
autosave_checkpoint,
manual_save,
pre_delivery,
restore
created_via
enum<string>
required

The surface its content was written through. One of:

  • studio: Tightknit Studio.
  • admin_api: this API.
  • mcp: the Tightknit MCP server.
Available options:
studio,
admin_api,
mcp
created_by_id
string | null
required

The id of the profile whose content it is. Null when an API key wrote it, or once that profile is deleted.

created_by
object | null

The profile whose content it is. Present only when created_by is expanded.