Run App
Execute code on a deployed app.
Authorizations
Service Account Token authentication. To authenticate API requests:
-
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
-
Use the Token: Include the service account token in the Authorization header of API requests:
Authorization: Bearer <your-service-account-token> -
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.
Query Parameters
Name of the app to run against
Path of the Python file to execute. Must have a .py extension
Name of the function to call within the file
Compute type to run on. One of ADA_L4, ADA_L40, AMPERE_A10, AMPERE_A100_40GB, AMPERE_A100_80GB, HOPPER_H100, CPU, INF2, TRN1, TURING_T4. Defaults to CPU
Number of CPU cores (0.1-12). Defaults to 2
Memory in GB (0.5-64). Defaults to 2
Number of GPUs (0-8). Defaults to 0
Base image digest to run on, as returned by the base-image endpoint. Defaults to the standard Python base image
Region to run in. Defaults to the app's deployed region