워크스페이스의 잡 로그 항목과 API 요청 로그 항목을 최신순으로 돌려줍니다
GET /v1/logs
| 방식 | 허용 | 조건 |
|---|
API 키 (Authorization: Bearer xci_live_…) | 가능 | 키 권한 read (run 키도 가능) |
| 콘솔 세션 쿠키 | 가능 | 조직 역할 owner, admin, developer |
- 잡 항목은 잡 표에서, 요청 항목은 서버가 API 키 요청마다 남긴 기록(시각, 키, 메서드, 경로, 상태, 지연, request_id)에서 옵니다, 요청 기록은 30일 보존됩니다
- 콘솔 세션은
workspace_id를 꼭 보냅니다
| 이름 | 위치 | 타입 | 필수 | 설명 |
|---|
workspace_id | 쿼리 | string | | 콘솔 세션은 워크스페이스가 필요한 곳에서 필수, API 키는 생략하거나 키의 워크스페이스와 같아야 합니다 |
kind | 쿼리 | all | job | request | | all, job, request, 기본 "all" |
status | 쿼리 | string | | ok, error, 잡 상태 값(잡 항목만), 2xx부터 5xx 또는 정확한 HTTP 상태(요청 항목만) |
from | 쿼리 | string | | UTC 날짜(포함) 또는 RFC 3339 시각 |
to | 쿼리 | string | | UTC 날짜(포함) 또는 RFC 3339 시각(미포함) |
api_key_id | 쿼리 | string | | 이 키의 잡만 |
source | 쿼리 | cli | mcp | github_action | api | playground | batch | | 잡 항목만, 지정하면 요청 항목은 빠집니다 |
q | 쿼리 | string | | 잡 ID, 저장소, 오류 코드 또는 요청 ID, 경로의 대소문자 구분 없는 부분 문자열, 200자 이하 |
limit | 쿼리 | integer | | 한 페이지 크기, 최소 1, 최대 100, 기본 20 |
cursor | 쿼리 | string | | 이전 응답의 next_cursor |
| 필드 | 타입 | 항상 | 설명 |
|---|
data | array<object> | 항상 | 항목 배열 |
data[].id | string | 항상 | 잡 항목은 job…, 요청 항목은 req… |
data[].kind | job | request | 항상 | job 또는 request |
data[].at | timestamp | 항상 | 시각 |
data[].status | string | 항상 | 잡은 잡 상태, 요청은 HTTP 상태 문자열 |
data[].ok | boolean | 항상 | 잡은 실패 계열이 아닌지, 요청은 HTTP 400 미만인지 |
data[].workspace_id | string | 항상 | 워크스페이스 ID |
data[].api_key_id | string | | API 키 ID, null 가능 |
data[].source | cli | mcp | github_action | api | playground | batch | | 잡 항목만, 제출 경로, null 가능 |
data[].summary | string | 항상 | 한 줄 요약 |
data[].job | object | | 잡 항목의 상세, null 가능 |
data[].job.job_id | string | | 잡 ID |
data[].job.status | queued | preparing | running | succeeded | failed | cancelled | credit_exhausted | platform_error | timed_out | | queued(대기), preparing(VM 준비), running(실행 중), succeeded(성공), failed(실패), cancelled(취소), creditexhausted(잔액 소진 중단), platformerror(플랫폼 오류), timed_out(제한 시간 초과) |
data[].job.source_kind | string | | 제출 경로 |
data[].job.repository | string | | owner/name, null 가능 |
data[].job.xcode | string | | Xcode 버전, null 가능 |
data[].job.batch_id | string | | 배치 ID, null 가능 |
data[].job.recipe_id | string | | 레시피 ID, null 가능 |
data[].job.created_at | timestamp | | 만든 시각 |
data[].job.started_at | string | | 시작 시각 |
data[].job.ended_at | string | | 끝난 시각 |
data[].job.run_seconds | integer | | 실행 초, null 가능 |
data[].job.billed_minutes | integer | | 과금 분, null 가능 |
data[].job.amount_micro_usd | integer | | 금액(µUSD 정수), 최소 0 |
data[].job.amount_usd | string | | 같은 금액의 USD 문자열(소수 6자리), 형식 ^-?[0-9]+\.[0-9]{6}$ |
data[].job.error_code | string | | 오류 코드, null 가능 |
data[].job.exit_code | integer | | 종료 코드, null 가능 |
data[].job.log_url | string | | 로그 URL |
data[].request | object | | 요청 항목의 상세, null 가능 |
data[].request.request_id | string | | 요청 ID |
data[].request.method | string | | 결제 수단 |
data[].request.path | string | | 경로만, 쿼리 문자열은 저장하지 않습니다 |
data[].request.http_status | integer | | HTTP 상태 |
data[].request.latency_ms | integer | | 지연(ms), 최소 0 |
next_cursor | string | 항상 | 다음 페이지 커서, 마지막이면 null, null 가능 |
retention_days | integer | 항상 | 요청 항목 보존 일수, 30 |
{
"data": [
{
"id": "job_2Qm7Xp9Lk4",
"kind": "job",
"at": "2026-10-12T03:11:05Z",
"status": "succeeded",
"ok": true,
"workspace_id": "wrk_3fK9Qm2Zp8",
"api_key_id": "key_8Pz4Nk1Rt6",
"source": "cli",
"summary": "acme/ios-app bash ci.sh 3분 $0.1188",
"job": {
"job_id": "job_2Qm7Xp9Lk4",
"status": "succeeded",
"source_kind": "cli",
"repository": "acme/ios-app",
"xcode": "27.0",
"batch_id": null,
"recipe_id": null,
"created_at": "2026-10-12T03:11:05Z",
"started_at": "…",
"ended_at": "…",
"run_seconds": 125,
"billed_minutes": 3,
"amount_micro_usd": 118800,
"amount_usd": "0.118800",
"error_code": null,
"exit_code": 0,
"log_url": "…"
},
"request": null
}
],
"next_cursor": "…",
"retention_days": 30
}
| 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/logs?kind=job&status=error&limit=20" \
-H "Authorization: Bearer $XENOCI_API_KEY"
