---
title: "Create linked cloud"
method: POST
path: "/api/v1/clouds"
tags: ["Clouds"]
---

# Create linked cloud

`POST /api/v1/clouds`

## Request body

- LinkedCloud
  - `id` string, uuid
  - `name` string
  - `oauth` object
    - `clientId` string
    - `clientSecret` string
    - `scopes` string[]
    - `authUrl` string
    - `tokenUrl` string
    - `authStyle` 'autoDetect' | 'inParams' | 'inHeader'
    - `audience` string
    - `redirectUrl` string
    - `accessType` string
    - `responseType` string
    - `responseMode` string
  - `supportedSubscriptionEvents` object
    - `devices` string[]
    - `device` string[]
    - `resource` string[]
    - `staticDeviceEvents` boolean
  - `endpoint` object
    - `url` string
    - `rootCas` string[]
    - `insecureSkipVerify` boolean
    - `useSystemCas` boolean

## Response `200`

successful operation

- LinkedCloud
  - `id` string, uuid
  - `name` string
  - `oauth` object
    - `clientId` string
    - `clientSecret` string
    - `scopes` string[]
    - `authUrl` string
    - `tokenUrl` string
    - `authStyle` 'autoDetect' | 'inParams' | 'inHeader'
    - `audience` string
    - `redirectUrl` string
    - `accessType` string
    - `responseType` string
    - `responseMode` string
  - `supportedSubscriptionEvents` object
    - `devices` string[]
    - `device` string[]
    - `resource` string[]
    - `staticDeviceEvents` boolean
  - `endpoint` object
    - `url` string
    - `rootCas` string[]
    - `insecureSkipVerify` boolean
    - `useSystemCas` boolean

## Changes

- **2021-12-18** `29603f9af253` — 10 warning, 10 info
  - removed the request property `Endpoint`
  - removed the request property `Id`
  - removed the request property `Name`
  - removed the request property `OAuth`
  - …16 more
- **2020-10-27** `ec7285a7a143` — 10 warning, 10 info
  - removed the request property `endpoint`
  - removed the request property `id`
  - removed the request property `name`
  - removed the request property `oauth`
  - …16 more

[Change history](https://skmtc.dev/plgd-dev/apis/cloud2cloud-connector-api/changes/api/v1/clouds/post.md)

---

[API](https://skmtc.dev/plgd-dev/apis/cloud2cloud-connector-api.md) · [All operations](https://skmtc.dev/plgd-dev/apis/cloud2cloud-connector-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plgd-dev/cloud2cloud-connector-api/revisions/86e242574062/schema)