Authentication and Quick Start

Theta EdgeCloud API keys are scoped to a single project. The project ID in the URL must match the project that owns the key.

Create an API key

Open the Theta EdgeCloud Dashboard, select Settings > Projects, choose the intended project, and then use Create API Key in the project's API Keys section. See EdgeCloud API Keys for the complete Dashboard workflow.

The plaintext key is shown only when it is created. Store it in a secret manager and never commit it to source control.

Configure your shell

In a Bash shell, set the production endpoint and project ID. The read -rsp command prompts for the API key without displaying it.

export TEC_BASE_URL="https://controller.thetaedgecloud.com"
export TEC_PROJECT_ID="prj_..."
read -rsp "Theta EdgeCloud API key: " TEC_API_KEY
export TEC_API_KEY
echo

Verify the credentials with a read-only request:

curl -sS \
  -H "x-api-key: ${TEC_API_KEY}" \
  "${TEC_BASE_URL}/v1/projects/${TEC_PROJECT_ID}/gpu-resources"

Remove the key from the shell when it is no longer needed:

unset TEC_API_KEY

Authentication responses

An API key from one project cannot access another project, including another project in the same organization. Project API keys do not grant organization administration permissions.