---
title: "Prepare Application"
method: POST
path: "/api/v1/slack/applications/setup"
tags: ["Slack"]
---

# Prepare Application

`POST /api/v1/slack/applications/setup`

## Request body

- SlackSetupStart
  - `identity_id` string, uuid, required
  - `provisioning_workspace_id` string, uuid, required

## Response `200`

Successful Response

- SlackSetupStatus
  - `status` 'not_started' | 'needs_credentials' | 'pending' | 'ready' | 'failed' | 'unavailable', required
  - `provisioning_workspace_id` string, uuid, nullable
  - `retry_at` string, date-time, nullable
  - `error_code` 'setup_failed' | 'outcome_unknown' | 'quota_exceeded' | 'credentials_required', nullable

## Other responses

- `202` — Accepted
- `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/applications/setup/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)