> ## Documentation Index > Fetch the complete documentation index at: https://docs.cotool.ai/llms.txt > Use this file to discover all available pages before exploring further. # List alert Slack threads > List the replies people posted in the alert's Slack threads, mirrored onto its timeline. ## OpenAPI ````yaml https://app.cotool.ai/api/docs/openapi.json get /api/alerts/{alertId}/slack-threads openapi: 3.1.0 info: title: Cotool API version: 1.0.0 description: >- The Cotool REST API. Authenticate with an API key from `/settings/api-keys` sent as `Authorization: Bearer `. Authentication, error formats, pagination, and common integration recipes are documented in the [API overview](https://docs.cotool.ai/api-reference/introduction). Endpoints marked **Deprecated** keep working; each one's description names its replacement. servers: - url: https://app.cotool.ai description: Production server security: - ApiKeyAuth: [] tags: - name: Agents description: Create, update, run, and version agents. - name: Agent Runs description: Inspect agent runs, submit feedback, and read evaluation metrics. - name: Agent Triggers description: Webhook, schedule, and integration triggers that start agent runs. - name: Agents as Code description: Validate agents and skills defined as YAML in a Git repository. - name: Skills description: Reusable instructions and tool grants attached to agents. - name: Chat description: Chat sessions and their transcripts. - name: Alerts description: Alert triage, routing, and escalation notifications. - name: Output Destinations description: Webhook, Slack, Jira, and Linear destinations for agent output. - name: Detections description: Detection agents, detection hits, and the Cotool detection library. - name: Hunt description: Autonomous hunt threats, gaps, and settings. - name: Intel description: Threat-intelligence feed items, indicators, and sources. - name: Threat Model description: The organization threat model and its version history. - name: MITRE Coverage description: MITRE ATT&CK coverage across detections. - name: Tools description: Connected tool integrations and captured tool output. - name: CLIs description: Connected CLI integrations. - name: Artifacts description: Files and reports produced by agent runs. - name: Audit Logs description: Organization audit log export and event catalog. - name: Users description: Users, memberships, and the current session. - name: Roles description: Role-based permissions. - name: Organizations description: Organization-level metrics. paths: /api/alerts/{alertId}/slack-threads: get: tags: - Alerts summary: List alert Slack threads description: >- List the replies people posted in the alert's Slack threads, mirrored onto its timeline. parameters: - in: path name: alertId description: Alert UUID or human-readable display ID schema: type: string description: Alert UUID or human-readable display ID required: true responses: '200': description: Successful response content: application/json: schema: type: object properties: entries: type: array items: type: object properties: id: type: string format: uuid description: Timeline entry identifier organizationId: type: string format: uuid description: Organization that owns the timeline entry alertId: type: string format: uuid description: Alert this entry belongs to createdAt: type: string description: ISO timestamp when the entry was created actorType: type: string enum: - human - agent - system description: Actor class responsible for a timeline entry. actorUserId: type: - string - 'null' format: uuid description: Human actor user id, when actorType is human actorAgentId: type: - string - 'null' format: uuid description: Agent actor id, when actorType is agent actorRunId: type: - string - 'null' format: uuid description: Run responsible for this entry, stored as chats.id actorUserName: type: - string - 'null' description: >- Resolved display name for a human actor, hydrated for rendering actorUserImageUrl: type: - string - 'null' description: >- Resolved avatar image URL for a human actor, when one is available actorAgentName: type: - string - 'null' description: >- Resolved display name for an agent actor or referenced assigned agent kind: type: string const: external_event bodyMarkdown: type: - string - 'null' description: Timeline body, when this entry has prose content beforeStatus: type: - string - 'null' enum: - open - in_progress - escalated - closed_true_positive - closed_false_positive - closed_true_positive_benign - dismissed - duplicate - expired - null description: Status before a status transition afterStatus: type: - string - 'null' enum: - open - in_progress - escalated - closed_true_positive - closed_false_positive - closed_true_positive_benign - dismissed - duplicate - expired - null description: Status after a status transition metadata: type: object properties: slackThread: type: object properties: teamId: type: string pattern: ^T[A-Z0-9]+$ channelId: type: string pattern: ^[CG][A-Z0-9]+$ threadTs: type: string pattern: ^\d+\.\d+$ url: type: - string - 'null' format: uri description: Link to the thread root replies: type: array items: type: object properties: messageTs: type: string pattern: ^\d+\.\d+$ userId: type: string pattern: ^[UW][A-Z0-9]+$ userName: type: string minLength: 1 maxLength: 200 text: type: string minLength: 1 maxLength: 4000 textTruncated: type: boolean permalink: type: string format: uri editedAt: type: string format: date-time description: >- When the author last edited the reply in Slack required: - messageTs - userId - text maxItems: 200 description: >- Replies oldest first, by Slack message timestamp required: - teamId - channelId - threadTs - url - replies description: >- Replies people posted in one of the alert's Slack threads, mirrored from Slack additionalProperties: true description: >- Metadata for externally mirrored alert timeline entries. required: - id - organizationId - alertId - createdAt - actorType - actorUserId - actorAgentId - actorRunId - actorUserName - actorUserImageUrl - kind - bodyMarkdown - beforeStatus - afterStatus - metadata description: >- Every mirrored Slack thread on the alert's timeline, newest first, whatever page of the timeline it falls on required: - entries '400': description: Bad request — input validation failed or the request was malformed content: application/json: schema: $ref: '#/components/schemas/ValidationError' '401': description: Unauthorized — missing or invalid API key / session content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Forbidden — the authenticated user lacks the required permissions content: application/json: schema: $ref: '#/components/schemas/PermissionError' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' x-codeSamples: - lang: shell label: cURL source: >- curl -X GET "https://app.cotool.ai/api/alerts/:alertId/slack-threads" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" components: schemas: ValidationError: type: object properties: error: type: string description: Error message describing what went wrong issues: type: array description: >- Detailed validation issues, present when request or response schema validation fails items: type: object additionalProperties: true required: - error Error: type: object properties: error: type: string description: Error message describing what went wrong required: - error PermissionError: type: object properties: error: type: string description: Error message describing what went wrong missingPerms: type: array description: Permissions the authenticated user is missing for this operation items: type: string required: - error securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: API Key description: >- API Key authentication for programmatic access. Include your API key in the Authorization header as: `Bearer your_api_key_here` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.