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

# Attach Slack Thread

`POST /v1/slack/threads/attach`

Routes a Slack thread to a workspace. Agent-mode requests can target only their authenticated workspace; use user or API-key authentication to switch a thread to another workspace.

## 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
      - `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/tryreplicas/apis/replica-api.md) · [All operations](https://skmtc.dev/tryreplicas/apis/replica-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryreplicas/replica-api/revisions/aa3b4c932f7a/schema)