Skip to main content
POST
/
apps
Create App
curl --request POST \
  --url https://api.vela.dev/v1/apps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Order Service",
  "slug": "order-service"
}
'
{
  "app": {
    "id": "3f2a1b4c-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
    "accountId": "acc-uuid",
    "name": "Order Service",
    "slug": "order-service",
    "apiKeyPrefix": "vela_live_abc",
    "createdAt": "2024-06-01T12:00:00.000Z",
    "updatedAt": "2024-06-01T12:00:00.000Z"
  },
  "apiKey": "vela_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

Authorizations

Authorization
string
header
required

Client secret for management API access. Format: vela_cs_...

Body

application/json
name
string
required

App display name

slug
string

URL-friendly identifier. Auto-generated from name if omitted.

Response

201 - application/json

App created with API key

app
object
apiKey
string

Full API key (only returned on creation or rotation)