Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-correlation-id
string

Caller-supplied correlation ID; the server generates one when omitted.

Required string length: 8 - 128
Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]+$
Idempotency-Key
string

Enables exact replay for mutating requests for 24 hours.

Required string length: 16 - 200
Pattern: ^[A-Za-z0-9._:-]+$

Path Parameters

workspaceId
string
required

Body

application/json
name
string
required
Required string length: 1 - 120
roleId
string<uuid>
required
description
string
default:""
Maximum string length: 1000
environmentIds
string<uuid>[]
expiryPolicyDays
integer
default:90
Required range: 1 <= x <= 365

Response

Successful response.

serviceAccount
object
required