Skip to main content
POST
Create Service Account

Authorizations

Authorization
string
header
required

Service Account Token authentication. To authenticate API requests:

  1. Create a Service Account Token:

    • Go to the Cerebrium Dashboard and open the API Keys page
    • Click Create Service Account, name it (e.g., "GitHub Actions CI/CD"), choose an expiry date, and click Create
    • Copy the token generated for the desired service account
  2. Use the Token: Include the service account token in the Authorization header of API requests: Authorization: Bearer <your-service-account-token>

  3. Best Practices:

    • Create separate service accounts for different environments (dev, staging, prod)
    • Store tokens securely as secrets in consuming applications or workflows
    • Set appropriate expiry dates and rotate tokens regularly
    • Never commit tokens to source control

For CI/CD integration examples, see the CI/CD documentation.

Path Parameters

project_id
string
required

Body

application/json
expiresIn
integer
required

Lifetime of the initial token in seconds (max 31536000, i.e. one year). Use 0 for a token that never expires.

grants
array
required

List of project IDs the service account is granted access to (1-50 entries).

name
string
required

Name of the service account (1-100 characters).

description
string

Description of the service account (max 500 characters).

Response

The created service account together with its initial token.

createdAt
string

Creation timestamp in RFC 3339 format.

createdByUserId
string

ID of the user who created the service account.

description
string

Description of the service account.

grants
array

List of project IDs the service account is granted access to.

id
string

Unique identifier of the service account.

name
string

Name of the service account.

projectId
string

ID of the project that owns the service account.

token
object

The initial token, with its id, secret, and expiry. The secret value is only returned once, at creation.