Public API

建立專案

Management key required. 建立團隊專案,可同時設定初始預算。

POST
/public/v1/projects

Management key required. Use a Management API Key (mgmt-...) for your Team, created by a Team Owner.

Create a project with an optional initial budget. Each Team can have at most 20 active projects, including the default project. Names must be unique within the account.

Omitting budget or passing null or {} creates an unlimited budget. The project and initial budget are created together. Save the returned project UUID for later requests.

Send a JSON object of at most 64 KiB. Unknown fields are rejected. POST does not support idempotent replay.

Authorization

ManagementKeyBearer
AuthorizationBearer <token>

Management key required. Send Authorization: Bearer mgmt-....

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/public/v1/projects" \  -H "Content-Type: application/json" \  -d '{    "name": "customer-123",    "budget": {      "monthly_limit": {        "value": "100.00",        "currency": "usd"      }    }  }'
{  "object": "project",  "id": "019a6eab-7c00-7000-8000-000000000123",  "name": "customer-123",  "description": "",  "status": "active",  "is_default": false,  "budget": {    "daily_limit": {      "value": "0.00000000",      "currency": "usd"    },    "weekly_limit": {      "value": "0.00000000",      "currency": "usd"    },    "monthly_limit": {      "value": "100.00000000",      "currency": "usd"    },    "total_limit": {      "value": "0.00000000",      "currency": "usd"    },    "daily_alert": {      "value": "0.00000000",      "currency": "usd"    },    "monthly_alert": {      "value": "0.00000000",      "currency": "usd"    },    "usage_alert_percent": 0  },  "created_at": "2026-11-11T00:00:00Z",  "request_id": "req_example"}

Last updated on