Skip to main content
POST
/
v3
/
projects
/
{project_id}
/
apps
/
{app_id}
/
base-image
Create Base Image Hash
curl --request POST \
  --url https://rest.cerebrium.ai/v3/projects/{project_id}/apps/{app_id}/base-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "aptPackages": "<array>",
  "baseImageUri": "<string>",
  "condaPackages": "<array>",
  "pipRequirements": "<array>",
  "preBuildCommands": "<array>",
  "shellCommands": "<array>"
}
'

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
​
app_id
string
required

Body

application/json
​
aptPackages
array

List of apt packages

​
baseImageUri
string

Base image URI to include in hash

​
condaPackages
array

List of conda packages

​
pipRequirements
array

List of pip requirements

​
preBuildCommands
array

Base64 encoded pre-build commands

​
shellCommands
array

Base64 encoded shell commands

Response

200

OK