Events

An event records one change in a workspace, such as a role change, a new invite or a ticket update, and who made it: a person, an agent acting for a person, or an account API key.

The Event object

One change in the workspace and who made it.

Attributes

idstringRequired

Unique ID of the event.

typestringRequired

What happened, as subject.action, such as ticket.created.

One ofworkspace.createdworkspace.updatedworkspace.icon_updatedmember.role_changedmember.removedmember.auto_joinedinvite.createdinvite.role_changedinvite.resentinvite.revokedinvite.acceptedteam.createdteam.updatedteam.member_addedteam.member_removedteam.archivedteam.restoredteam.deletedproject.createdproject.updatedproject.archivedproject.restoredmilestone.createdmilestone.updatedmilestone.deletedticket.createdticket.updatedticket.movedtag.createdtag.updatedtag.deletedticket_status.createdticket_status.updatedticket_status.deletedview.createdview.updatedview.deletedagent_instructions.updatedagent_instructions.resetagent.registeredagent.revokedagent_message.sentagent_message.completedticket.commentedproduct.createdproduct.updatedproduct.archivedproduct.restoredenvironment.createdenvironment.updatedenvironment.archivedenvironment.restoreddeployment.createddeployment.updateddeployment.removedprofile.updated

subjectTypenullable stringRequired

What the event is about, such as user, invite, workspace or ticket, or null.

subjectIdnullable stringRequired

The ID of what the event is about, or null.

metadataobjectRequired

Details recorded with the event, such as the ticket's identifier and title. The fields depend on the type.

createdAtstringRequired

When it happened, as an ISO 8601 timestamp.

actorUserIdnullable stringRequired

The user ID of the person who made the change, or the person an agent acted for. Null when an account API key made it.

actorAccountKeyIdnullable stringRequired

The ID of the account API key that made the change, or null.

actorAgentAuthorizationIdnullable stringRequired

The ID of the registered agent that made the change for the person, or null.

actorNamenullable stringRequired

The name of the person who made the change, or the person an agent acted for. Null when an account API key made it.

actorEmailnullable stringRequired

That person's email address, or null.

agentNamenullable stringRequired

The agent that made the change for the person, such as Codex, or null.

The Event object

{  "id": "Ev4NpL7wQs2X",  "type": "ticket.created",  "subjectType": "ticket",  "subjectId": "Tk7BnC5xLp9M",  "metadata": {    "identifier": "WEB-31",    "title": "Add docs search"  },  "createdAt": "2026-10-14T09:05:12.000Z",  "actorUserId": "Us3NfP8kLq2V",  "actorAccountKeyId": null,  "actorAgentAuthorizationId": "Ag5HvB1mZr8K",  "actorName": "Maya Patel",  "actorEmail": "maya@acme.dev",  "agentName": "Codex"}

List events

GET/v1/workspaces/{slug}/events

Returns the workspace's 50 most recent events, newest first. Any member can list events.

Path parameters

slugstringRequired

The workspace's slug or ID, such as acme.

Returns

Returns an array of Event objects. Status 200.

Errors

400: InvalidInputThe request is malformed, or a value is not allowed.
401: UnauthorizedThe request has no valid API key.
403: ForbiddenThe key's user or role may not do this.
404: NotFoundThe workspace or object does not exist, or the caller cannot see it.
409: ConflictThe change conflicts with current data, such as a slug that is already in use.
500: InternalClanker Ship failed to handle the request. Retry, or report the response's x-request-id.

GET/v1/workspaces/{slug}/events

1curl https://api.qa.clankership.net/v1/workspaces/acme/events \2  -H "Authorization: Bearer $CLANKER_API_KEY"

Response200

[  {    "id": "Ev4NpL7wQs2X",    "type": "ticket.created",    "subjectType": "ticket",    "subjectId": "Tk7BnC5xLp9M",    "metadata": {      "identifier": "WEB-31",      "title": "Add docs search"    },    "createdAt": "2026-10-14T09:05:12.000Z",    "actorUserId": "Us3NfP8kLq2V",    "actorAccountKeyId": null,    "actorAgentAuthorizationId": "Ag5HvB1mZr8K",    "actorName": "Maya Patel",    "actorEmail": "maya@acme.dev",    "agentName": "Codex"  }]

NextAccount API keys