---
title: "작업 결과 파일 삭제 (ADR-081 D-9)"
method: DELETE
path: "/v1/jobs/{job_id}/artifacts"
tags: ["UnifiedJob"]
---

# 작업 결과 파일 삭제 (ADR-081 D-9)

`DELETE /v1/jobs/{job_id}/artifacts`

## Request

- Base URL: `https://api.xdata.kr` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xdata.kr/v1/jobs/{job_id}/artifacts`
- Auth: one of:
  - HTTP basic
  - OAuth 2 (authorization code, authorization URL `https://api.xdata.kr/oauth/authorize`, token URL `https://api.xdata.kr/oauth/token`)

`DELETE /v1/jobs/{job_id}/artifacts` - 끝난 작업의 결과 파일을 보관 기간 전에 지운다.

정책 종류는 `job_artifact_delete` 다(ADR-010 §2-15). 지우는 일은
`auth_policy_routing.delete_job_artifacts_with_audit_durability` 를 거쳐
`job_artifacts.retention.delete_artifacts` 한 곳에서 한다.

응답 분기 (결과 조회 `GET /v1/jobs/{job_id}/result` 와 같은 판정):
    - 잡 부재 (또는 다른 org/env)            → 404 JOB_NOT_FOUND
    - status != 'SUCCEEDED'                  → 409 JOB_INVALID_TRANSITION
    - status == 'SUCCEEDED'                  → 200 OK + `deleted_count` (다시 부르면 0)
    - 정책 거부 (AuthPolicyError)            → 401/403/429 등
    - job_id 사전 검증 ValueError            → 400 VALIDATION_INVALID_FIELD

## Path parameters

- `job_id` string, required

## Query parameters

- `env_scope` 'production' | 'real_test' | 'sandbox', nullable: 환경을 고릅니다. 값은 production · real_test · sandbox 중 하나입니다. 경로 접두(/v1/sandbox/... · /v1/test/... · /v1/production/...) · X-Env-Scope 헤더 · env_scope 쿼리 가운데 한 통로로 반드시 보내야 합니다. 빼면 자동으로 채우지 않고 거절하며, 두 통로에 서로 다른 값을 담아도 거절합니다. 거절은 HTTP 422 이고 오류 코드는 VALIDATION_ENV_SCOPE_MISMATCH 입니다.

## Headers

- `Authorization` string, nullable
- `X-Env-Scope` 'production' | 'real_test' | 'sandbox', nullable: 환경을 고릅니다. 값은 production · real_test · sandbox 중 하나입니다. 경로 접두(/v1/sandbox/... · /v1/test/... · /v1/production/...) · X-Env-Scope 헤더 · env_scope 쿼리 가운데 한 통로로 반드시 보내야 합니다. 빼면 자동으로 채우지 않고 거절하며, 두 통로에 서로 다른 값을 담아도 거절합니다. 거절은 HTTP 422 이고 오류 코드는 VALIDATION_ENV_SCOPE_MISMATCH 입니다.

## Response `200`

Successful Response

- JobArtifactsDeleteResponse: `DELETE /v1/jobs/{job_id}/artifacts` 성공 응답 (ADR-081 D-9). 같은 요청을 다시 보내도 200 이고 `deleted_count` 가 0 이다. 지운 파일은 결과 조회의 `artifacts[]` 에서 빠진다. 문서 전용인 까닭은 `JobSubmitResponse` 의 그 문단과 같다.
  - `job_id` string, required
  - `deleted_count` integer, required: 이번 요청이 지운 파일 수. 이미 지웠으면 0 이다.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xdata/apis/xboss-api.md) · [All operations](https://skmtc.dev/xdata/apis/xboss-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xdata/apis/xboss-api/revisions/816de78950db?raw)