Error Codes

The AI Data Foundry API uses standard HTTP status codes to indicate problems that occur during request processing.

The response body typically includes a JSON object with specific information about the error.

JSON Example

{
  "message": "Admin permission required for this project",
  "error": "Forbidden",
  "statusCode": 403
}

Client Errors (4xx)

Errors caused by incorrect client-side requests (e.g., invalid API key, missing file, unsupported format, etc.)

Status Code	Message	Description
`400 Bad Request`	`업로드할 파일이 필요합니다.` (An upload file is required.)	Returned when the `file` field containing file data cannot be found in a `multipart/form-data` request.
`400 Bad Request`	`folderId 는 양의 정수여야 합니다.` (folderId must be a positive integer.)	Returned when `folderId` on upload is not an integer or is zero or negative.
`401 Unauthorized`	`API Key 인증에 실패했습니다. 유효한 API Key를 사용하여 요청해 주세요.` (API Key authentication failed. Please use a valid API Key.)	Returned when the `Authorization` header is missing or the Bearer token (API key) is invalid.
`403 Forbidden`	`Project context could not be resolved`	Returned when the `projectId` path value is not a 10-character alphanumeric string, or no project matches it. The two cases are not distinguished.
`403 Forbidden`	`Permission denied: data.access.all`	Returned when the project exists but the API key user has no data access permission on it.
`403 Forbidden`	`Admin permission required for this project`	Returned when the user has data access but is not an administrator of the project.
`404 Not Found`	`폴더를 찾을 수 없습니다.` (Folder not found.)	Returned when no folder matches `folderId` on upload or that folder does not belong to the project.
`404 Not Found`	`Not Found`	For document status polling and export, returned identically whether the `uuid` does not exist, is not accessible, or is malformed.
`409 Conflict`	`{ "code": "NOT_EXPORTABLE", "status": "<current status>" }`	Returned by export when the document has not reached `succeeded` yet. This is the only response whose entire body is the object on the left — no `statusCode` or `message` wrapper. Confirm `succeeded` via the status API, then retry.
`413 Payload Too Large`	`파일 크기가 100MB를 초과합니다.` (The file size exceeds 100MB.)	Returned when the size of a single uploaded file exceeds the maximum size (100MB) allowed by the server.
`415 Unsupported Media Type`	`지원하지 않는 파일 형식입니다.` (Unsupported file format.)	Returned when the format of the uploaded file is not supported by the server. Check Supported Formats.

Server Errors (5xx)

Cases where the request was valid but processing failed due to unexpected server-side issues.

Status Code	Message	Description
`500 Internal Server Error`	`Internal server error`	Returned when request processing fails due to an unexpected internal server issue. Try again later, and contact the administrator if the problem persists.

Response Example

{
  "statusCode": 500,
  "message": "Internal server error"
}