> ## Documentation Index > Fetch the complete documentation index at: https://langwatch.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details. # Create a Slack alert trigger > Create a trigger that posts to Slack when traces match its filters, through a Slack connection (`slack_connection_id`, plus `slack_channel_id` for a bot) or an incoming webhook URL (`slack_webhook`), which is stored as a connection. The trigger stores no secret of its own. The `/api/triggers` family supersedes this narrower form, which stays for callers written against it. ## OpenAPI ````yaml POST /api/v1/trigger/slack openapi: 3.1.0 info: title: LangWatch API description: LangWatch openapi spec version: 1.0.0 servers: - url: https://app.langwatch.ai security: - project_api_key: [] paths: /api/v1/trigger/slack: post: tags: - Triggers summary: Create a Slack alert trigger description: >- Create a trigger that posts to Slack when traces match its filters, through a Slack connection (`slack_connection_id`, plus `slack_channel_id` for a bot) or an incoming webhook URL (`slack_webhook`), which is stored as a connection. The trigger stores no secret of its own. The `/api/triggers` family supersedes this narrower form, which stays for callers written against it. operationId: postApiTriggerSlack requestBody: required: true content: application/json: schema: type: object properties: slack_webhook: description: >- Incoming webhook URL the alert is posted to. It is stored as a Slack connection this project can use (an existing one holding the same URL, else a new project connection). Send this or `slack_connection_id`, not both. type: string format: uri slack_connection_id: description: >- The Slack connection the alert posts through: an organization connection or one of this project's, as `GET /api/slack-connections` and `langwatch slack-connection list` list them. Send this or `slack_webhook`, not both. type: string minLength: 1 slack_channel_id: description: >- The channel a bot connection posts in; required with one. Invite the LangWatch app to it first. type: string minLength: 1 name: type: string description: How the trigger is listed in the app message: description: Extra line included with each alert type: string filters: default: {} description: >- Which traces the trigger fires on. An empty object fires on all of them. type: object propertyNames: type: string enum: - topics.topics - topics.subtopics - metadata.user_id - metadata.thread_id - metadata.customer_id - metadata.labels - metadata.key - metadata.value - metadata.prompt_ids - traces.origin - traces.error - traces.name - spans.type - spans.model - evaluations.evaluator_id - evaluations.evaluator_id.guardrails_only - evaluations.evaluator_id.has_passed - evaluations.evaluator_id.has_score - evaluations.evaluator_id.has_label - evaluations.passed - evaluations.score - evaluations.state - evaluations.label - events.event_type - events.metrics.key - events.metrics.value - events.event_details.key - annotations.hasAnnotation additionalProperties: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string properties: topics.topics: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string topics.subtopics: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.user_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.thread_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.customer_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.labels: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.key: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.value: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string metadata.prompt_ids: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string traces.origin: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string traces.error: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string traces.name: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string spans.type: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string spans.model: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.guardrails_only: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.has_passed: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.has_score: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.evaluator_id.has_label: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.passed: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.score: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.state: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string evaluations.label: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.event_type: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.metrics.key: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.metrics.value: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string events.event_details.key: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string annotations.hasAnnotation: anyOf: - type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: array items: type: string - type: object propertyNames: type: string additionalProperties: type: object propertyNames: type: string additionalProperties: type: array items: type: string alert_type: type: string enum: - CRITICAL - WARNING - INFO required: - name - alert_type responses: '200': description: Success content: application/json: schema: type: object properties: message: type: string required: - message additionalProperties: false '400': description: The body was not valid JSON content: {} '401': description: Missing or invalid API key content: {} '403': description: The API key lacks triggers:manage content: {} '422': description: >- The body failed validation, the connection is not one this project can use (`slack_integration_missing`), or a bot connection was named without `slack_channel_id` (`invalid_action_params`) content: {} security: - project_api_key: [] components: securitySchemes: project_api_key: type: apiKey in: header name: X-Auth-Token description: >- Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.