티어, 동시 실행과 대기열, 월 한도, 워크스페이스 지출 한도, API 요청 속도를 돌려줍니다
GET /v1/limits
| 방식 | 허용 | 조건 |
|---|
API 키 (Authorization: Bearer xci_live_…) | 가능 | 키 권한 read (run 키도 가능) |
| 콘솔 세션 쿠키 | 가능 | 조직 역할 owner, admin, developer |
참고 서버 구현(2026-10-12 dev 기준)이 계약 초안과 다른 점
- workspaceid와 apikey_id 쿼리는 무시합니다
| 이름 | 위치 | 타입 | 필수 | 설명 |
|---|
org_id | 쿼리 | string | | 콘솔 세션은 필수, API 키는 무시(키의 조직) |
| 필드 | 타입 | 항상 | 설명 |
|---|
organization_id | string | 항상 | 조직 ID |
tier | integer | 항상 | 티어 |
tier_name | string | | 티어 이름 |
concurrency | object | 항상 | 동시 실행 한도와 지금 실행 수 |
concurrency.limit | integer | 항상 | 한도 |
concurrency.running | integer | 항상 | 실행 중 |
queue | object | 항상 | 대기열 상한과 지금 대기 수 |
queue.limit | integer | 항상 | 한도 |
queue.queued | integer | 항상 | 대기 중 |
monthly | object | 항상 | 티어 월 한도와 사용액, limit이 null이면 상한 없음 |
monthly.limit_micro_usd | integer | | 금액(µUSD 정수), 최소 0, null 가능 |
monthly.limit_usd | string | | 같은 금액의 USD 문자열(소수 6자리) |
monthly.used_micro_usd | integer | | 이번 달 정산액 + 실행 중인 잡이 이미 쓴 금액, 최소 0 |
monthly.used_usd | string | | 같은 금액의 USD 문자열(소수 6자리), 형식 ^-?[0-9]+\.[0-9]{6}$ |
monthly.resets_at | timestamp | | 다음 달 1일 00:00 UTC |
workspaces | array<object> | 항상 | 호출 범위의 워크스페이스별 지출 한도와 지출, API 키는 자기 것만 |
workspaces[].workspace_id | string | | 워크스페이스 ID |
workspaces[].name | string | | 이름 |
workspaces[].monthly_limit_micro_usd | integer | | 금액(µUSD 정수), 최소 0, null 가능 |
workspaces[].monthly_limit_usd | string | | 같은 금액의 USD 문자열(소수 6자리) |
workspaces[].month_spend_micro_usd | integer | | 금액(µUSD 정수), 최소 0 |
workspaces[].month_spend_usd | string | | 같은 금액의 USD 문자열(소수 6자리), 형식 ^-?[0-9]+\.[0-9]{6}$ |
api_requests | object | 항상 | API 키 요청 속도, 아직 강제하지 않고(enforced false) 창 안에서 기준을 넘으면 소유자와 관리자에게 급증 메일만 갑니다 |
api_requests.enforced | boolean | 항상 | 강제 여부 |
api_requests.window_seconds | integer | 항상 | 창 길이(초) |
api_requests.alert_threshold_requests | integer | 항상 | 알림 기준 요청 수 |
api_requests.requests_in_window | integer | | 최근 창 안에서 기록된 키 요청 수 |
next_tier | string | | 다음 티어 조건, 없으면 null |
{
"organization_id": "org_7Kq2m9ZtP3",
"tier": 1,
"tier_name": "Tier 1",
"concurrency": {
"limit": 2,
"running": 1
},
"queue": {
"limit": 10,
"queued": 0
},
"monthly": {
"limit_micro_usd": 100000000,
"limit_usd": "100.000000",
"used_micro_usd": 475200,
"used_usd": "0.475200",
"resets_at": "2026-11-01T00:00:00Z"
},
"workspaces": [
{
"workspace_id": "wrk_3fK9Qm2Zp8",
"name": "ios-app",
"monthly_limit_micro_usd": 50000000,
"monthly_limit_usd": "50.000000",
"month_spend_micro_usd": 475200,
"month_spend_usd": "0.475200"
}
],
"api_requests": {
"enforced": false,
"window_seconds": 600,
"alert_threshold_requests": 1000,
"requests_in_window": 12
},
"next_tier": "…"
}
| HTTP | 코드 | 다시 시도 | 뜻 |
|---|
| 400 | invalid_request | 아니오 | 본문이나 쿼리가 검증에 실패했습니다, error.details.fields에 문제 필드가 있습니다 |
| 401 | api_key_required | 아니오 | API 키 엔드포인트에 Authorization: Bearer 헤더가 없습니다 |
| 401 | api_key_revoked_leaked | 아니오 | 공개 유출 신고로 자동 폐기된 키입니다, 새 키를 발급하세요 |
| 401 | invalid_api_key | 아니오 | 모르는 키이거나 폐기, 만료, 체크섬 불일치입니다(종료된 xeno_ 접두사 포함) |
| 401 | session_required | 아니오 | 콘솔 엔드포인트를 유효한 콘솔 세션 쿠키 없이 불렀습니다 |
| 403 | insufficient_permission | 아니오 | 역할이나 키 권한(run/read)이 이 요청을 허용하지 않습니다 |
| 404 | not_found | 아니오 | 자원이 없거나 이 호출자에게 보이지 않습니다 |
| 429 | rate_limited | 가능 | 이 키 또는 조직의 요청이 너무 많습니다, retryafters만큼 기다리세요 |
| 500 | internal_error | 가능 | 예상하지 못한 오류입니다, 다시 시도하고 반복되면 request_id와 함께 알려 주세요 |
오류 봉투 모양과 전체 코드 표는 오류 코드에 있습니다
curl "https://xenoci.com/api/runner/v1/limits" \
-H "Authorization: Bearer $XENOCI_API_KEY"
