Skip to main content
POST
/
api
/
deployments
Create deployment
curl --request POST \
  --url https://api.example.com/api/deployments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "provider": "aws_s3",
  "description": "<string>",
  "configuration": "<unknown>",
  "secrets": "<unknown>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "provider": "aws_s3",
  "organisationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organisation": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "displayName": "<string>",
    "onboarded": true,
    "themeLogo": "<string>",
    "themePrimaryColor": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "license": "<string>",
    "licenseData": "<unknown>",
    "url": "<string>",
    "preferences": "<unknown>",
    "deletedAt": "<string>"
  },
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "description": "<string>",
  "configuration": "<unknown>",
  "deletedAt": "<string>"
}

Body

application/json
name
string
required

Name of the deployment

provider
enum<string>
required

Cloud storage provider type (aws_s3, azure_storage, google_cloud_storage)

Available options:
aws_s3,
azure_storage,
google_cloud_storage
description
string | null

Description of the deployment

configuration
any

Provider-specific configuration settings

secrets
any | null

Provider-specific secrets (e.g., access keys, credentials)

Response

200 - application/json

The newly created deployment

The newly created deployment

id
string<uuid>
required

Unique identifier of the deployment

name
string
required

Name of the deployment

provider
enum<string>
required

Cloud storage provider type (aws_s3, azure_storage, google_cloud_storage)

Available options:
aws_s3,
azure_storage,
google_cloud_storage
organisationId
string<uuid>
required

ID of the organisation this deployment belongs to

organisation
object
required

Organisation associated with the deployment

createdAt
string
required

Timestamp when the deployment was created

updatedAt
string
required

Timestamp when the deployment was last updated

description
string

Description of the deployment

configuration
any

Provider-specific configuration settings

deletedAt
string

Timestamp when the deployment was deleted