---
title: "Attach Slack thread"
method: POST
path: "/v1/slack/threads/attach"
tags: ["Slack"]
---

# Attach Slack thread

`POST /v1/slack/threads/attach`

## Request

- Base URL: `https://api.replicas.dev`
- URL: `https://api.replicas.dev/v1/slack/threads/attach`
- Auth: HTTP bearer

Routes replies in a Slack thread to a workspace.

## Headers

- `X-Replicas-Api-Version` '2026-10-07'

## Request body

- SlackThreadAttachRequest
  - `channel_id` string, required: Slack channel ID containing the thread.
  - `thread_ts` string, required: Slack thread timestamp.
  - `workspace_id` string, uuid: Target workspace ID. Required outside agent mode.

## Response `200`

Slack thread routed

- SlackThreadAttachResponse
  - `thread` SlackThreadRecord, required
    - `id` string, uuid, required
    - `organization_id` string, uuid, required
    - `slack_team_id` string, required
    - `channel_id` string, required
    - `thread_ts` string, required
    - `workspace_id` string, uuid, nullable, required
    - `status` string, required
    - `metadata` SlackThreadMetadata, required
      - `channel_id` string, required
      - `channel_name` string
      - `thread_ts` string, required
      - `message_ts` string
      - `routed_message_timestamps` string[]
      - `original_message` string, required
      - `user_id` string, required
      - `user_name` string
      - `images` object[]
      - `workspace_target` object
        - `label` string, required
      - `workspace` object
        - `id` string, uuid, required
        - `coding_agent` string
        - `task_description` string, required
        - `created_at` string, date-time, required
    - `last_processed_message_ts` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `workspace` object, required
    - `id` string, uuid, required
    - `name` string, required

## Other responses

- `400`: Bad request - Missing or invalid parameters
- `401`: Unauthorized - Invalid or missing API key
- `403`: The workspace agent cannot route this Slack thread
- `404`: Resource not found
- `409`: Conflict - Resource already exists or operation conflicts with current state
- `500`: Internal server error

---

[API](https://skmtc.dev/replicas/apis/replicas-api.md) - [All operations](https://skmtc.dev/replicas/apis/replicas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/replicas/apis/replicas-api/revisions/2703ac1c9cb7?raw)