---
title: "Record an app connected for the workspace itself [write, owner or admin]"
method: POST
path: "/universes/{slug}/connections/complete"
---

# Record an app connected for the workspace itself \[write, owner or admin\]

`POST /universes/{slug}/connections/complete`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/universes/{slug}/connections/complete`
- Auth: HTTP bearer

The account is checked against the workspace's own accounts at the provider; without account_id its newest one for the app is used. From then on agents in every session of the workspace can call through it. 404 when the workspace has no such account.

## Path parameters

- `slug` string, required

## Request body

- object
  - `app` string, required
  - `account_id` string

## Response `201`

Created

- WorkspaceConnections
  - `sharing` boolean, required: Whether members can share connected apps with this workspace.
  - `can_connect` boolean: While sharing is on: whether the caller may connect an app for the workspace itself.
  - `connections` object[], required
    - `connection_id` string
    - `app` string
    - `app_name` string
    - `label` string
    - `shared_by` object
      - `user_id` string
      - `name` string, nullable
    - `shared_at` string, date-time
    - `mine` boolean: True when the caller is the person who shared it.
    - `workspace_owned` boolean: Present and true when the workspace itself owns the connection.

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/universes/:slug/connections/complete/post.md)

---

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