Skip to Content

에러 코드

Deplite API의 오류 응답은 API 종류에 따라 두 가지 형식으로 와요.

워크플로우 호출 응답

워크플로우 호출 API는 statusCode, message, error와 code를 포함해요.

{ "statusCode": 400, "message": "Invalid request", "error": "Bad Request", "code": "invalid_request" }

그 밖의 API 응답

워크플로우 호출 외의 API는 Nest 기본 오류 형식인 statusCode, message, error를 사용해요.

{ "statusCode": 400, "message": "Invalid request", "error": "Bad Request" }

상태별 에러 코드

공통 오류와 엔드포인트별 오류를 HTTP 상태별로 확인할 수 있어요.
오류 메시지는 서버가 반환하는 원문이 확인된 경우에만 표시해요.

400
—

요청 형식 또는 필드 검증에 실패했어요.

—

토큰이 binding 여러 개를 허용하지만 bindingId가 없어요.

bindingId is required (token allows multiple bindings)
—

cleanupRule이 없거나 TTL 값이 허용 범위를 벗어났어요.

—

bindingId가 UUID 형식이 아니거나 status 값이 허용되지 않아요.

—

필수 필드가 없거나 값이 허용 길이를 벗어났어요.

invalid_request

입력 검증 실패, 요청 형식 오류 또는 debug 사용이에요.

ref_required

ref 제한이 있지만 요청에 ref가 없어요.

ref_not_allowed

YAML에서 허용하지 않은 ref예요.

ref_blocked

콘솔에서 좁힌 ref 범위에 들지 않아요.

invalid_params

호출 시점에 검증한 params가 선언된 schema와 달라요.

invalid_approval

approval 모양 또는 크기가 잘못됐어요.

approval_required

선언된 승인이 요청에 없어요.

approval_method_not_allowed

선언되지 않은 승인 방식이에요.

invalid_request

after 또는 limit 값이 허용 범위를 벗어났어요.

invalid_request

요청 필드가 없거나 형식·길이가 올바르지 않아요.

invalid_request

회수된 릴리스는 게시할 수 없어요.

signature_required

앱에서 서명을 요구하지만 파일 릴리스에 서명이 없어요.

invalid_request

게시 상태가 아닌 릴리스는 회수할 수 없어요.

401
—

Bearer 토큰이 없거나 유효하지 않아요.

Missing bearer token
—

토큰에 storage scope가 없어요.

Token scope does not include storage access
token_missing

Bearer 토큰이 없어요.

Missing bearer token
403
—

토큰 또는 세션의 권한 범위가 요청을 허용하지 않아요.

—

토큰에 해당 binding의 write 권한이 없어요.

Token lacks 'write' on binding <bindingId>
—

토큰에 해당 binding의 read 권한이 없어요.

Token lacks 'read' on binding <bindingId>
—

토큰에 read 권한이 없거나 binding 범위 밖이에요.

Token lacks 'read' permission
—

토큰에 해당 binding의 delete 권한이 없어요.

Token lacks 'delete' on binding <bindingId>
token_not_authorized

토큰 권한 범위 밖이에요.

not_callable

호출 허용 선언이 없어요.

not_callable

워크플로우에 호출 허용 선언이 없어요.

workflow_locked

콘솔에서 워크플로우 호출이 잠겼어요.

agent_suspended

Agent가 정지됐어요.

token_not_authorized

앱 릴리스 create 또는 아티팩트 binding의 storage read 권한이 없어요.

token_not_authorized

앱에 대한 release grant가 없어요.

token_not_authorized

앱에 대한 release publish 권한이 없어요.

token_not_authorized

앱에 대한 release yank 권한이 없어요.

404
—

요청한 리소스를 찾을 수 없어요.

workflow_not_found

워크플로우를 찾을 수 없어요.

job_not_found

Job이 없거나 현재 토큰으로 조회할 수 없어요.

file_not_found

아티팩트 파일을 찾을 수 없어요.

409
—

요청이 현재 리소스 상태와 충돌해요.

agent_name_ambiguous

조직 안에서 Agent 이름이 중복돼요.

workflow_invalid

Agent가 무효로 보고한 워크플로우예요.
본문 reason에 사유, invalidCode에 무효 종류가 담겨요.

idempotency_conflict

같은 Idempotency-Key에 다른 요청 본문을 보냈어요.

release_exists

같은 앱에 같은 version의 릴리스가 이미 있어요.

release_conflict

릴리스 생성 중 상태 충돌이 발생했어요.

429
—

요청 한도 또는 Agent의 최소 폴링 간격을 초과했어요.

—

토큰 읽기 요청 한도를 초과했어요.

Rate limit exceeded for api token reads (minute: 61/60)
—

최소 폴링 간격보다 자주 조회했어요.
응답에 Retry-After, pollIntervalSeconds, retryAfterSeconds가 포함돼요.

rate_limited

워크플로우 또는 토큰 호출 한도를 초과했어요.

rate_limited

Job 조회 rate limit을 초과했어요.

500
—

서버에서 요청을 처리하지 못했어요.

관련 문서

최종 수정 일자: