Artifacts
GET /api/orgs/{org_id}/artifacts
Section titled “GET /api/orgs/{org_id}/artifacts”List Artifacts
List artifacts in the organization, newest first.
Mirrors the detail endpoint’s scoping: org membership is sufficient,
since org_id is a direct column on every artifact — this surfaces
exactly what GET /{artifact_id} already lets a member read one at a
time, it does not widen access.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| limit | query | integer | no | Max rows to return (1-100). Omit to return every row. |
| offset | query | integer | no | Rows to skip — pass the previous response’s next_offset. |
| org_id | path | string (uuid) | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | Page_ArtifactDetailResponse_ |
| 422 | Validation Error | HTTPValidationError |
GET /api/orgs/{org_id}/artifacts/{artifact_id}
Section titled “GET /api/orgs/{org_id}/artifacts/{artifact_id}”Get Artifact
Get a single artifact by ID.
Requires membership in the organization.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| artifact_id | path | string (uuid) | yes | |
| org_id | path | string (uuid) | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | ArtifactDetailResponse |
| 422 | Validation Error | HTTPValidationError |
GET /api/orgs/{org_id}/artifacts/{artifact_id}/download
Section titled “GET /api/orgs/{org_id}/artifacts/{artifact_id}/download”Download Artifact
Download the raw bytes of a FILE-type artifact.
Only valid for artifacts with artifact_type == “file”. For all other types
(code, markdown, text, json) the content is already inline in the
GET /{artifact_id} response.
Returns the file bytes with appropriate Content-Type and Content-Disposition headers so browsers trigger a native download.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| artifact_id | path | string (uuid) | yes | |
| org_id | path | string (uuid) | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | object |
| 422 | Validation Error | HTTPValidationError |