Skip to main content
POST
Assign Domain to App

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
domain_id
string
required

Body

application/json
appId
string
required

The ID of the app to assign the domain to.

Response

The mapping created between the domain and the app.

appId
string

ID of the app the domain is assigned to.

createdAt
string

Timestamp when the mapping was created (RFC 3339).

domainId
string

ID of the custom domain.

id
string

Unique identifier of the domain-to-app mapping.

projectId
string

ID of the project the domain belongs to.

updatedAt
string

Timestamp when the mapping was last updated (RFC 3339).