---
title: "Start installing a Slack agent's app"
method: POST
path: "/api/v1/agent-definitions/{definition_id}/slack-connection/install"
tags: ["authed"]
---

# Start installing a Slack agent's app

`POST /api/v1/agent-definitions/{definition_id}/slack-connection/install`

## Request

- Base URL: `https://api.teaflask.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.teaflask.com/api/v1/agent-definitions/{definition_id}/slack-connection/install`
- Auth: none declared

The link to Slack's install page for the agent's app; Slack then
returns the member to the agent's page.

## Path parameters

- `definition_id` string, uuid, required: The agent's id, as list_agent_definitions returns it.

## Response `200`

Successful Response

- SlackInstallStart
  - `authorize_url` string, required: Slack's page that installs the app; valid for ten minutes.

## Other responses

- `401`: Unauthorized
- `403`: The caller may not manage the organization's Slack setup, or Slack agents aren't available for the organization
- `404`: The agent doesn't exist, or its Slack setup hasn't started
- `405`: Method not allowed
- `409`: The app's credentials haven't been pasted yet
- `422`: The agent is a website agent, or the request wasn't valid
- `500`: Internal server error
- `503`: Slack isn't set up on this server

---

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