from line 1
1---
2title: Code
3url: https://platform.claude.com/docs/en/api/compliance/code
4---
5
61# Code
72
8# Artifacts
3## Code › Artifacts
94
10## List Code Artifacts
5### List Code Artifacts
116
12**get** `/v1/compliance/apps/code/artifacts`
7**GET** `/v1/compliance/apps/code/artifacts`
138
149List Claude Code Artifacts owned by organizations under the parent
1510organization.
from line 19
2419Artifacts owned by a since-deleted child organization are not
2520returned.
2621
27### Query Parameters
22#### Query parameters
2823
2924- `limit: optional number`
3025
3126 Maximum results (default: 20, max: 100)
3227
28 default: 20, maximum: 100, minimum: 1
29
3330- `organization_ids: optional array of string`
3431
3532 Filter by organization IDs (accepts `org_...` or organization UUID, up to 500). Enumerate IDs via `GET /v1/compliance/organizations`.
3633
34 maxItems: 500
35
3736- `page: optional string`
3837
3938 Opaque pagination token from a previous response's `next_page` field. Pass this to retrieve the next page of results. Clients should treat this value as an opaque string and not attempt to parse or interpret its contents, as the format may change without notice.
4039
41- `updated_at: optional object { gt, gte, lt, lte }`
40- `updated_at: optional object`
4241
4342 - `gt: optional string`
4443
4544 Return only Artifacts updated after this time (RFC 3339 format). See `updated_at.gte` for the completeness caveat.
4645
46 format: date-time
47
4748 - `gte: optional string`
4849
4950 Return only Artifacts updated at or after this time (RFC 3339 format). Time filters match an eventually-consistent index and Artifacts published before this field was recorded never match — omit the time filter for compliance-complete enumeration. For incremental export, apply a generous overlap margin between windows and dedupe by `id`: adjacent tiling silently misses items whose index update lagged their publish.
5051
52 format: date-time
53
5154 - `lt: optional string`
5255
5356 Return only Artifacts updated before this time (RFC 3339 format). Multiple time operators are AND-ed to the tightest bound. See `updated_at.gte` for the completeness caveat.
5457
58 format: date-time
59
5560 - `lte: optional string`
5661
5762 Return only Artifacts updated at or before this time (RFC 3339 format). See `updated_at.gte` for the completeness caveat.
5863
64 format: date-time
65
5966- `user_ids: optional array of string`
6067
6168 Filter by owner user IDs (up to 200). Enumerate IDs via `GET /v1/compliance/organizations/{org_uuid}/users`.
6269
63### Header Parameters
70 maxItems: 200
6471
72#### Headers
73
6574- `"x-api-key": optional string`
6675
67### Returns
76#### Returns
6877
69- `data: array of object { id, organization_uuid, owner_user_id, 5 more }`
78- `data: array of object`
7079
7180 Page of Artifacts
7281
from line 111
102111
103112 Artifact last update timestamp, or null for Artifacts published before this field was recorded
104113
105 - `user: object { id, email_address } or null`
114 format: date-time
106115
116 - `user: object or null`
117
107118 The user who owns a Code Artifact.
108119
109120 Fields that reference this type are null when the Artifact was
from line 130
119130
120131 User's email address
121132
122 - `versions: array of object { id, created_at, name }`
133 - `versions: array of object`
123134
124135 Up to roughly 20 most-recently-published versions of this Artifact (older versions are not retained). Metadata only — use `GET /v1/compliance/apps/code/artifacts/{artifact_id}/versions/{version_id}` to download a version's content.
125136
from line 142
131142
132143 When this version was published
133144
145 format: date-time
146
134147 - `name: string`
135148
136149 Artifact title at this version. Falls back to the version identifier when the title for an older version is no longer retained.
from line 156
143156
144157 Token to retrieve the next page. Use this as the 'page' parameter in your next request
145158
146### Example
159#### Example
147160
148```http
161```bash
149162curl https://api.anthropic.com/v1/compliance/apps/code/artifacts \
150163 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
151164```
152165
153#### Response
166##### Response (200)
154167
155168```json
156169{
from line 193
180193}
181194```
182195
183## Download Code Artifact Version Content
196### Download Code Artifact Version Content
184197
185**get** `/v1/compliance/apps/code/artifacts/{artifact_id}/versions/{version_id}`
198**GET** `/v1/compliance/apps/code/artifacts/{artifact_id}/versions/{version_id}`
186199
187200Streams the content of one version of a Claude Code Artifact as the
188201response body.
from line 210
197210only truncation signal for encoded content. `Content-MD5` is emitted
198211only for identity-stored content; validate against it when present.
199212
200### Path Parameters
213#### Path parameters
201214
202215- `artifact_id: string`
203216
from line 220
207220
208221 Opaque version identifier from the Artifact's `versions` list
209222
210### Header Parameters
223#### Headers
211224
212225- `"x-api-key": optional string`
213226
214### Example
227#### Example
215228
216```http
229```bash
217230curl https://api.anthropic.com/v1/compliance/apps/code/artifacts/$ARTIFACT_ID/versions/$VERSION_ID \
218231 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
219232```
220233
221## Delete Code Artifact
234### Delete Code Artifact
222235
223**delete** `/v1/compliance/apps/code/artifacts/{artifact_id}`
236**DELETE** `/v1/compliance/apps/code/artifacts/{artifact_id}`
224237
225238Permanently deletes a Code Artifact and all its versions. This is a
226239destructive operation that cannot be undone. A 200 response means the
from line 244
231244organization. Returns 404 on a repeated delete of an already-deleted
232245Artifact.
233246
234### Path Parameters
247#### Path parameters
235248
236249- `artifact_id: string`
237250
238251 The Artifact ID (tagged ID, e.g., cart_abc123)
239252
240### Header Parameters
253#### Headers
241254
242255- `"x-api-key": optional string`
243256
244### Returns
257#### Returns
245258
246259- `id: string`
247260
from line 264
251264
252265 Constant string confirming deletion
253266
254 - `"code_artifact_deleted"`
267 default: code_artifact_deleted
255268
256### Example
269#### Example
257270
258```http
271```bash
259272curl https://api.anthropic.com/v1/compliance/apps/code/artifacts/$ARTIFACT_ID \
260273 -X DELETE \
261274 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
262275```
263276
264#### Response
277##### Response (200)
265278
266279```json
267280{
from line 282
269282 "type": "code_artifact_deleted"
270283}
271284```
272
273## Domain Types
274
275### Artifact List Response
276
277- `ArtifactListResponse object { id, organization_uuid, owner_user_id, 5 more }`
278
279 A hosted site published via Claude Code.
280
281 - `id: string`
282
283 Artifact identifier (tagged ID)
284
285 - `organization_uuid: string`
286
287 Organization UUID this Artifact belongs to
288
289 - `owner_user_id: string or null`
290
291 Artifact owner's user identifier (tagged ID), or null for Artifacts published by an agent session rather than a user account. When set, it survives after the owner's account is deleted or the owner leaves every organization under the parent.
292
293 - `published_version_id: string or null`
294
295 Identifier of the version a non-owner viewer would render when `read_mode` permits them — the version the owner has pinned for non-owner readers if one is pinned, otherwise the owner's latest. When `read_mode` is `owner` no non-owner renders any version; the field still reports which version would be served were read_mode widened.
296
297 - `read_mode: "org" or "owner" or "public" or "users"`
298
299 Who can view this Artifact: only its owner, a named set of users, every member of its organization, or anyone on the internet (`public`)
300
301 - `"org"`
302
303 - `"owner"`
304
305 - `"public"`
306
307 - `"users"`
308
309 - `updated_at: string or null`
310
311 Artifact last update timestamp, or null for Artifacts published before this field was recorded
312
313 - `user: object { id, email_address } or null`
314
315 The user who owns a Code Artifact.
316
317 Fields that reference this type are null when the Artifact was
318 published by an agent session rather than a user account, when the
319 owner's account has been deleted, or when the owner is no longer a
320 member of an organization the key may read.
321
322 - `id: string`
323
324 User identifier (tagged ID)
325
326 - `email_address: string`
327
328 User's email address
329
330 - `versions: array of object { id, created_at, name }`
331
332 Up to roughly 20 most-recently-published versions of this Artifact (older versions are not retained). Metadata only — use `GET /v1/compliance/apps/code/artifacts/{artifact_id}/versions/{version_id}` to download a version's content.
333
334 - `id: string`
335
336 Opaque version identifier
337
338 - `created_at: string or null`
339
340 When this version was published
341
342 - `name: string`
343
344 Artifact title at this version. Falls back to the version identifier when the title for an older version is no longer retained.
345
346### Artifact Delete Response
347
348- `ArtifactDeleteResponse object { id, type }`
349
350 Response for deleting a Code Artifact.
351
352 - `id: string`
353
354 The ID of the Artifact that was deleted
355
356 - `type: "code_artifact_deleted"`
357
358 Constant string confirming deletion
359
360 - `"code_artifact_deleted"`
361285
No line in this hunk matches that.