파일 · Ephemeral 문서

조직에 파일을 업로드하고 관리합니다. 이 페이지의 모든 엔드포인트는 member 키와 admin 키로 사용할 수 있습니다. 실행이 파일을 마운트하는 방식은 파일을 참고하세요.

파일 객체

idstring

file_9c41d2a07be35f1e8a6c0d4b9e2f7a13 같은 파일 ID.

namestring

guides/refunds.md처럼 파일 이름으로 사용하는 상대 경로.

sizeinteger

바이트 단위 크기.

content_typestring

업로드할 때 파일 내용을 바탕으로 감지한 콘텐츠 유형.

created_attimestamp

업로드된 시각.

파일 업로드

POST/v1/files

최대 1 MiB의 파일을 저장합니다. multipart/form-data로 보냅니다.

폼 필드

filefile필수

파일 내용.

namestring

저장할 이름. 기본값은 업로드한 파일 이름입니다. 최대 240자의 상대 경로여야 합니다.

curl $EPHEMERAL_URL/v1/files \
  -H "Authorization: Bearer $EPHEMERAL_API_KEY" \
  -F [email protected] \
  -F name=guides/refunds.md

응답은 파일 객체가 담긴 201 Created입니다. 이미 있는 이름으로 다시 업로드하면 새 ID를 가진 새 파일이 추가되고, 이전 업로드는 그대로 유지됩니다.

JSON

{
  "id": "file_9c41d2a07be35f1e8a6c0d4b9e2f7a13",
  "name": "guides/refunds.md",
  "size": 18234,
  "content_type": "text/plain; charset=utf-8",
  "created_at": "2026-10-03T08:02:17.553Z"
}

파일 목록

GET/v1/files

이름별로 가장 최근에 업로드한 파일의 객체 배열을 이름순으로 반환합니다.

파일 다운로드

GET/v1/files/{id}

저장된 콘텐츠 유형과 함께 원본 내용을 첨부 파일로 반환합니다. ID 대신 이름을 전달하면 해당 이름으로 가장 최근에 업로드한 파일을 받습니다.

터미널

curl $EPHEMERAL_URL/v1/files/file_9c41d2a07be35f1e8a6c0d4b9e2f7a13 \
  -H "Authorization: Bearer $EPHEMERAL_API_KEY" -o refunds.md

파일 이름 변경

PATCH/v1/files/{id}

업로드 하나의 이름을 변경합니다. ID를 받습니다.

본문

namestring필수

새 이름. 최대 240자의 상대 경로.

응답은 {"id": "...", "name": "..."}입니다. 이전 이름으로 파일을 참조하던 워크플로는 더 이상 파일을 찾지 못하지만, ID로 참조하는 경우에는 계속 동작합니다.

파일 삭제

DELETE/v1/files/{id}

업로드 하나와 그 내용을 삭제하고 204 No Content를 반환합니다. ID를 받습니다.

해당 파일을 참조하는 대기 중인 실행은 시작할 때 실패하고, 이후에 그 파일을 이름으로 지정하는 실행은 생성 시점에 400으로 실패합니다. 같은 이름의 이전 업로드가 있으면 이름으로 한 참조는 그 파일로 해석됩니다.