Platforms

A platform is a tenant on the gateway. Each platform has its own API keys, end users, wallet, LLM configs, agents, and MCP integrations — fully isolated from other platforms.

GET/v1/platforms/{platformId}

Retrieves a platform by ID.

Auth: Platform key (sk-plat_*).

bash

curl https://api.assistiv.ai/v1/platforms/{platformId} \
  -H "Authorization: Bearer sk-plat_your_key"

PATCH/v1/platforms/{platformId}

Updates platform properties. Only provided fields are changed.

Auth: Platform key.

Request Body

Name	Type	Required	Description
name	string	Optional	Updated display name.
slug	string	Optional	Updated slug.
settings	object	Optional	Updated settings. Set default_budget_usd to auto-create a monthly budget for new end users.

bash

curl -X PATCH https://api.assistiv.ai/v1/platforms/{platformId} \
  -H "Authorization: Bearer sk-plat_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Updated App",
    "settings": {
      "default_budget_usd": 10.00,
      "markup_percentage": 15
    }
  }'

DELETE/v1/platforms/{platformId}

Permanently deletes a platform and all associated data (cascading delete).

Auth: Platform key. Returns 204 No Content on success.

bash

curl -X DELETE https://api.assistiv.ai/v1/platforms/{platformId} \
  -H "Authorization: Bearer sk-plat_your_key"