cURL
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" }
Creates a new app and returns the generated API key. The full API key is only returned in this response — store it securely.
Client secret for management API access. Format: vela_cs_...
vela_cs_...
App display name
URL-friendly identifier. Auto-generated from name if omitted.
App created with API key
Show child attributes
Full API key (only returned on creation or rotation)