Code changedapi/compliance/apps/code
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
223
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 223, old and new numbered
/
from line 223
223223
224224**GET** `/v1/compliance/apps/code/artifacts/{artifact_id}/versions/{version_id}`
225225
226Streams the content of one version of a Claude Code Artifact as the
227response body.
226Streams 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.
228227
229Returns 404 for Artifacts that don't exist or belong to another parent
230organization. A listed version id can start returning 404 if subsequent
231publishes rotated it out of retained history — re-list on 404. Returns
232503 while the version's content upload is still in flight or was
233abandoned — retry with backoff. Returns 422 with
234`error.details.error_code` `multi_file_unavailable` for a version that
235has more than one file, unless the request sets `multi_file_format=zip`,
236which returns those files as a ZIP archive. With `multi_file_format=zip`,
237a version with more than one file, one of them with a name the API cannot
238export, gets 422 `file_set_unavailable`. Do not retry a 422. A Claude
239Doc's versions hold only the web page that displays the Doc and never come
240back as a ZIP. That page usually has more than one file, so a Doc's version
241usually gets the 422 `multi_file_unavailable`. Download the Doc's text with
242`GET /v1/compliance/apps/code/artifacts/{artifact_id}/content?multi_file_format=zip`.
243Oversized encoded content aborts mid-stream: headers and initial bytes arrive
244but the body terminates early — an aborted chunked transfer is the
245only truncation signal for encoded content. `Content-MD5` is emitted
246only for identity-stored content; validate against it when present.
228Headers: `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.
247229
230Errors specific to this download:
231
232- `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.
233- `503`: the content can't be served right now, for example because its upload is still in progress or was abandoned. Retry with backoff.
234- `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`.
235- `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.
236
237An 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.
238
239A 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.
240
241`files.json` has these fields:
242
243- `artifact_id`: the Artifact ID, as in the request.
244- `version_id`: the version ID, as in the request.
245- `title`: the title of the version in the archive, or that version's ID when no title is kept.
246- `created_at`: when the version was published (RFC 3339, UTC), or null when that is not known.
247- `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.
248- `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.
249
250`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.
251
248252#### Path parameters
249253
250254- `artifact_id: string`
from line 263
259263
260264- `multi_file_format: optional string`
261265
262 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.
266 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.
263267
264268#### Headers
265269
from line 287
283287
284288**GET** `/v1/compliance/apps/code/artifacts/{artifact_id}/content`
285289
286Streams an Artifact's current content as the response body. For a
287Claude Doc, that is the Doc's text as a ZIP archive of Word files, one per
288text tab, and the request must set `multi_file_format=zip`. For any other
289Artifact, it is the latest version, as
290`GET /v1/compliance/apps/code/artifacts/{artifact_id}/versions/{version_id}`
291returns it.
290Streams an Artifact's current content as the response body, in chunks with no `Content-Length`.
292291
293Returns 404 for Artifacts that don't exist or that the API key cannot read.
294Returns 400 with `error.details.error_code` `cmek_key_disabled` when the
295organization's customer-managed encryption key can't be used, for example
296because it is disabled or revoked. Returns 503 when the content can't be
297produced right now; wait the number of seconds in the `Retry-After`
298header, or retry with backoff when it is absent. For a Claude Doc, a 422's
299`error.details.error_code` is `multi_file_unavailable` when the request
300does not set `multi_file_format=zip`, `document_unavailable` when the Doc
301has no text to export (for example, it has no text tab or is in the trash),
302`document_too_large` when the export is over 16 MiB, or
303`cmek_org_unsupported` when the organization uses customer-managed
304encryption keys and the export can't be served for it right now. For any
305other Artifact, the 422s are the version download's.
292For 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`.
306293
294For 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.
295
296Headers: `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.
297
298Errors specific to this download:
299
300- `404`: the Artifact doesn't exist, or the API key cannot read it.
301- `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.
302- `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.
303- `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.
304- `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.
305- `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.
306- `422` with `document_too_large`: the Doc's export is over 16 MiB. Do not retry.
307- `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.
308
309An 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.
310
311A 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.
312
313`files.json` has these fields:
314
315- `artifact_id`: the Artifact ID, as in the request.
316- `version_id`: null.
317- `title`: the title of the version in the archive, or that version's ID when no title is kept.
318- `created_at`: when the version was published (RFC 3339, UTC), or null when that is not known.
319- `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.
320- `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.
321
322`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.
323
307324#### Path parameters
308325
309326- `artifact_id: string`
from line 331
314331
315332- `multi_file_format: optional string`
316333
317 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`.
334 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`.
318335
319336#### Headers
320337
No line in this hunk matches that.