Artifacts changedapi/compliance/apps/code/artifacts
Nearest release: v2.1.306, published 2 hours after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+60added
Lines−43removed
From line
221
where the diff opens
First seen
15 Oct 2026
this site's first read of the page
Recorded edits3to this page, all time
The whole hunk
from line 221, old and new numbered
/
from line 221
221221
222222**GET** `/v1/compliance/apps/code/artifacts/{artifact_id}/versions/{version_id}`
223223
224Streams the content of one version of a Claude Code Artifact as the
225response body.
224Streams the content of one version of an Artifact as the response body, in chunks with no `Content-Length`. With `multi_file_format=zip`, a version with more than one file, other than a Claude Doc's (an Artifact whose `artifact_type` is `claude_docs`), comes back as a ZIP archive of its files.
226225
227Returns 404 for Artifacts that don't exist or belong to another parent
228organization. A listed version id can start returning 404 if subsequent
229publishes rotated it out of retained history — re-list on 404. Returns
230503 while the version's content upload is still in flight or was
231abandoned — retry with backoff. Returns 422 with
232`error.details.error_code` `multi_file_unavailable` for a version that
233has more than one file, unless the request sets `multi_file_format=zip`,
234which returns those files as a ZIP archive. With `multi_file_format=zip`,
235a version with more than one file, one of them with a name the API cannot
236export, gets 422 `file_set_unavailable`. Do not retry a 422. A Claude
237Doc's versions hold only the web page that displays the Doc and never come
238back as a ZIP. That page usually has more than one file, so a Doc's version
239usually gets the 422 `multi_file_unavailable`. Download the Doc's text with
240`GET /v1/compliance/apps/code/artifacts/{artifact_id}/content?multi_file_format=zip`.
241Oversized encoded content aborts mid-stream: headers and initial bytes arrive
242but the body terminates early — an aborted chunked transfer is the
243only truncation signal for encoded content. `Content-MD5` is emitted
244only for identity-stored content; validate against it when present.
226Headers: `Content-Type` (`application/zip` for a ZIP archive, otherwise the stored MIME type), `Content-Disposition: attachment; filename*=utf-8''<name>` (RFC 5987), `Cache-Control: no-store, private` and, when available, `Content-MD5` (base64). `<name>` is `{artifact_id}-{version_id}.zip` for a ZIP archive, otherwise `{artifact_id}-{version_id}.txt`, whatever the content is. `Content-MD5` is only on a single file stored uncompressed, so it is never on a ZIP archive. Check the body against it when present.
245227
228Errors specific to this download:
229
230- `404`: the Artifact doesn't exist or the API key cannot read it, or the version is no longer kept. Older versions are dropped as new ones are published, so list the Artifact's versions again. You also get this when the organization's customer-managed encryption key can't be used. Retry once the key can be used again.
231- `503`: the content can't be served right now, for example because its upload is still in progress or was abandoned. Retry with backoff.
232- `422` with `error.details.error_code` `multi_file_unavailable`: the version has more than one file. Add `multi_file_format=zip`. A Claude Doc's version with more than one file gets this error either way, because it holds only the web page that displays the Doc. Download the Doc's text with `GET /v1/compliance/apps/code/artifacts/{artifact_id}/content?multi_file_format=zip`.
233- `422` with `file_set_unavailable`: the request sets `multi_file_format=zip`, the version has more than one file, and one of them has a path the API cannot export. Do not retry.
234
235An error after the download has started stops the body early, with the `200` status already sent. For example, this happens to content stored compressed when it is over 16 MiB once decompressed. For a single file with no `Content-MD5`, the only sign is a transfer that aborts before its last chunk, so treat a download that aborts this way as failed.
236
237A ZIP archive of a version's files holds one top-level folder, named for the Artifact and version. That folder holds a `files/` folder and an index, `files.json`. The index is written last, so treat an archive as incomplete if it cannot be opened or has no `files.json` in its top-level folder.
238
239`files.json` has these fields:
240
241- `artifact_id`: the Artifact ID, as in the request.
242- `version_id`: the version ID, as in the request.
243- `title`: the title of the version in the archive, or that version's ID when no title is kept.
244- `created_at`: when the version was published (RFC 3339, UTC), or null when that is not known.
245- `files`: one entry for each file under `files/`, with `original_path` (the file's path in the version), `exported_as` (its path in the archive), `sha256` (lowercase hex), `size_bytes` (before compression) and `mime_type`. `exported_as` is the top-level folder, then `files/`, then `original_path`. A name that could not be saved or opened safely on every operating system is changed. Use `exported_as`, not `original_path`, to find a file in the archive.
246- `omitted_files`: the files left out of the archive, each with `original_path`, `sha256`, `size_bytes` and `mime_type`. They include files the version uses from another Artifact. They also include files copied from the Artifact type the Artifact was made from, such as the app that displays it, when another organization owns that type.
247
248`files` and `omitted_files` together list at most 4,096 files, their `size_bytes` add up to at most 1 GiB, and no file is over 20 MiB.
249
246250### Path parameters
247251
248252- `artifact_id: string`
from line 261
257261
258262- `multi_file_format: optional string`
259263
260 Set to `zip`, its only value, to receive a version that has more than one file as a ZIP archive of its files with an index, `files.json`. Files the Artifact copied from its type (the app that displays every Artifact of that type) are listed under `omitted_files` in the index, and left out of the archive, when an organization other than the Artifact's owns that type. Files the version uses from another Artifact are always listed there and left out. A Claude Doc's version never comes back as a ZIP: it is answered as without this parameter, except that a version with more than one file, one of them with a name the API cannot export, gets 422 `file_set_unavailable`. A version with one file is returned as that file, as without this parameter.
264 Set to `zip`, its only value, to receive a version that has more than one file as a ZIP archive of its files with an index, `files.json`. A version with one file is returned as that file. A Claude Doc's version never comes back as a ZIP.
261265
262266### Headers
263267
from line 285
281285
282286**GET** `/v1/compliance/apps/code/artifacts/{artifact_id}/content`
283287
284Streams an Artifact's current content as the response body. For a
285Claude Doc, that is the Doc's text as a ZIP archive of Word files, one per
286text tab, and the request must set `multi_file_format=zip`. For any other
287Artifact, it is the latest version, as
288`GET /v1/compliance/apps/code/artifacts/{artifact_id}/versions/{version_id}`
289returns it.
288Streams an Artifact's current content as the response body, in chunks with no `Content-Length`.
290289
291Returns 404 for Artifacts that don't exist or that the API key cannot read.
292Returns 400 with `error.details.error_code` `cmek_key_disabled` when the
293organization's customer-managed encryption key can't be used, for example
294because it is disabled or revoked. Returns 503 when the content can't be
295produced right now; wait the number of seconds in the `Retry-After`
296header, or retry with backoff when it is absent. For a Claude Doc, a 422's
297`error.details.error_code` is `multi_file_unavailable` when the request
298does not set `multi_file_format=zip`, `document_unavailable` when the Doc
299has no text to export (for example, it has no text tab or is in the trash),
300`document_too_large` when the export is over 16 MiB, or
301`cmek_org_unsupported` when the organization uses customer-managed
302encryption keys and the export can't be served for it right now. For any
303other Artifact, the 422s are the version download's.
290For a Claude Doc (an Artifact whose `artifact_type` is `claude_docs`), the request must set `multi_file_format=zip`, and the content is the Doc's text as a ZIP archive of Word files. That ZIP has no `files.json`. It holds one Word file per text tab, in tab order, named `NN-<tab id>.docx`, where `NN` counts from `01`. A Doc with one text tab gets one file, `01-document.docx`.
304291
292For any other Artifact, the content is the latest version. With `multi_file_format=zip`, when the latest version has more than one file, it comes back as a ZIP archive of its files.
293
294Headers: `Content-Type` (`application/zip` for a ZIP archive, otherwise the stored MIME type), `Content-Disposition: attachment; filename*=utf-8''<name>` (RFC 5987), `Cache-Control: no-store, private` and, when available, `Content-MD5` (base64). `<name>` is `{artifact_id}.zip` for a ZIP archive, otherwise `{artifact_id}.txt`, whatever the content is. `Content-MD5` is always on a Claude Doc's ZIP, only on a single file stored uncompressed, and never on a ZIP archive of a version's files. Check the body against it when present.
295
296Errors specific to this download:
297
298- `404`: the Artifact doesn't exist, or the API key cannot read it.
299- `400` with `error.details.error_code` `cmek_key_disabled`: the organization's customer-managed encryption key can't be used, for example because it is disabled or revoked. Retry once the key can be used again.
300- `503`: the content can't be produced right now. Wait the number of seconds in the `Retry-After` header, or retry with backoff when it is absent.
301- `422` with `multi_file_unavailable`: the request does not set `multi_file_format=zip`, and the Artifact is a Claude Doc or its latest version has more than one file. Add the parameter.
302- `422` with `file_set_unavailable`: the request sets `multi_file_format=zip`, the Artifact is not a Claude Doc, and one of the latest version's files has a path the API cannot export. Do not retry.
303- `422` with `document_unavailable`: Claude Docs has no document it can export for the Doc, for example because it has no text tab or is in the trash. Retrying will not help unless that changes.
304- `422` with `document_too_large`: the Doc's export is over 16 MiB. Do not retry.
305- `422` with `cmek_org_unsupported`: the organization uses customer-managed encryption keys and the export can't be served for it right now. Try again later, and contact Anthropic support if this continues.
306
307An error after the download has started stops the body early, with the `200` status already sent. For example, this happens to content stored compressed when it is over 16 MiB once decompressed. For a single file with no `Content-MD5`, the only sign is a transfer that aborts before its last chunk, so treat a download that aborts this way as failed.
308
309A ZIP archive of a version's files holds one top-level folder, named for the Artifact. That folder holds a `files/` folder and an index, `files.json`. The index is written last, so treat an archive as incomplete if it cannot be opened or has no `files.json` in its top-level folder.
310
311`files.json` has these fields:
312
313- `artifact_id`: the Artifact ID, as in the request.
314- `version_id`: null.
315- `title`: the title of the version in the archive, or that version's ID when no title is kept.
316- `created_at`: when the version was published (RFC 3339, UTC), or null when that is not known.
317- `files`: one entry for each file under `files/`, with `original_path` (the file's path in the version), `exported_as` (its path in the archive), `sha256` (lowercase hex), `size_bytes` (before compression) and `mime_type`. `exported_as` is the top-level folder, then `files/`, then `original_path`. A name that could not be saved or opened safely on every operating system is changed. Use `exported_as`, not `original_path`, to find a file in the archive.
318- `omitted_files`: the files left out of the archive, each with `original_path`, `sha256`, `size_bytes` and `mime_type`. They include files the version uses from another Artifact. They also include files copied from the Artifact type the Artifact was made from, such as the app that displays it, when another organization owns that type.
319
320`files` and `omitted_files` together list at most 4,096 files, their `size_bytes` add up to at most 1 GiB, and no file is over 20 MiB.
321
305322### Path parameters
306323
307324- `artifact_id: string`
from line 329
312329
313330- `multi_file_format: optional string`
314331
315 Set to `zip`, its only value. A Claude Doc downloads only this way, as a ZIP archive of Word files, one per text tab. For any other Artifact it works as on the version download: when the latest version has more than one file, it comes back as a ZIP archive of its files with an index, `files.json`.
332 Set to `zip`, its only value. A Claude Doc downloads only this way, as a ZIP archive of Word files, one per text tab. For any other Artifact, when the latest version has more than one file, it comes back as a ZIP archive of its files with an index, `files.json`.
316333
317334### Headers
318335
No line in this hunk matches that.