---
title: "POST /api/internal/desktop/cloud-profile/connect"
method: POST
path: "/api/internal/desktop/cloud-profile/connect"
tags: ["Desktop"]
---

# POST /api/internal/desktop/cloud-profile/connect

`POST /api/internal/desktop/cloud-profile/connect`

## Request body

- object
  - `name` string, required
  - `source` string

## Response `200`

Connect cloud profile

- object
  - `browserUrl` string
  - `error` string
  - `status` object, required
    - `connected` boolean, required
    - `polling` boolean
    - `userId` string, nullable
    - `userName` string, nullable
    - `userEmail` string, nullable
    - `connectedAt` string, nullable
    - `models` object[]
      - `id` string, required
      - `name` string, required
      - `provider` string
    - `cloudUrl` string, required
    - `linkUrl` string, nullable, required
    - `activeProfileName` string, required
    - `profiles` object[], required
      - `name` string, required
      - `cloudUrl` string, uri, required
      - `linkUrl` string, uri, required
      - `connected` boolean, required
      - `polling` boolean
      - `userId` string, nullable
      - `userName` string, nullable
      - `userEmail` string, nullable
      - `connectedAt` string, nullable
      - `modelCount` integer, required
  - `configPushed` boolean, required

## Changes

- **2026-04-08** `a419c967cd2f` — 1 info
  - added the new optional request property `source`
- **2026-04-07** `d8eef2729f1c` — 2 info
  - added the optional property `status/profiles/items/userId` to the response with the `200` status
  - added the optional property `status/userId` to the response with the `200` status
- **2026-03-23** `245e6f96216b` — 1 info
  - endpoint added
- **2026-03-19** `239b3cc94d80` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/nexu-io/apis/nexu-controller-api/changes/api/internal/desktop/cloud-profile/connect/post.md)

---

[API](https://skmtc.dev/nexu-io/apis/nexu-controller-api.md) · [All operations](https://skmtc.dev/nexu-io/apis/nexu-controller-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nexu-io/nexu-controller-api/revisions/ee3237405da6/schema)