---
title: "Connect app"
method: POST
path: "/api/v1/workspace/app/{app_name}"
---

# Connect app

`POST /api/v1/workspace/app/{app_name}`

Add an app to the specified workspace.

## Headers

- `workspace-id` string, required

## Cookies

- `apikey` string

## Request body

- ConnectAppRequest — Connect app request model.
  - `name` string, required
  - `description` string, required
  - `type` string, required
  - `protocol` -1 | 0 | 1 | 2, required — App protocol types.
  - `config` object, required

## Response `200`

Successful Response

- TaskApiResponseAppConnectionResponse
  - `tid` string, nullable
  - `r` AppConnectionResponse, required — Include redirect url to effectuate connection.
    - `app` IAppConnection, required — App connection model.
      - `name` string
      - `description` string
      - `type` string
      - `config` object, nullable
      - `protocol` -1 | 0 | 1 | 2 — App protocol types.
      - `status` string
    - `connection_url` string, nullable
    - `discovery_task` IAutomation — Task template model.
      - `workspace_id` string
      - `id` string
      - `task_template_id` string, nullable
      - `last_run_t` integer
      - `title` string
      - `t` integer
      - `type` 'discovery' | 'automation' | 'task' — Task types.
      - `task` ITask — Task configuration model.
        - `t` integer
        - `title` string, required
        - `body` string, required
        - `apps` object, required
        - `autonomy_level` string, required
        - `complexity` string, required
        - `attachments` object[]
      - `webhook_id` string, nullable
      - `is_active` integer
      - `entity_id` string, nullable
      - `triggers` ITrigger[], nullable
        - `name` string
        - `description` string
        - `icon` string
        - `schedule_arn` string, nullable
        - `trigger_id` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/smooth/apis/circlemind-zero.md) · [All operations](https://skmtc.dev/smooth/apis/circlemind-zero/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smooth/circlemind-zero/revisions/472956a12adf/schema)