StudioHomepage
ServicesCatalogHTTP APIBranch history

Read a branch event

GET
/api/catalog/projects/{project_id}/branch-events/{event_id}

Read one immutable branch event. You must have permission to read the branch history 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.

event_id*string

Immutable UUIDv7 branch event identity.

Formatuuid

Response Body

Success

application/json
  1. response

Immutable branch event. Optional fields describe the operation; previousBranchEventId links events for the same stable branch identity.

actor*catalog.ActorId

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

branchEventId*catalog.BranchEventId

Immutable UUIDv7 branch event identity.

Formatuuid
branchId*catalog.BranchId

Stable UUIDv7 branch identity. Rename preserves identity; deletion tombstones it.

Formatuuid
message?string|null
newCommitId?|null
newName?|null
occurredAtMicros*|
oldCommitId?|null
oldName?|null
operation*catalog.BranchEventOperation

Branch identity lifecycle and head movement. Client responses retain unknown future operation values.

Value in"create""advance""merge""rename""delete"
previousBranchEventId?|null
transactionId?|null
curl -X GET 'https://api.spiraldb.dev/api/catalog/projects/string/branch-events/497f6eca-6276-4993-bfeb-53cbbbba6f08'
{  "actor": "string",  "branchEventId": "652c6cb3-38b8-46ef-8926-780723491e40",  "branchId": "712f308d-801e-48bc-b072-9c404734ceb7",  "message": "string",  "newCommitId": "13517670-88c3-4c6a-a869-3a07050599df",  "newName": "string",  "occurredAtMicros": "string",  "oldCommitId": "bf8dd278-3b22-4584-82a5-b50b07acd157",  "oldName": "string",  "operation": "create",  "previousBranchEventId": "bc9045a0-48a1-4c4c-87b2-295e480fbf76",  "transactionId": "75906707-8c31-479c-b354-aa805c4cefbc"}