Public API

프로젝트 생성

Management key required. 초기 예산을 선택하여 Team 프로젝트를 생성합니다.

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