Skip to content
DocumentationAPI ReferenceChangelog
API ReferenceTalon Studio v1.0.2-beta

Change Requests

List a workspace's Git-backed change requests.

List change requests

GET/api/v1/change-requestschange_requests:read

List every change request in a workspace, in every status, most recently updated first.

Query parameters
workspaceIdstring (UUID)
Required with an org-scoped token; a workspace-bound token uses its own workspace.
Response
idstring (UUID)
titlestring
statusstring
draft | open | approved | merged | closed
authorstring · nullable
The name recorded for the person who opened it. For a proposal made through the API, the token owner's display name.
filesinteger
Number of files changed.
updatedAtstring (ISO 8601)
Returned as { data: [...] }. There is no status filter and no cap — filter on status client-side. Proposals made with POST /detections are titled "API: <name>"; edits made with PATCH /detections/{id} are titled "API: updated <name>".
Request
curl -H "Authorization: Bearer tlk_…" \
  "https://<your-instance>/api/v1/change-requests?workspaceId=…"
Response
{
  "data": [
    {
      "id": "1a2b3c4d-5e6f-4a70-8b90-0c1d2e3f4a5b",
      "title": "Add Okta MFA fatigue detection",
      "status": "open",
      "author": "Jane Doe",
      "files": 3,
      "updatedAt": "2026-06-30T14:22:10.000Z"
    },
    {
      "id": "4d5e6f70-8a9b-4c1d-9e2f-3a4b5c6d7e8f",
      "title": "API: Suspicious PowerShell",
      "status": "draft",
      "author": "Sam Lee",
      "files": 1,
      "updatedAt": "2026-06-28T09:11:02.000Z"
    }
  ]
}