본문으로 건너뛰기

파일 삭제

업로드나 결과물을 지금 지웁니다

DELETE /v1/files/{file_id}

인증

방식허용조건
API 키 (Authorization: Bearer xci_live_…)가능키 권한 run (read 키는 403 insufficient_permission)
콘솔 세션 쿠키가능조직 역할 owner, admin, developer, 같은 출처의 Origin 헤더 필요

참고 서버 구현(2026-10-12 dev 기준)이 계약 초안과 다른 점

  • 아직 끝나지 않은 잡에 묶인 업로드는 409 conflict입니다

매개변수

이름위치타입필수설명
file_id경로string필수파일 ID(upl 또는 art), 형식 ^(upl|art)_[A-Za-z0-9]+$

응답

204

본문 없음

오류

HTTP코드다시 시도뜻
400invalid_request아니오본문이나 쿼리가 검증에 실패했습니다, error.details.fields에 문제 필드가 있습니다
401api_key_required아니오API 키 엔드포인트에 Authorization: Bearer 헤더가 없습니다
401api_key_revoked_leaked아니오공개 유출 신고로 자동 폐기된 키입니다, 새 키를 발급하세요
401invalid_api_key아니오모르는 키이거나 폐기, 만료, 체크섬 불일치입니다(종료된 xeno_ 접두사 포함)
401session_required아니오콘솔 엔드포인트를 유효한 콘솔 세션 쿠키 없이 불렀습니다
403insufficient_permission아니오역할이나 키 권한(run/read)이 이 요청을 허용하지 않습니다
404not_found아니오자원이 없거나 이 호출자에게 보이지 않습니다
409conflict아니오자원 상태가 이 요청을 허용하지 않습니다, 다시 읽은 뒤 시도하세요
429rate_limited가능이 키 또는 조직의 요청이 너무 많습니다, retryafters만큼 기다리세요
500internal_error가능예상하지 못한 오류입니다, 다시 시도하고 반복되면 request_id와 함께 알려 주세요

오류 봉투 모양과 전체 코드 표는 오류 코드에 있습니다

예시

curl -X DELETE "https://xenoci.com/api/runner/v1/files/upl_4Hq8ZkT2mP" \
  -H "Authorization: Bearer $XENOCI_API_KEY"

다음 단계