StudioHomepage
ServicesCatalogHTTP APICommits

Read a commit

GET
/api/catalog/projects/{project_id}/commits/{commit_id}

Read one immutable commit. You must have permission to read the commits of the project.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Path Parameters

project_id*string

Owning project identifier. Nonempty, at most 128 UTF-8 bytes, with no control characters. Project creation belongs to the project service.

commit_id*string

Immutable UUIDv7 project commit identity.

Formatuuid

Response Body

Success

application/json
  1. response

Immutable commit and its canonical submitted changes. Parents are ordered first-parent first: genesis has none, ordinary commits have one, and merges have two. Assertions may be retained as read dependencies; they do not contribute mutation counts. Timestamps serialize as signed decimal strings.

actor*catalog.ActorId

Authenticated actor recorded by the service; callers cannot choose an actor. At most 128 UTF-8 bytes.

commitId*catalog.CommitId

Immutable UUIDv7 project commit identity.

Formatuuid
committedAtMicros*|
message?string|null
namespace*array<||>
parentCommitIds*array<>
resources*array<|||>
transactionId?|null
curl -X GET 'https://api.spiraldb.dev/api/catalog/projects/string/commits/497f6eca-6276-4993-bfeb-53cbbbba6f08'
{  "actor": "string",  "commitId": "a1b223ee-0195-4e35-9b2a-72c93f345117",  "committedAtMicros": "string",  "message": "string",  "namespace": [    {      "assert": {        "expected": "cc46ff75-488a-4f5d-9162-1798e46c1fcc",        "name": "string",        "parent": {          "prefix": {            "path": [              "string"            ],            "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6"          },          "type": "prefix"        }      },      "type": "assert"    }  ],  "parentCommitIds": [    "2a998c40-3602-476d-9578-67b2702f3d8f"  ],  "resources": [    {      "advance": {        "expected": "cc46ff75-488a-4f5d-9162-1798e46c1fcc",        "replacement": "0d5797a7-50c5-42e4-893d-e90cf0476063",        "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6"      },      "type": "advance"    }  ],  "transactionId": "75906707-8c31-479c-b354-aa805c4cefbc"}