# Tracecat Docs: API Reference

## API Reference

### Core concepts

- [Authentication](https://docs.tracecat.com/api-reference/authentication.md): Authenticate Tracecat REST API requests with a service account API key.

### Endpoints

#### public

- [Incoming Webhook Get](https://docs.tracecat.com/api-reference/public/incoming-webhook-get.md): Webhook endpoint to trigger a workflow.
- [Incoming Webhook Post](https://docs.tracecat.com/api-reference/public/incoming-webhook-post.md): Webhook endpoint to trigger a workflow.
- [Incoming Webhook Wait](https://docs.tracecat.com/api-reference/public/incoming-webhook-wait.md): Webhook endpoint to trigger a workflow.
- [Incoming Webhook Draft](https://docs.tracecat.com/api-reference/public/incoming-webhook-draft.md): Draft webhook endpoint to trigger a workflow execution using the draft workflow graph.
- [Receive Interaction](https://docs.tracecat.com/api-reference/public/receive-interaction.md): Process incoming workflow interactions from external services.
- [Handle Channel Event](https://docs.tracecat.com/api-reference/public/handle-channel-event.md): Receive public external channel events.
- [Handle Slack Oauth Callback](https://docs.tracecat.com/api-reference/public/handle-slack-oauth-callback.md)
- [Check Health](https://docs.tracecat.com/api-reference/public/check-health.md)

#### workspaces

- [List Workspaces](https://docs.tracecat.com/api-reference/workspaces/list-workspaces.md): List workspaces the user has access to.
- [Create Workspace](https://docs.tracecat.com/api-reference/workspaces/create-workspace.md): Create a new workspace.
- [Search Workspaces](https://docs.tracecat.com/api-reference/workspaces/search-workspaces.md): Return Workflow as title, description, list of Action JSONs, adjacency list of Action IDs.
- [Get Workspace](https://docs.tracecat.com/api-reference/workspaces/get-workspace.md): Return Workflow as title, description, list of Action JSONs, adjacency list of Action IDs.
- [Delete Workspace](https://docs.tracecat.com/api-reference/workspaces/delete-workspace.md): Delete a workspace.
- [Update Workspace](https://docs.tracecat.com/api-reference/workspaces/update-workspace.md): Update a workspace.
- [List Workspace Members](https://docs.tracecat.com/api-reference/workspaces/list-workspace-members.md): List members of a workspace.
- [List Workspace Memberships](https://docs.tracecat.com/api-reference/workspaces/list-workspace-memberships.md): List memberships of a workspace.
- [Create Workspace Membership](https://docs.tracecat.com/api-reference/workspaces/create-workspace-membership.md): Create a workspace membership for a user.
- [Get Workspace Membership](https://docs.tracecat.com/api-reference/workspaces/get-workspace-membership.md): Get a workspace membership for a user.
- [Delete Workspace Membership](https://docs.tracecat.com/api-reference/workspaces/delete-workspace-membership.md): Delete a workspace membership.
- [List Workspace Invitations](https://docs.tracecat.com/api-reference/workspaces/list-workspace-invitations.md): List workspace invitations.
- [Create Workspace Invitation](https://docs.tracecat.com/api-reference/workspaces/create-workspace-invitation.md): Create a workspace invitation.
- [Revoke Workspace Invitation](https://docs.tracecat.com/api-reference/workspaces/revoke-workspace-invitation.md): Revoke a workspace invitation.

#### service_accounts

- [List Workspace Service Accounts](https://docs.tracecat.com/api-reference/service_accounts/list-workspace-service-accounts.md)
- [Create Workspace Service Account](https://docs.tracecat.com/api-reference/service_accounts/create-workspace-service-account.md)
- [List Workspace Service Account Scopes](https://docs.tracecat.com/api-reference/service_accounts/list-workspace-service-account-scopes.md)
- [Get Workspace Service Account](https://docs.tracecat.com/api-reference/service_accounts/get-workspace-service-account.md)
- [Update Workspace Service Account](https://docs.tracecat.com/api-reference/service_accounts/update-workspace-service-account.md)
- [List Workspace Service Account Api Keys](https://docs.tracecat.com/api-reference/service_accounts/list-workspace-service-account-api-keys.md)
- [Create Workspace Service Account Api Key](https://docs.tracecat.com/api-reference/service_accounts/create-workspace-service-account-api-key.md)
- [Disable Workspace Service Account](https://docs.tracecat.com/api-reference/service_accounts/disable-workspace-service-account.md)
- [Enable Workspace Service Account](https://docs.tracecat.com/api-reference/service_accounts/enable-workspace-service-account.md)
- [Revoke Workspace Service Account Api Key](https://docs.tracecat.com/api-reference/service_accounts/revoke-workspace-service-account-api-key.md)
- [List Organization Service Accounts](https://docs.tracecat.com/api-reference/service_accounts/list-organization-service-accounts.md)
- [Create Organization Service Account](https://docs.tracecat.com/api-reference/service_accounts/create-organization-service-account.md)
- [List Organization Service Account Scopes](https://docs.tracecat.com/api-reference/service_accounts/list-organization-service-account-scopes.md)
- [Get Organization Service Account](https://docs.tracecat.com/api-reference/service_accounts/get-organization-service-account.md)
- [Update Organization Service Account](https://docs.tracecat.com/api-reference/service_accounts/update-organization-service-account.md)
- [List Organization Service Account Api Keys](https://docs.tracecat.com/api-reference/service_accounts/list-organization-service-account-api-keys.md)
- [Create Organization Service Account Api Key](https://docs.tracecat.com/api-reference/service_accounts/create-organization-service-account-api-key.md)
- [Disable Organization Service Account](https://docs.tracecat.com/api-reference/service_accounts/disable-organization-service-account.md)
- [Enable Organization Service Account](https://docs.tracecat.com/api-reference/service_accounts/enable-organization-service-account.md)
- [Revoke Organization Service Account Api Key](https://docs.tracecat.com/api-reference/service_accounts/revoke-organization-service-account-api-key.md)

#### mcp_personal_access_tokens

- [List Mcp Personal Access Tokens](https://docs.tracecat.com/api-reference/mcp_personal_access_tokens/list-mcp-personal-access-tokens.md)
- [Create Mcp Personal Access Token](https://docs.tracecat.com/api-reference/mcp_personal_access_tokens/create-mcp-personal-access-token.md)
- [Revoke Mcp Personal Access Token](https://docs.tracecat.com/api-reference/mcp_personal_access_tokens/revoke-mcp-personal-access-token.md)

#### workflows

- [List Workflows](https://docs.tracecat.com/api-reference/workflows/list-workflows.md): List workflows.
- [Create Workflow](https://docs.tracecat.com/api-reference/workflows/create-workflow.md): Create a new Workflow.
- [Validate Workflow Entrypoint](https://docs.tracecat.com/api-reference/workflows/validate-workflow-entrypoint.md): Validate a workflow entrypoint expects definition.
- [Get Workflow](https://docs.tracecat.com/api-reference/workflows/get-workflow.md): Return Workflow as title, description, list of Action JSONs, adjacency list of Action IDs.
- [Delete Workflow](https://docs.tracecat.com/api-reference/workflows/delete-workflow.md): Delete a workflow.
- [Update Workflow](https://docs.tracecat.com/api-reference/workflows/update-workflow.md): Update a workflow.
- [Commit Workflow](https://docs.tracecat.com/api-reference/workflows/commit-workflow.md): Commit a workflow.
- [Export Workflow](https://docs.tracecat.com/api-reference/workflows/export-workflow.md): Export a workflow's current state and optionally its definitions and logs.
- [List Workflow Definitions](https://docs.tracecat.com/api-reference/workflows/list-workflow-definitions.md): List all workflow definitions for a Workflow.
- [Restore Workflow Definition](https://docs.tracecat.com/api-reference/workflows/restore-workflow-definition.md): Restore a saved workflow definition as the current published version.
- [Get Workflow Definition](https://docs.tracecat.com/api-reference/workflows/get-workflow-definition.md): Get the latest version of a workflow definition.
- [Create Workflow Definition](https://docs.tracecat.com/api-reference/workflows/create-workflow-definition.md): Get the latest version of a workflow definition.
- [Move Workflow To Folder](https://docs.tracecat.com/api-reference/workflows/move-workflow-to-folder.md): Move a workflow to a different folder.
- [List Tags](https://docs.tracecat.com/api-reference/workflows/list-tags.md): List all tags for a workflow.
- [Add Tag](https://docs.tracecat.com/api-reference/workflows/add-tag.md): Add a tag to a workflow.
- [Remove Tag](https://docs.tracecat.com/api-reference/workflows/remove-tag.md)
- [Publish Workflow](https://docs.tracecat.com/api-reference/workflows/publish-workflow.md)
- [List Workflow Repositories](https://docs.tracecat.com/api-reference/workflows/list-workflow-repositories.md): List repositories granted to the configured GitHub App installation.
- [List Workflow Commits](https://docs.tracecat.com/api-reference/workflows/list-workflow-commits.md): Get commit list for the configured workspace repository.
- [List Workflow Branches](https://docs.tracecat.com/api-reference/workflows/list-workflow-branches.md): Get branch list for the configured workspace repository.
- [Export Workspace Sync](https://docs.tracecat.com/api-reference/workflows/export-workspace-sync.md): Export workspace workflow specs to a Git branch and optional PR.
- [Preview Export Workspace Sync](https://docs.tracecat.com/api-reference/workflows/preview-export-workspace-sync.md): Project which resources an export would commit, without writing to Git.
- [Pull Workflows](https://docs.tracecat.com/api-reference/workflows/pull-workflows.md): Pull workflows from Git repository at specific commit.

#### triggers

- [Get Webhook](https://docs.tracecat.com/api-reference/triggers/get-webhook.md): Get the webhook from a workflow.
- [Create Webhook](https://docs.tracecat.com/api-reference/triggers/create-webhook.md): Create a webhook for a workflow.
- [Update Webhook](https://docs.tracecat.com/api-reference/triggers/update-webhook.md): Update the webhook for a workflow. We currently supprt only one webhook per workflow.
- [Get Case Trigger](https://docs.tracecat.com/api-reference/triggers/get-case-trigger.md): Get the case trigger configuration for a workflow.
- [Create Case Trigger](https://docs.tracecat.com/api-reference/triggers/create-case-trigger.md): Create or replace the case trigger configuration for a workflow.
- [Update Case Trigger](https://docs.tracecat.com/api-reference/triggers/update-case-trigger.md): Update the case trigger configuration for a workflow.
- [Generate Webhook Api Key](https://docs.tracecat.com/api-reference/triggers/generate-webhook-api-key.md): Create or rotate the API key for a webhook.
- [Delete Webhook Api Key](https://docs.tracecat.com/api-reference/triggers/delete-webhook-api-key.md): Delete the current API key for a webhook.
- [Revoke Webhook Api Key](https://docs.tracecat.com/api-reference/triggers/revoke-webhook-api-key.md): Revoke the current API key for a webhook.

#### workflow-executions

- [Get Workflow Execution By Workflow Id](https://docs.tracecat.com/api-reference/workflow-executions/get-workflow-execution-by-workflow-id.md): Get a workflow execution by workflow ID and execution suffix.
- [List Workflow Executions](https://docs.tracecat.com/api-reference/workflow-executions/list-workflow-executions.md): List all workflow executions.
- [Create Workflow Execution](https://docs.tracecat.com/api-reference/workflow-executions/create-workflow-execution.md): Create and schedule a workflow execution.
- [Search Workflow Executions](https://docs.tracecat.com/api-reference/workflow-executions/search-workflow-executions.md)
- [List Workflow Execution Reset Points](https://docs.tracecat.com/api-reference/workflow-executions/list-workflow-execution-reset-points.md)
- [Reset Workflow Execution](https://docs.tracecat.com/api-reference/workflow-executions/reset-workflow-execution.md)
- [Bulk Reset Workflow Executions](https://docs.tracecat.com/api-reference/workflow-executions/bulk-reset-workflow-executions.md)
- [Get Workflow Execution](https://docs.tracecat.com/api-reference/workflow-executions/get-workflow-execution.md): Get a workflow execution.
- [Get Workflow Execution Compact](https://docs.tracecat.com/api-reference/workflow-executions/get-workflow-execution-compact.md): Get a workflow execution.
- [Get Workflow Execution Object Download](https://docs.tracecat.com/api-reference/workflow-executions/get-workflow-execution-object-download.md): Generate a presigned download URL for a workflow execution result object.
- [Get Workflow Execution Object Preview](https://docs.tracecat.com/api-reference/workflow-executions/get-workflow-execution-object-preview.md): Fetch a bounded text preview for a workflow execution result object.
- [Get Workflow Execution Collection Page](https://docs.tracecat.com/api-reference/workflow-executions/get-workflow-execution-collection-page.md): Fetch a bounded page of collection item descriptors.
- [Create Draft Workflow Execution](https://docs.tracecat.com/api-reference/workflow-executions/create-draft-workflow-execution.md): Create and schedule a draft workflow execution.
- [Cancel Workflow Execution](https://docs.tracecat.com/api-reference/workflow-executions/cancel-workflow-execution.md): Get a workflow execution.
- [Terminate Workflow Execution](https://docs.tracecat.com/api-reference/workflow-executions/terminate-workflow-execution.md): Get a workflow execution.

#### graph

- [Get Graph](https://docs.tracecat.com/api-reference/graph/get-graph.md): Get the canonical graph projection for a workflow.
- [Apply Graph Operations](https://docs.tracecat.com/api-reference/graph/apply-graph-operations.md): Apply graph operations with optimistic concurrency.

#### actions

- [Batch Update Positions](https://docs.tracecat.com/api-reference/actions/batch-update-positions.md): Batch update action and trigger positions.
- [List Actions](https://docs.tracecat.com/api-reference/actions/list-actions.md): List all actions for a workflow.
- [Create Action](https://docs.tracecat.com/api-reference/actions/create-action.md): Create a new action for a workflow.
- [Get Action](https://docs.tracecat.com/api-reference/actions/get-action.md): Get an action.
- [Update Action](https://docs.tracecat.com/api-reference/actions/update-action.md): Update an action.
- [Delete Action](https://docs.tracecat.com/api-reference/actions/delete-action.md): Delete an action.

#### secrets

- [Search Secrets](https://docs.tracecat.com/api-reference/secrets/search-secrets.md): Search secrets.
- [List Secrets](https://docs.tracecat.com/api-reference/secrets/list-secrets.md): List user secrets.
- [Create Secret](https://docs.tracecat.com/api-reference/secrets/create-secret.md): Create a secret.
- [List Secret Definitions](https://docs.tracecat.com/api-reference/secrets/list-secret-definitions.md): List aggregated secret definitions from the registry.
- [Get Aws Assume Role Access](https://docs.tracecat.com/api-reference/secrets/get-aws-assume-role-access.md): Get workspace-scoped AWS AssumeRole details for credential setup.
- [Get Secret By Name](https://docs.tracecat.com/api-reference/secrets/get-secret-by-name.md): Get a secret.
- [Update Secret By Id](https://docs.tracecat.com/api-reference/secrets/update-secret-by-id.md): Update a secret by ID.
- [Delete Secret By Id](https://docs.tracecat.com/api-reference/secrets/delete-secret-by-id.md): Delete a secret by ID.

#### variables

- [Search Variables](https://docs.tracecat.com/api-reference/variables/search-variables.md)
- [List Variables](https://docs.tracecat.com/api-reference/variables/list-variables.md)
- [Create Variable](https://docs.tracecat.com/api-reference/variables/create-variable.md)
- [Get Variable By Name](https://docs.tracecat.com/api-reference/variables/get-variable-by-name.md)
- [Update Variable By Id](https://docs.tracecat.com/api-reference/variables/update-variable-by-id.md)
- [Delete Variable By Id](https://docs.tracecat.com/api-reference/variables/delete-variable-by-id.md)

#### schedules

- [List Schedules](https://docs.tracecat.com/api-reference/schedules/list-schedules.md)
- [Create Schedule](https://docs.tracecat.com/api-reference/schedules/create-schedule.md): Create a schedule for a workflow.
- [Get Schedule](https://docs.tracecat.com/api-reference/schedules/get-schedule.md): Get a schedule from a workflow.
- [Update Schedule](https://docs.tracecat.com/api-reference/schedules/update-schedule.md): Update a schedule from a workflow. You cannot update the Workflow Definition, but you can update other fields.
- [Delete Schedule](https://docs.tracecat.com/api-reference/schedules/delete-schedule.md): Delete a schedule from a workflow.
- [Search Schedules](https://docs.tracecat.com/api-reference/schedules/search-schedules.md): **[WORK IN PROGRESS]** Search for schedules.

#### tags

- [List Tags](https://docs.tracecat.com/api-reference/tags/list-tags.md): List all tags for the current workspace.
- [Create Tag](https://docs.tracecat.com/api-reference/tags/create-tag.md): Create a new tag.
- [Get Tag](https://docs.tracecat.com/api-reference/tags/get-tag.md): Get a specific tag by ID.
- [Delete Tag](https://docs.tracecat.com/api-reference/tags/delete-tag.md): Delete a tag.
- [Update Tag](https://docs.tracecat.com/api-reference/tags/update-tag.md): Update an existing tag.

#### users

- [Search User](https://docs.tracecat.com/api-reference/users/search-user.md): Search for a user by email.
- [Get My Scopes](https://docs.tracecat.com/api-reference/users/get-my-scopes.md): Get the current user's effective scopes.
- [Users:Current User](https://docs.tracecat.com/api-reference/users/users:current-user.md)
- [Users:Patch Current User](https://docs.tracecat.com/api-reference/users/users:patch-current-user.md)
- [Users:User](https://docs.tracecat.com/api-reference/users/users:user.md)
- [Users:Delete User](https://docs.tracecat.com/api-reference/users/users:delete-user.md)
- [Users:Patch User](https://docs.tracecat.com/api-reference/users/users:patch-user.md)

#### organization

- [Get Organization](https://docs.tracecat.com/api-reference/organization/get-organization.md): Get the current organization.
- [Delete Organization](https://docs.tracecat.com/api-reference/organization/delete-organization.md): Delete the current organization.
- [List Current User Organization Memberships](https://docs.tracecat.com/api-reference/organization/list-current-user-organization-memberships.md): List active organizations the current user belongs to.
- [List Organization Domains](https://docs.tracecat.com/api-reference/organization/list-organization-domains.md): List domains assigned to the current organization.
- [Get Organization Entitlements](https://docs.tracecat.com/api-reference/organization/get-organization-entitlements.md): Get the effective entitlements for the current organization.
- [Get Current Org Member](https://docs.tracecat.com/api-reference/organization/get-current-org-member.md): Get the current user's organization membership.
- [List Org Members](https://docs.tracecat.com/api-reference/organization/list-org-members.md)
- [Delete Org Member](https://docs.tracecat.com/api-reference/organization/delete-org-member.md)
- [Update Org Member](https://docs.tracecat.com/api-reference/organization/update-org-member.md)
- [List Sessions](https://docs.tracecat.com/api-reference/organization/list-sessions.md)
- [Delete Session](https://docs.tracecat.com/api-reference/organization/delete-session.md)
- [List Invitations](https://docs.tracecat.com/api-reference/organization/list-invitations.md): List invitations for the organization.
- [Create Invitation](https://docs.tracecat.com/api-reference/organization/create-invitation.md): Create an invitation to join the organization.
- [Revoke Invitation](https://docs.tracecat.com/api-reference/organization/revoke-invitation.md): Revoke a pending invitation.
- [Get Invitation Token](https://docs.tracecat.com/api-reference/organization/get-invitation-token.md): Get the token for a specific invitation (admin only).
- [Accept Invitation](https://docs.tracecat.com/api-reference/organization/accept-invitation.md): Accept an invitation and join the organization.
- [List My Pending Invitations](https://docs.tracecat.com/api-reference/organization/list-my-pending-invitations.md): List pending, unexpired invitations for the authenticated user.
- [Get Invitation By Token](https://docs.tracecat.com/api-reference/organization/get-invitation-by-token.md): Get minimal invitation details by token (public endpoint for UI).

#### agent

- [List Models](https://docs.tracecat.com/api-reference/agent/list-models.md): List all available AI models.
- [List Providers](https://docs.tracecat.com/api-reference/agent/list-providers.md): List all available AI model providers.
- [Get Providers Status](https://docs.tracecat.com/api-reference/agent/get-providers-status.md): Get credential status for all providers.
- [List Provider Credential Configs](https://docs.tracecat.com/api-reference/agent/list-provider-credential-configs.md): List credential field configurations for all providers.
- [Get Provider Credential Config](https://docs.tracecat.com/api-reference/agent/get-provider-credential-config.md): Get credential field configuration for a specific provider.
- [Create Provider Credentials](https://docs.tracecat.com/api-reference/agent/create-provider-credentials.md): Create or update credentials for an AI provider.
- [Update Provider Credentials](https://docs.tracecat.com/api-reference/agent/update-provider-credentials.md): Update existing credentials for an AI provider.
- [Delete Provider Credentials](https://docs.tracecat.com/api-reference/agent/delete-provider-credentials.md): Delete credentials for an AI provider.
- [Get Default Model](https://docs.tracecat.com/api-reference/agent/get-default-model.md): Get the organization's default AI model.
- [Set Default Model](https://docs.tracecat.com/api-reference/agent/set-default-model.md): Set the organization's default AI model by catalog id.
- [Get Default Model Selection](https://docs.tracecat.com/api-reference/agent/get-default-model-selection.md): Get the organization's canonical default model selection.
- [Set Default Model Selection](https://docs.tracecat.com/api-reference/agent/set-default-model-selection.md): Set the organization's canonical default model selection.
- [Get Workspace Providers Status](https://docs.tracecat.com/api-reference/agent/get-workspace-providers-status.md): Get workspace credential status for all providers.

#### API Reference

- [List Catalog](https://docs.tracecat.com/api-reference/list-catalog.md): List catalog entries with optional filtering and pagination.
- [Create Catalog Entry](https://docs.tracecat.com/api-reference/create-catalog-entry.md): Create an org-scoped catalog entry and auto-enable it at the org level.
- [Get Catalog Entry](https://docs.tracecat.com/api-reference/get-catalog-entry.md): Get a specific catalog entry.
- [Delete Catalog Entry](https://docs.tracecat.com/api-reference/delete-catalog-entry.md): Delete an org-scoped catalog entry.
- [Update Catalog Entry](https://docs.tracecat.com/api-reference/update-catalog-entry.md): Update metadata on an org-scoped catalog entry.
- [Get Workspace Models](https://docs.tracecat.com/api-reference/get-workspace-models.md): Get models accessible to a workspace.
- [List Enabled Models](https://docs.tracecat.com/api-reference/list-enabled-models.md): List enabled models with pagination.
- [Enable Model](https://docs.tracecat.com/api-reference/enable-model.md): Enable a model for org or workspace.
- [Disable Model](https://docs.tracecat.com/api-reference/disable-model.md): Disable a model.
- [List Custom Providers](https://docs.tracecat.com/api-reference/list-custom-providers.md): List organization custom providers with pagination.
- [Create Custom Provider](https://docs.tracecat.com/api-reference/create-custom-provider.md): Create a new custom LLM provider.
- [Get Custom Provider](https://docs.tracecat.com/api-reference/get-custom-provider.md): Get a specific custom provider.
- [Delete Custom Provider](https://docs.tracecat.com/api-reference/delete-custom-provider.md): Delete a custom provider.
- [Update Custom Provider](https://docs.tracecat.com/api-reference/update-custom-provider.md): Update custom provider configuration.
- [Refresh Custom Provider Catalog](https://docs.tracecat.com/api-reference/refresh-custom-provider-catalog.md): Trigger model discovery for a custom provider.
- [Validate Custom Provider Connection](https://docs.tracecat.com/api-reference/validate-custom-provider-connection.md): Test provider connectivity without saving.

#### agent-channels

- [List Channel Tokens](https://docs.tracecat.com/api-reference/agent-channels/list-channel-tokens.md)
- [Create Channel Token](https://docs.tracecat.com/api-reference/agent-channels/create-channel-token.md)
- [Delete Channel Token](https://docs.tracecat.com/api-reference/agent-channels/delete-channel-token.md)
- [Update Channel Token](https://docs.tracecat.com/api-reference/agent-channels/update-channel-token.md)
- [Rotate Channel Token](https://docs.tracecat.com/api-reference/agent-channels/rotate-channel-token.md)
- [Start Slack Oauth](https://docs.tracecat.com/api-reference/agent-channels/start-slack-oauth.md)

#### agent-presets

- [List Agent Presets](https://docs.tracecat.com/api-reference/agent-presets/list-agent-presets.md): List all agent presets for the current workspace.
- [Create Agent Preset](https://docs.tracecat.com/api-reference/agent-presets/create-agent-preset.md): Create a new agent preset.
- [Get Agent Preset](https://docs.tracecat.com/api-reference/agent-presets/get-agent-preset.md): Retrieve an agent preset by ID.
- [Delete Agent Preset](https://docs.tracecat.com/api-reference/agent-presets/delete-agent-preset.md): Delete an agent preset.
- [Update Agent Preset](https://docs.tracecat.com/api-reference/agent-presets/update-agent-preset.md): Update an existing agent preset.
- [Get Agent Preset By Slug](https://docs.tracecat.com/api-reference/agent-presets/get-agent-preset-by-slug.md): Retrieve an agent preset by slug.
- [List Agent Preset Versions](https://docs.tracecat.com/api-reference/agent-presets/list-agent-preset-versions.md): List immutable versions for an agent preset.
- [Get Agent Preset Version](https://docs.tracecat.com/api-reference/agent-presets/get-agent-preset-version.md): Retrieve an immutable agent preset version.
- [Compare Agent Preset Versions](https://docs.tracecat.com/api-reference/agent-presets/compare-agent-preset-versions.md): Compare two preset versions belonging to the same preset.
- [Restore Agent Preset Version](https://docs.tracecat.com/api-reference/agent-presets/restore-agent-preset-version.md): Restore a historical preset version as current.
- [Move Agent Preset To Folder](https://docs.tracecat.com/api-reference/agent-presets/move-agent-preset-to-folder.md): Move an agent preset to a folder.
- [List Preset Tags](https://docs.tracecat.com/api-reference/agent-presets/list-preset-tags.md): List all tags for an agent preset.
- [Add Preset Tag](https://docs.tracecat.com/api-reference/agent-presets/add-preset-tag.md): Add a tag to an agent preset.
- [Remove Preset Tag](https://docs.tracecat.com/api-reference/agent-presets/remove-preset-tag.md): Remove a tag from an agent preset.

#### agent-folders

- [Get Directory](https://docs.tracecat.com/api-reference/agent-folders/get-directory.md): Get directory items (presets and folders) in the given path.
- [List Folders](https://docs.tracecat.com/api-reference/agent-folders/list-folders.md): List folders under the specified parent path.
- [Create Folder](https://docs.tracecat.com/api-reference/agent-folders/create-folder.md): Create a new agent folder.
- [Get Folder](https://docs.tracecat.com/api-reference/agent-folders/get-folder.md): Get folder details by ID.
- [Delete Folder](https://docs.tracecat.com/api-reference/agent-folders/delete-folder.md): Delete an agent folder.
- [Update Folder](https://docs.tracecat.com/api-reference/agent-folders/update-folder.md): Update a folder (rename).
- [Move Folder](https://docs.tracecat.com/api-reference/agent-folders/move-folder.md): Move a folder to a new parent folder.

#### agent-tags

- [List Agent Tags](https://docs.tracecat.com/api-reference/agent-tags/list-agent-tags.md): List all agent tags in the workspace.
- [Create Agent Tag](https://docs.tracecat.com/api-reference/agent-tags/create-agent-tag.md): Create a new agent tag definition.
- [Get Agent Tag](https://docs.tracecat.com/api-reference/agent-tags/get-agent-tag.md): Get an agent tag by ID.
- [Delete Agent Tag](https://docs.tracecat.com/api-reference/agent-tags/delete-agent-tag.md): Delete an agent tag definition.
- [Update Agent Tag](https://docs.tracecat.com/api-reference/agent-tags/update-agent-tag.md): Update an agent tag definition.

#### agent-skills

- [List Skills](https://docs.tracecat.com/api-reference/agent-skills/list-skills.md): List workspace skills for the current workspace.
- [Create Skill](https://docs.tracecat.com/api-reference/agent-skills/create-skill.md): Create a new logical skill and seed its draft.
- [Upload Skill](https://docs.tracecat.com/api-reference/agent-skills/upload-skill.md): Create a new skill by importing a full draft file tree.
- [Get Skill](https://docs.tracecat.com/api-reference/agent-skills/get-skill.md): Return a skill summary including draft and current version status.
- [Archive Skill](https://docs.tracecat.com/api-reference/agent-skills/archive-skill.md): Archive a logical skill.
- [Get Skill Draft](https://docs.tracecat.com/api-reference/agent-skills/get-skill-draft.md): Return the mutable draft manifest for a skill.
- [Patch Skill Draft](https://docs.tracecat.com/api-reference/agent-skills/patch-skill-draft.md): Apply optimistic-concurrency mutations to a draft.
- [Get Skill Draft File](https://docs.tracecat.com/api-reference/agent-skills/get-skill-draft-file.md): Return one draft file inline or as a presigned download.
- [Create Skill Draft Upload](https://docs.tracecat.com/api-reference/agent-skills/create-skill-draft-upload.md): Create a staged upload session for a draft file blob.
- [Publish Skill](https://docs.tracecat.com/api-reference/agent-skills/publish-skill.md): Publish the current draft into a new immutable version.
- [List Skill Versions](https://docs.tracecat.com/api-reference/agent-skills/list-skill-versions.md): List immutable versions for a skill.
- [Get Skill Version](https://docs.tracecat.com/api-reference/agent-skills/get-skill-version.md): Return one immutable skill version manifest.
- [Get Skill Version File](https://docs.tracecat.com/api-reference/agent-skills/get-skill-version-file.md): Return one published version file inline or as a presigned download.
- [Restore Skill Version](https://docs.tracecat.com/api-reference/agent-skills/restore-skill-version.md): Restore a historical version as the current selected skill version.

#### agent-sessions

- [List Sessions](https://docs.tracecat.com/api-reference/agent-sessions/list-sessions.md): List agent sessions for the current workspace with optional filtering.
- [Create Session](https://docs.tracecat.com/api-reference/agent-sessions/create-session.md): Create a new agent session associated with an entity.
- [Get Session](https://docs.tracecat.com/api-reference/agent-sessions/get-session.md): Get an agent session or legacy chat with its message history.
- [Delete Session](https://docs.tracecat.com/api-reference/agent-sessions/delete-session.md): Delete an agent session.
- [Update Session](https://docs.tracecat.com/api-reference/agent-sessions/update-session.md): Update session properties.
- [Get Session Vercel](https://docs.tracecat.com/api-reference/agent-sessions/get-session-vercel.md): Get an agent session or legacy chat with message history in Vercel format.
- [Remove Session Artifact](https://docs.tracecat.com/api-reference/agent-sessions/remove-session-artifact.md): Remove one artifact from a session's persisted artifact projection.
- [Send Message](https://docs.tracecat.com/api-reference/agent-sessions/send-message.md): Send a message to the agent session with streaming response.
- [Stream Session Events](https://docs.tracecat.com/api-reference/agent-sessions/stream-session-events.md): Stream session events via Server-Sent Events (SSE).
- [Fork Session](https://docs.tracecat.com/api-reference/agent-sessions/fork-session.md): Fork an existing session to continue conversation post-decision.
- [Cancel Session](https://docs.tracecat.com/api-reference/agent-sessions/cancel-session.md): Request graceful cancellation for the active agent session turn.

#### approvals

- [Submit Approvals](https://docs.tracecat.com/api-reference/approvals/submit-approvals.md): Submit approval decisions to a running agent workflow.
- [Delete Approval](https://docs.tracecat.com/api-reference/approvals/delete-approval.md): Dismiss all pending approvals for a session.

#### watchtower

- [List Watchtower Agents](https://docs.tracecat.com/api-reference/watchtower/list-watchtower-agents.md)
- [List Watchtower Agent Sessions](https://docs.tracecat.com/api-reference/watchtower/list-watchtower-agent-sessions.md)
- [List Watchtower Session Tool Calls](https://docs.tracecat.com/api-reference/watchtower/list-watchtower-session-tool-calls.md)
- [Revoke Watchtower Session](https://docs.tracecat.com/api-reference/watchtower/revoke-watchtower-session.md)
- [Disable Watchtower Agent](https://docs.tracecat.com/api-reference/watchtower/disable-watchtower-agent.md)
- [Enable Watchtower Agent](https://docs.tracecat.com/api-reference/watchtower/enable-watchtower-agent.md)

#### admin

- [List Organizations](https://docs.tracecat.com/api-reference/admin/list-organizations.md): List all organizations.
- [Create Organization](https://docs.tracecat.com/api-reference/admin/create-organization.md): Create a new organization.
- [Get Organization](https://docs.tracecat.com/api-reference/admin/get-organization.md): Get organization by ID.
- [Delete Organization](https://docs.tracecat.com/api-reference/admin/delete-organization.md): Delete organization.
- [Update Organization](https://docs.tracecat.com/api-reference/admin/update-organization.md): Update organization.
- [List Organization Invitations](https://docs.tracecat.com/api-reference/admin/list-organization-invitations.md): List platform-created invitations for an organization.
- [Create Organization Invitation](https://docs.tracecat.com/api-reference/admin/create-organization-invitation.md): Create a platform-scoped invitation for an organization.
- [Get Organization Invitation Token](https://docs.tracecat.com/api-reference/admin/get-organization-invitation-token.md): Get the raw token for a platform-created organization invitation.
- [Revoke Organization Invitation](https://docs.tracecat.com/api-reference/admin/revoke-organization-invitation.md): Revoke a pending platform-created organization invitation.
- [List Organization Domains](https://docs.tracecat.com/api-reference/admin/list-organization-domains.md): List all assigned domains for an organization.
- [Create Organization Domain](https://docs.tracecat.com/api-reference/admin/create-organization-domain.md): Create a new assigned domain for an organization.
- [Delete Organization Domain](https://docs.tracecat.com/api-reference/admin/delete-organization-domain.md): Delete an assigned organization domain.
- [Update Organization Domain](https://docs.tracecat.com/api-reference/admin/update-organization-domain.md): Update active/primary state for an assigned organization domain.
- [List Org Repositories](https://docs.tracecat.com/api-reference/admin/list-org-repositories.md): List registry repositories for an organization.
- [List Org Repository Versions](https://docs.tracecat.com/api-reference/admin/list-org-repository-versions.md): List versions for a specific repository in an organization.
- [Sync Org Repository](https://docs.tracecat.com/api-reference/admin/sync-org-repository.md): Sync a registry repository for an organization.
- [Promote Org Repository Version](https://docs.tracecat.com/api-reference/admin/promote-org-repository-version.md): Promote a registry version to be the current version for an org repository.
- [Get Audit Settings](https://docs.tracecat.com/api-reference/admin/get-audit-settings.md): Get platform audit settings.
- [Update Audit Settings](https://docs.tracecat.com/api-reference/admin/update-audit-settings.md): Update platform audit settings.
- [Test Audit Webhook](https://docs.tracecat.com/api-reference/admin/test-audit-webhook.md): Probe the submitted platform audit webhook configuration.
- [Get Registry Settings](https://docs.tracecat.com/api-reference/admin/get-registry-settings.md): Get platform registry settings.
- [Update Registry Settings](https://docs.tracecat.com/api-reference/admin/update-registry-settings.md): Update platform registry settings.
- [List Tiers](https://docs.tracecat.com/api-reference/admin/list-tiers.md): List all tiers.
- [Create Tier](https://docs.tracecat.com/api-reference/admin/create-tier.md): Create a new tier.
- [List Org Tiers](https://docs.tracecat.com/api-reference/admin/list-org-tiers.md): List tier assignments for organizations.
- [Get Tier](https://docs.tracecat.com/api-reference/admin/get-tier.md): Get tier by ID.
- [Delete Tier](https://docs.tracecat.com/api-reference/admin/delete-tier.md): Delete a tier (only if no orgs are assigned to it).
- [Update Tier](https://docs.tracecat.com/api-reference/admin/update-tier.md): Update a tier.
- [Get Org Tier](https://docs.tracecat.com/api-reference/admin/get-org-tier.md): Get tier assignment for an organization.
- [Update Org Tier](https://docs.tracecat.com/api-reference/admin/update-org-tier.md): Update organization's tier assignment and overrides.
- [List Users](https://docs.tracecat.com/api-reference/admin/list-users.md): List all users.
- [Create User](https://docs.tracecat.com/api-reference/admin/create-user.md): Create a platform-level user without org membership.
- [Get User](https://docs.tracecat.com/api-reference/admin/get-user.md): Get user by ID.
- [Delete User](https://docs.tracecat.com/api-reference/admin/delete-user.md): Delete a platform user globally, clearing sessions and dependencies first.
- [Promote To Superuser](https://docs.tracecat.com/api-reference/admin/promote-to-superuser.md): Promote a user to superuser status.
- [Demote From Superuser](https://docs.tracecat.com/api-reference/admin/demote-from-superuser.md): Remove superuser status from a user.

#### admin:agent

- [List Platform Catalog](https://docs.tracecat.com/api-reference/admin:agent/list-platform-catalog.md): List platform-owned agent catalog entries.

#### admin:maintenance

- [Start Case Agent Session Interaction Backfill](https://docs.tracecat.com/api-reference/admin:maintenance/start-case-agent-session-interaction-backfill.md): Start or join the durable historical case-mutation backfill.
- [Get Case Agent Session Interaction Backfill](https://docs.tracecat.com/api-reference/admin:maintenance/get-case-agent-session-interaction-backfill.md): Poll a durable historical case-mutation backfill.

#### admin:registry

- [List Platform Repositories](https://docs.tracecat.com/api-reference/admin:registry/list-platform-repositories.md): List all platform registry repositories.
- [Get Platform Repository](https://docs.tracecat.com/api-reference/admin:registry/get-platform-repository.md): Get a specific platform registry repository.
- [Sync All Repositories](https://docs.tracecat.com/api-reference/admin:registry/sync-all-repositories.md): Trigger sync for all platform registry repositories.
- [Sync Repository](https://docs.tracecat.com/api-reference/admin:registry/sync-repository.md): Trigger sync for a specific platform registry repository.
- [Get Registry Status](https://docs.tracecat.com/api-reference/admin:registry/get-registry-status.md): Get registry sync status and health.
- [List Registry Versions](https://docs.tracecat.com/api-reference/admin:registry/list-registry-versions.md): List registry versions with optional filtering.
- [Start Registry Artifacts Backfill](https://docs.tracecat.com/api-reference/admin:registry/start-registry-artifacts-backfill.md): Start a workflow to backfill artifacts for selected versions.
- [Promote Registry Version](https://docs.tracecat.com/api-reference/admin:registry/promote-registry-version.md): Promote a registry version to be the current version for a repository.
- [Delete Registry Version](https://docs.tracecat.com/api-reference/admin:registry/delete-registry-version.md): Delete an unused, non-current platform registry version.

#### inbox

- [Get Pending Count](https://docs.tracecat.com/api-reference/inbox/get-pending-count.md): Get the number of pending inbox items that require attention.
- [List Items](https://docs.tracecat.com/api-reference/inbox/list-items.md): List inbox items with cursor-based pagination.

#### editor

- [List Functions](https://docs.tracecat.com/api-reference/editor/list-functions.md)
- [List Actions](https://docs.tracecat.com/api-reference/editor/list-actions.md)
- [Validate Expression](https://docs.tracecat.com/api-reference/editor/validate-expression.md): LSP endpoint for validating template expressions using the Lark grammar.
- [Field Schema](https://docs.tracecat.com/api-reference/editor/field-schema.md)

#### registry-repositories

- [Sync Registry Repository](https://docs.tracecat.com/api-reference/registry-repositories/sync-registry-repository.md): Sync an org-scoped registry repository.
- [List Repository Versions](https://docs.tracecat.com/api-reference/registry-repositories/list-repository-versions.md): List all versions for an org-scoped registry repository.
- [List Registry Repositories](https://docs.tracecat.com/api-reference/registry-repositories/list-registry-repositories.md): List org-scoped registry repositories.
- [Create Registry Repository](https://docs.tracecat.com/api-reference/registry-repositories/create-registry-repository.md): Create a new registry repository.
- [Get Registry Repository](https://docs.tracecat.com/api-reference/registry-repositories/get-registry-repository.md): Get a specific org-scoped registry repository by ID.
- [Delete Registry Repository](https://docs.tracecat.com/api-reference/registry-repositories/delete-registry-repository.md): Delete a registry repository.
- [Update Registry Repository](https://docs.tracecat.com/api-reference/registry-repositories/update-registry-repository.md): Update an existing registry repository.
- [List Repository Commits](https://docs.tracecat.com/api-reference/registry-repositories/list-repository-commits.md): List commits from a specific registry repository.
- [Promote Registry Version](https://docs.tracecat.com/api-reference/registry-repositories/promote-registry-version.md): Promote a specific version to be the current version of an org-scoped repository.
- [Delete Registry Version](https://docs.tracecat.com/api-reference/registry-repositories/delete-registry-version.md): Delete a specific registry version.
- [Compare Registry Versions](https://docs.tracecat.com/api-reference/registry-repositories/compare-registry-versions.md): Compare two registry versions and return the diff.
- [Get Previous Registry Version](https://docs.tracecat.com/api-reference/registry-repositories/get-previous-registry-version.md): Get the previous version before the specified version.

#### registry-actions

- [List Registry Actions](https://docs.tracecat.com/api-reference/registry-actions/list-registry-actions.md): List all actions from registry index.
- [Get Registry Action](https://docs.tracecat.com/api-reference/registry-actions/get-registry-action.md): Get a specific registry action.

#### settings

- [Get Git Settings](https://docs.tracecat.com/api-reference/settings/get-git-settings.md)
- [Update Git Settings](https://docs.tracecat.com/api-reference/settings/update-git-settings.md)
- [Get Saml Settings](https://docs.tracecat.com/api-reference/settings/get-saml-settings.md)
- [Update Saml Settings](https://docs.tracecat.com/api-reference/settings/update-saml-settings.md)
- [Get App Settings](https://docs.tracecat.com/api-reference/settings/get-app-settings.md)
- [Update App Settings](https://docs.tracecat.com/api-reference/settings/update-app-settings.md)
- [Get Audit Settings](https://docs.tracecat.com/api-reference/settings/get-audit-settings.md)
- [Update Audit Settings](https://docs.tracecat.com/api-reference/settings/update-audit-settings.md)
- [Test Audit Webhook](https://docs.tracecat.com/api-reference/settings/test-audit-webhook.md): Probe the submitted audit webhook configuration with a marked test event.
- [Get Agent Settings](https://docs.tracecat.com/api-reference/settings/get-agent-settings.md)
- [Update Agent Settings](https://docs.tracecat.com/api-reference/settings/update-agent-settings.md)
- [Get Agent Otel Settings](https://docs.tracecat.com/api-reference/settings/get-agent-otel-settings.md)
- [Update Agent Otel Settings](https://docs.tracecat.com/api-reference/settings/update-agent-otel-settings.md)

#### organization-secrets

- [List Org Secrets](https://docs.tracecat.com/api-reference/organization-secrets/list-org-secrets.md): List organization secrets.
- [Create Org Secret](https://docs.tracecat.com/api-reference/organization-secrets/create-org-secret.md): Create an organization secret.
- [Get Org Secret By Name](https://docs.tracecat.com/api-reference/organization-secrets/get-org-secret-by-name.md): Get an organization secret by name.
- [Update Org Secret By Id](https://docs.tracecat.com/api-reference/organization-secrets/update-org-secret-by-id.md): Update an organization secret by ID.
- [Delete Org Secret By Id](https://docs.tracecat.com/api-reference/organization-secrets/delete-org-secret-by-id.md): Delete an organization secret by ID.

#### tables

- [List Tables](https://docs.tracecat.com/api-reference/tables/list-tables.md): List all tables.
- [Create Table](https://docs.tracecat.com/api-reference/tables/create-table.md): Create a new table.
- [Get Table](https://docs.tracecat.com/api-reference/tables/get-table.md): Get a table by ID.
- [Delete Table](https://docs.tracecat.com/api-reference/tables/delete-table.md): Delete a table.
- [Update Table](https://docs.tracecat.com/api-reference/tables/update-table.md): Update table metadata.
- [Create Column](https://docs.tracecat.com/api-reference/tables/create-column.md): Add a column to a table.
- [Delete Column](https://docs.tracecat.com/api-reference/tables/delete-column.md): Delete a column from a table.
- [Update Column](https://docs.tracecat.com/api-reference/tables/update-column.md): Update a column.
- [List Rows](https://docs.tracecat.com/api-reference/tables/list-rows.md): List table rows with cursor-based pagination and sorting.
- [Insert Row](https://docs.tracecat.com/api-reference/tables/insert-row.md): Create a new row in a table.
- [Get Row](https://docs.tracecat.com/api-reference/tables/get-row.md): Get a row by ID.
- [Delete Row](https://docs.tracecat.com/api-reference/tables/delete-row.md): Delete a row from a table.
- [Update Row](https://docs.tracecat.com/api-reference/tables/update-row.md): Update a row in a table.
- [Batch Insert Rows](https://docs.tracecat.com/api-reference/tables/batch-insert-rows.md): Insert multiple rows into a table atomically.
- [Batch Delete Rows](https://docs.tracecat.com/api-reference/tables/batch-delete-rows.md): Delete multiple rows from a table.
- [Batch Update Rows](https://docs.tracecat.com/api-reference/tables/batch-update-rows.md): Update multiple rows in a table with the same data.
- [Import Table From Csv](https://docs.tracecat.com/api-reference/tables/import-table-from-csv.md): Create a new table by importing a CSV file.
- [Import Csv](https://docs.tracecat.com/api-reference/tables/import-csv.md): Import data from a CSV file into a table.

#### cases

- [List Cases](https://docs.tracecat.com/api-reference/cases/list-cases.md): List cases with default filtering and sorting options.
- [Create Case](https://docs.tracecat.com/api-reference/cases/create-case.md): Create a new case.
- [Search Cases](https://docs.tracecat.com/api-reference/cases/search-cases.md): Search cases with cursor-based pagination, filtering, and sorting.
- [Search Case Aggregates](https://docs.tracecat.com/api-reference/cases/search-case-aggregates.md): Return global case totals and per-stage counts for the current filters.
- [Batch Update Cases](https://docs.tracecat.com/api-reference/cases/batch-update-cases.md): Update multiple cases with per-case results.
- [Batch Delete Cases](https://docs.tracecat.com/api-reference/cases/batch-delete-cases.md): Delete multiple cases with per-case results.
- [Get Case](https://docs.tracecat.com/api-reference/cases/get-case.md): Get a specific case.
- [Delete Case](https://docs.tracecat.com/api-reference/cases/delete-case.md): Delete a case.
- [Update Case](https://docs.tracecat.com/api-reference/cases/update-case.md): Update a case.
- [List Comments](https://docs.tracecat.com/api-reference/cases/list-comments.md): List all comments for a case.
- [Create Comment](https://docs.tracecat.com/api-reference/cases/create-comment.md): Create a new comment on a case.
- [List Comment Threads](https://docs.tracecat.com/api-reference/cases/list-comment-threads.md): List case comment threads.
- [Delete Comment](https://docs.tracecat.com/api-reference/cases/delete-comment.md): Delete a comment.
- [Update Comment](https://docs.tracecat.com/api-reference/cases/update-comment.md): Update an existing comment.
- [List Events With Users](https://docs.tracecat.com/api-reference/cases/list-events-with-users.md): List all users for a case.
- [List Tasks](https://docs.tracecat.com/api-reference/cases/list-tasks.md): List all tasks for a case.
- [Create Task](https://docs.tracecat.com/api-reference/cases/create-task.md): Create a new task for a case.
- [Delete Task](https://docs.tracecat.com/api-reference/cases/delete-task.md): Delete a task.
- [Update Task](https://docs.tracecat.com/api-reference/cases/update-task.md): Update a task.
- [List Case Versions](https://docs.tracecat.com/api-reference/cases/list-case-versions.md): List immutable case field versions newest-first.
- [Compare Case Version](https://docs.tracecat.com/api-reference/cases/compare-case-version.md): Return a case field version and its immediate predecessor.
- [Restore Case Version](https://docs.tracecat.com/api-reference/cases/restore-case-version.md): Restore one historical case field version atomically.
- [List Case Rows](https://docs.tracecat.com/api-reference/cases/list-case-rows.md): List linked rows.
- [Link Case Row](https://docs.tracecat.com/api-reference/cases/link-case-row.md)
- [List Case Linked Tables](https://docs.tracecat.com/api-reference/cases/list-case-linked-tables.md): List the tables that have rows linked to a case, with their columns.
- [Insert Case Row](https://docs.tracecat.com/api-reference/cases/insert-case-row.md)
- [Batch Link Case Rows](https://docs.tracecat.com/api-reference/cases/batch-link-case-rows.md): Link rows in bulk; conflict handling makes an integrity error unreachable.
- [Batch Unlink Case Rows](https://docs.tracecat.com/api-reference/cases/batch-unlink-case-rows.md): Unlink rows in bulk, returning zero for a fully no-op batch.
- [Unlink Case Row](https://docs.tracecat.com/api-reference/cases/unlink-case-row.md)
- [List Fields](https://docs.tracecat.com/api-reference/cases/list-fields.md): List all case fields.
- [Create Field](https://docs.tracecat.com/api-reference/cases/create-field.md): Create a new case field.
- [Delete Field](https://docs.tracecat.com/api-reference/cases/delete-field.md): Delete a case field.
- [Update Field](https://docs.tracecat.com/api-reference/cases/update-field.md): Update a case field.
- [List Tags](https://docs.tracecat.com/api-reference/cases/list-tags.md): List all tags for a case.
- [Add Tag](https://docs.tracecat.com/api-reference/cases/add-tag.md): Add a tag to a case using tag ID or slug.
- [Remove Tag](https://docs.tracecat.com/api-reference/cases/remove-tag.md): Remove a tag from a case using tag ID or ref.
- [List Case Dropdown Values](https://docs.tracecat.com/api-reference/cases/list-case-dropdown-values.md): List all dropdown values for a case.
- [Set Case Dropdown Value](https://docs.tracecat.com/api-reference/cases/set-case-dropdown-value.md): Set or clear a dropdown value for a case.

#### case-tags

- [List Case Tags](https://docs.tracecat.com/api-reference/case-tags/list-case-tags.md): List all case tags available in the current workspace.
- [Create Case Tag](https://docs.tracecat.com/api-reference/case-tags/create-case-tag.md): Create a new case tag definition.
- [Get Case Tag](https://docs.tracecat.com/api-reference/case-tags/get-case-tag.md): Retrieve a single case tag by ID.
- [Delete Case Tag](https://docs.tracecat.com/api-reference/case-tags/delete-case-tag.md): Delete a case tag definition.
- [Update Case Tag](https://docs.tracecat.com/api-reference/case-tags/update-case-tag.md): Update an existing case tag definition.

#### case-attachments

- [List Attachments](https://docs.tracecat.com/api-reference/case-attachments/list-attachments.md): List all attachments for a case.
- [Create Attachment](https://docs.tracecat.com/api-reference/case-attachments/create-attachment.md): Upload a new attachment to a case.
- [Download Attachment](https://docs.tracecat.com/api-reference/case-attachments/download-attachment.md): Download an attachment.
- [Delete Attachment](https://docs.tracecat.com/api-reference/case-attachments/delete-attachment.md): Delete an attachment (soft delete).

#### case-dropdowns

- [List Dropdown Definitions](https://docs.tracecat.com/api-reference/case-dropdowns/list-dropdown-definitions.md): List all dropdown definitions for the workspace.
- [Create Dropdown Definition](https://docs.tracecat.com/api-reference/case-dropdowns/create-dropdown-definition.md): Create a new dropdown definition with initial options.
- [Get Dropdown Definition](https://docs.tracecat.com/api-reference/case-dropdowns/get-dropdown-definition.md): Get a single dropdown definition.
- [Delete Dropdown Definition](https://docs.tracecat.com/api-reference/case-dropdowns/delete-dropdown-definition.md): Delete a dropdown definition and all its options/values.
- [Update Dropdown Definition](https://docs.tracecat.com/api-reference/case-dropdowns/update-dropdown-definition.md): Update a dropdown definition.
- [Add Dropdown Option](https://docs.tracecat.com/api-reference/case-dropdowns/add-dropdown-option.md): Add a new option to a dropdown definition.
- [Delete Dropdown Option](https://docs.tracecat.com/api-reference/case-dropdowns/delete-dropdown-option.md): Delete an option from a dropdown definition.
- [Update Dropdown Option](https://docs.tracecat.com/api-reference/case-dropdowns/update-dropdown-option.md): Update an option within a dropdown definition.
- [Reorder Dropdown Options](https://docs.tracecat.com/api-reference/case-dropdowns/reorder-dropdown-options.md): Reorder options within a dropdown definition.

#### case-durations

- [List Case Duration Definitions](https://docs.tracecat.com/api-reference/case-durations/list-case-duration-definitions.md): List all case duration definitions for the active workspace.
- [Create Case Duration Definition](https://docs.tracecat.com/api-reference/case-durations/create-case-duration-definition.md): Create a new case duration definition.
- [Get Case Duration Definition](https://docs.tracecat.com/api-reference/case-durations/get-case-duration-definition.md): Retrieve a single case duration definition.
- [Delete Case Duration Definition](https://docs.tracecat.com/api-reference/case-durations/delete-case-duration-definition.md): Delete a case duration definition.
- [Update Case Duration Definition](https://docs.tracecat.com/api-reference/case-durations/update-case-duration-definition.md): Update an existing case duration definition.
- [List Case Durations](https://docs.tracecat.com/api-reference/case-durations/list-case-durations.md): List materialized case durations for the provided case.
- [Create Case Duration](https://docs.tracecat.com/api-reference/case-durations/create-case-duration.md): Create a persisted case duration.
- [Get Case Duration](https://docs.tracecat.com/api-reference/case-durations/get-case-duration.md): Retrieve a persisted case duration.
- [Delete Case Duration](https://docs.tracecat.com/api-reference/case-durations/delete-case-duration.md): Delete a persisted case duration.
- [Update Case Duration](https://docs.tracecat.com/api-reference/case-durations/update-case-duration.md): Update a persisted case duration.

#### folders

- [Get Directory](https://docs.tracecat.com/api-reference/folders/get-directory.md): Get directory items (workflows and folders) in the given path.
- [List Folders](https://docs.tracecat.com/api-reference/folders/list-folders.md): List folders under the specified parent path.
- [Create Folder](https://docs.tracecat.com/api-reference/folders/create-folder.md): Create a new folder.
- [Get Folder](https://docs.tracecat.com/api-reference/folders/get-folder.md): Get folder details by ID.
- [Delete Folder](https://docs.tracecat.com/api-reference/folders/delete-folder.md): Delete a folder.
- [Update Folder](https://docs.tracecat.com/api-reference/folders/update-folder.md): Update a folder (rename).
- [Move Folder](https://docs.tracecat.com/api-reference/folders/move-folder.md): Move a folder to a new parent folder.

#### integrations

- [Oauth Callback](https://docs.tracecat.com/api-reference/integrations/oauth-callback.md): Handle OAuth callback for the specified provider.
- [List Integrations](https://docs.tracecat.com/api-reference/integrations/list-integrations.md): List all integrations for the current user.
- [Get Integration](https://docs.tracecat.com/api-reference/integrations/get-integration.md): Get integration for the specified provider.
- [Update Integration](https://docs.tracecat.com/api-reference/integrations/update-integration.md): Update OAuth client credentials for the specified provider integration.
- [Delete Integration](https://docs.tracecat.com/api-reference/integrations/delete-integration.md): Delete integration for the specified provider (removes the integration record completely).
- [Connect Provider](https://docs.tracecat.com/api-reference/integrations/connect-provider.md): Initiate OAuth integration for the specified provider.
- [Disconnect Integration](https://docs.tracecat.com/api-reference/integrations/disconnect-integration.md): Disconnect integration for the specified provider (revokes tokens but keeps configuration).
- [Test Connection](https://docs.tracecat.com/api-reference/integrations/test-connection.md): Test client credentials connection for the specified provider.

#### providers

- [List Providers](https://docs.tracecat.com/api-reference/providers/list-providers.md)
- [Create Custom Provider](https://docs.tracecat.com/api-reference/providers/create-custom-provider.md)
- [Get Provider](https://docs.tracecat.com/api-reference/providers/get-provider.md): Get provider metadata, scopes, and schema.

#### mcp-integrations

- [List Mcp Integrations](https://docs.tracecat.com/api-reference/mcp-integrations/list-mcp-integrations.md): List MCP integrations for the workspace, optionally filtered by source.
- [Create Mcp Integration](https://docs.tracecat.com/api-reference/mcp-integrations/create-mcp-integration.md): Create a new MCP integration.
- [List Platform Mcp Catalog](https://docs.tracecat.com/api-reference/mcp-integrations/list-platform-mcp-catalog.md): List platform MCP catalog rows with workspace connection state.
- [Connect Platform Mcp Catalog](https://docs.tracecat.com/api-reference/mcp-integrations/connect-platform-mcp-catalog.md): Create or return a workspace MCP integration from catalog defaults.
- [Connect Mcp Integration](https://docs.tracecat.com/api-reference/mcp-integrations/connect-mcp-integration.md): Create an MCP integration or start generic MCP OAuth discovery.
- [Get Mcp Integration](https://docs.tracecat.com/api-reference/mcp-integrations/get-mcp-integration.md): Get an MCP integration by ID.
- [Update Mcp Integration](https://docs.tracecat.com/api-reference/mcp-integrations/update-mcp-integration.md): Update an MCP integration.
- [Delete Mcp Integration](https://docs.tracecat.com/api-reference/mcp-integrations/delete-mcp-integration.md): Delete an MCP integration.
- [Get Mcp Integration Verification Status](https://docs.tracecat.com/api-reference/mcp-integrations/get-mcp-integration-verification-status.md): Get saved MCP integration verification status.
- [Update Mcp Integration Tool Policies](https://docs.tracecat.com/api-reference/mcp-integrations/update-mcp-integration-tool-policies.md): Update MCP integration tool availability and approval policy.
- [Test Mcp Connection Config](https://docs.tracecat.com/api-reference/mcp-integrations/test-mcp-connection-config.md): Test connectivity against an MCP configuration.
- [Test Mcp Integration Connection](https://docs.tracecat.com/api-reference/mcp-integrations/test-mcp-integration-connection.md): Test connectivity to an MCP server and refresh its tool listing.
- [Disconnect Mcp Integration](https://docs.tracecat.com/api-reference/mcp-integrations/disconnect-mcp-integration.md): Disconnect an MCP integration by deleting the workspace MCP row.

#### feature-flags

- [Get Feature Flags](https://docs.tracecat.com/api-reference/feature-flags/get-feature-flags.md): Get the list of enabled feature flags.

#### vcs

- [Get Github App Manifest](https://docs.tracecat.com/api-reference/vcs/get-github-app-manifest.md): Generate GitHub App manifest for enterprise installation.
- [Github App Install Callback](https://docs.tracecat.com/api-reference/vcs/github-app-install-callback.md): Handle GitHub App installation flow.
- [Github Webhook](https://docs.tracecat.com/api-reference/vcs/github-webhook.md): Handle GitHub webhook events.
- [Save Github App Credentials](https://docs.tracecat.com/api-reference/vcs/save-github-app-credentials.md): Save GitHub App credentials (register new or update existing).
- [Delete Github App Credentials](https://docs.tracecat.com/api-reference/vcs/delete-github-app-credentials.md): Delete GitHub App credentials.
- [Get Github App Credentials Status](https://docs.tracecat.com/api-reference/vcs/get-github-app-credentials-status.md): Get the status of GitHub App credentials.
- [Save Gitlab Token Credentials](https://docs.tracecat.com/api-reference/vcs/save-gitlab-token-credentials.md): Save GitLab token credentials (create if new or update existing).
- [Delete Gitlab Token Credentials](https://docs.tracecat.com/api-reference/vcs/delete-gitlab-token-credentials.md): Delete GitLab token credentials.
- [Get Gitlab Token Credentials Status](https://docs.tracecat.com/api-reference/vcs/get-gitlab-token-credentials-status.md): Get the status of GitLab token credentials.

#### rbac

- [List Roles](https://docs.tracecat.com/api-reference/rbac/list-roles.md): List roles for the organization.
- [Create Role](https://docs.tracecat.com/api-reference/rbac/create-role.md): Create a custom role.
- [List User Assignments](https://docs.tracecat.com/api-reference/rbac/list-user-assignments.md): List user role assignments for the organization.
- [Create User Assignment](https://docs.tracecat.com/api-reference/rbac/create-user-assignment.md): Create a user role assignment.
- [Get User Assignment](https://docs.tracecat.com/api-reference/rbac/get-user-assignment.md): Get a user role assignment by ID.
- [Delete User Assignment](https://docs.tracecat.com/api-reference/rbac/delete-user-assignment.md): Delete a user role assignment.
- [Update User Assignment](https://docs.tracecat.com/api-reference/rbac/update-user-assignment.md): Update a user role assignment (change role).
- [List Scopes](https://docs.tracecat.com/api-reference/rbac/list-scopes.md): List scopes available to the organization.
- [Create Scope](https://docs.tracecat.com/api-reference/rbac/create-scope.md): Create a custom scope.
- [Get Scope](https://docs.tracecat.com/api-reference/rbac/get-scope.md): Get a scope by ID.
- [Delete Scope](https://docs.tracecat.com/api-reference/rbac/delete-scope.md): Delete a custom scope.
- [Get Role](https://docs.tracecat.com/api-reference/rbac/get-role.md): Get a role by ID with its scopes.
- [Delete Role](https://docs.tracecat.com/api-reference/rbac/delete-role.md): Delete a role.
- [Update Role](https://docs.tracecat.com/api-reference/rbac/update-role.md): Update a role.
- [List Groups](https://docs.tracecat.com/api-reference/rbac/list-groups.md): List groups for the organization.
- [Create Group](https://docs.tracecat.com/api-reference/rbac/create-group.md): Create a group.
- [Get Group](https://docs.tracecat.com/api-reference/rbac/get-group.md): Get a group by ID with its members.
- [Delete Group](https://docs.tracecat.com/api-reference/rbac/delete-group.md): Delete a group.
- [Update Group](https://docs.tracecat.com/api-reference/rbac/update-group.md): Update a group.
- [Add Group Member](https://docs.tracecat.com/api-reference/rbac/add-group-member.md): Add a member to a group.
- [Remove Group Member](https://docs.tracecat.com/api-reference/rbac/remove-group-member.md): Remove a member from a group.
- [List Assignments](https://docs.tracecat.com/api-reference/rbac/list-assignments.md): List group assignments for the organization.
- [Create Assignment](https://docs.tracecat.com/api-reference/rbac/create-assignment.md): Create a group assignment.
- [Get Assignment](https://docs.tracecat.com/api-reference/rbac/get-assignment.md): Get a group assignment by ID.
- [Delete Assignment](https://docs.tracecat.com/api-reference/rbac/delete-assignment.md): Delete a group assignment.
- [Update Assignment](https://docs.tracecat.com/api-reference/rbac/update-assignment.md): Update a group assignment (change role).

#### auth

- [Oauth:Oidc.Database.Authorize](https://docs.tracecat.com/api-reference/auth/oauth:oidcdatabaseauthorize.md)
- [Oauth:Oidc.Database.Callback](https://docs.tracecat.com/api-reference/auth/oauth:oidcdatabasecallback.md): The response varies based on the authentication backend used.
- [Saml:Database.Login](https://docs.tracecat.com/api-reference/auth/saml:databaselogin.md): Initiate SAML login flow
- [Sso Acs](https://docs.tracecat.com/api-reference/auth/sso-acs.md): Handle the SAML SSO response from the IdP post-authentication.
- [Discover Auth Method](https://docs.tracecat.com/api-reference/auth/discover-auth-method.md): Return the next-step auth method for a given email.
- [Auth:Database.Logout](https://docs.tracecat.com/api-reference/auth/auth:databaselogout.md)

## OpenAPI Specs

- [openapi](https://platform.tracecat.com/api/openapi.json)
