에러 코드
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 상태별로 확인할 수 있어요.
오류 메시지는 서버가 반환하는 원문이 확인된 경우에만 표시해요.
—요청 형식 또는 필드 검증에 실패했어요.
—토큰이 binding 여러 개를 허용하지만 bindingId가 없어요.
bindingId is required (token allows multiple bindings)—id가 UUID 형식이 아니에요.
Validation failed (uuid is expected)—Bearer 토큰이 없거나 유효하지 않아요.
Missing bearer token—토큰에 storage scope가 없어요.
Token scope does not include storage accesstoken_missingBearer 토큰이 없어요.
Missing bearer tokentoken_invalid토큰이 무효·폐기·만료됐어요.
—토큰 또는 세션의 권한 범위가 요청을 허용하지 않아요.
—토큰에 해당 binding의 write 권한이 없어요.
Token lacks 'write' on binding <bindingId>—토큰에 해당 binding의 read 권한이 없어요.
Token lacks 'read' on binding <bindingId>—토큰에 해당 binding의 delete 권한이 없어요.
Token lacks 'delete' on binding <bindingId>token_not_authorized토큰 권한 범위 밖이에요.
—요청한 리소스를 찾을 수 없어요.
agent_not_foundAgent를 찾을 수 없어요.
workflow_not_found워크플로우를 찾을 수 없어요.
app_not_found앱이 없거나 release grant 범위 밖이에요.
—요청이 현재 리소스 상태와 충돌해요.
agent_name_ambiguous조직 안에서 Agent 이름이 중복돼요.
workflow_invalidAgent가 무효로 보고한 워크플로우예요.
본문 reason에 사유, invalidCode에 무효 종류가 담겨요.
—요청 한도 또는 Agent의 최소 폴링 간격을 초과했어요.
—토큰 읽기 요청 한도를 초과했어요.
Rate limit exceeded for api token reads (minute: 61/60)—최소 폴링 간격보다 자주 조회했어요.
응답에 Retry-After, pollIntervalSeconds, retryAfterSeconds가 포함돼요.
—서버에서 요청을 처리하지 못했어요.