---
title: "Upload File"
method: POST
path: "/api/v1/slack/connections/{connection_id}/files"
tags: ["Slack"]
---

# Upload File

`POST /api/v1/slack/connections/{connection_id}/files`

## Path parameters

- `connection_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- SlackFileUpload
  - `conversation_id` string, required
  - `filename` string, required
  - `content_base64` string, required
  - `title` string, nullable
  - `initial_comment` string, nullable
  - `thread_ts` string, nullable

## Response `200`

Successful Response

- SlackOperationResponse
  - `id` string, uuid, required
  - `connection_id` string, uuid, required
  - `operation` 'reaction_add' | 'reaction_remove' | 'pin_add' | 'pin_remove' | 'message_update' | 'message_delete' | 'file_upload' | 'conversation_join' | 'conversation_leave' | 'processing_status', required
  - `status` 'in_progress' | 'succeeded' | 'failed' | 'unknown', required
  - `conversation_id` string, required
  - `message_ts` string, nullable
  - `file_id` string, nullable
  - `error_code` string, nullable
  - `retry_after` integer, nullable
  - `processing_status` 'active' | 'processing' | 'suspended' | 'closed', nullable
  - `agent_status` 'active' | 'processing' | 'suspended' | 'closed', nullable

## Other responses

- `422` — Validation Error
- `4XX` — Client error with Support Agent information.
- `5XX` — Server error with Support Agent information.

## Changes

- **2026-10-01** `3e0d51f919a7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/inkbox/apis/inkbox-api/changes/api/v1/slack/connections/:connection_id/files/post.md)

---

[API](https://skmtc.dev/inkbox/apis/inkbox-api.md) · [All operations](https://skmtc.dev/inkbox/apis/inkbox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inkbox/apis/inkbox-api/revisions/5cbaa42f14f7?raw)