List Deployments

GEThttps://{organization}.blackbox.ai/dedicated/list

List the dedicated deployments owned by the caller, along with the templates they were built from.

Returns every dedicated deployment owned by the caller (scoped by the account attached to the API key) plus the full template catalog for convenience — so a UI can render both without a second request.

Deployments are scoped by user email. This endpoint returns only deployments owned by the caller — it never lists deployments belonging to other accounts.

Headers

Authorizationstringrequired

API Key of the form Bearer <api_key>.

Response

templatesarray

Full list of available templates. Same shape as the templates array returned by GET /dedicated/templates.

deploymentsarray

The caller's deployments. Each item has the same shape as the response from POST /dedicated/create-deployment.

Deployment Object

deployment_idstring

UUID identifying the deployment.

modelstring

Client-facing model id (e.g. dedicated/openai/gpt-oss-20b-Ab3xY9K1mN2p).

model_namestring

Template name the deployment was created from.

statusstring | null

Current lifecycle status.

scalingobject

Effective scaling policy (min_replicas, max_replicas).

descriptionstring | null

Free-form description supplied at creation.

created_atstring

ISO 8601 timestamp of creation.

updated_atstring

ISO 8601 timestamp of the last update.

Request Example

curl https://{organization}.blackbox.ai/dedicated/list \
  -H "Authorization: Bearer $BLACKBOX_API_KEY"

import os
import requests

response = requests.get(
    "https://{organization}.blackbox.ai/dedicated/list",
    headers={"Authorization": f"Bearer {os.environ['BLACKBOX_API_KEY']}"},
)

print(response.json())

const response = await fetch("https://{organization}.blackbox.ai/dedicated/list", {
  headers: { Authorization: `Bearer ${process.env.BLACKBOX_API_KEY}` },
});

const data = await response.json();
console.log(data);

Response Example

{
  "templates": [
    {
      "name": "openai/gpt-oss-20b",
      "type": "text2text",
      "metadata": {
        "vendor": "openai",
        "context_window_k": 128,
        "size_b": 20,
        "license": "apache-2.0"
      }
    }
  ],
  "deployments": [
    {
      "deployment_id": "9c8b7a6d-5e4f-3a2b-1c0d-ef1234567890",
      "model": "dedicated/openai/gpt-oss-20b-Ab3xY9K1mN2p",
      "model_name": "openai/gpt-oss-20b",
      "status": "running",
      "scaling": {
        "min_replicas": 1,
        "max_replicas": 4
      },
      "description": "Prod inference for docs assistant",
      "created_at": "2026-07-10T14:22:05Z",
      "updated_at": "2026-07-10T14:24:11Z"
    }
  ]
}