Artifacts

An artifact is a single, self-contained web page built from what a space holds: an overview of a project, a summary of decisions, a status page. You ask for it in plain language, it is built in the background, and you share it through a stable link. Every artifact starts private. Its creator can share it with everyone who can read the space, and the space owner can make it public to anyone with the link. An artifact is a snapshot. Deleting a memory later does not change pages already built.

Create an artifact

POST /v1/spaces/{space_id}/artifacts
Authorization: Bearer anona_live_YOUR_KEY
Content-Type: application/json

{
  "request": "An overview of the billing migration: what changed, what is left, who owns it",
  "conversation": []
}

Field	Type	Required	Description
`request`	string	yes	What the page should cover, 1 to 2,000 characters.
`conversation`	array	no	Earlier turns, oldest first, each `{"role": "user" or "assistant", "content": "..."}`. At most 40 turns and 40,000 characters in total. Used only to understand references such as “make that into a page”; the page is built from the space’s memories.

Response 202 Accepted

{
  "id": "6f1c2a7e-0b7d-4a51-9a52-1d3f0e8c9b11",
  "space_id": "billing",
  "title": null,
  "request": "An overview of the billing migration: what changed, what is left, who owns it",
  "status": "pending",
  "sharing": "private",
  "error_code": null,
  "created_at": "2026-10-16T09:30:00Z",
  "completed_at": null,
  "link": "https://memory.anonalabs.com/a/6f1c2a7e-0b7d-4a51-9a52-1d3f0e8c9b11",
  "can_publish": true
}

Building takes from several seconds to a few minutes. Poll Get an artifact until status is completed or failed. Creating an artifact needs write access to the space; read-only members receive 403 space_read_only. You can have one artifact building per space at a time.

Cost

An artifact is billed in credits for the tokens used to build it, plus a flat surcharge per page. Before anything is queued, the request is checked against the most it could cost; if your balance is below that, it is refused with 429 credits_exhausted and a message naming the amount. A failed build is not charged.

List artifacts

GET /v1/spaces/{space_id}/artifacts

Returns {"items": [...]}, newest first, at most 50. You see your own artifacts and those shared with the space or made public. The space owner sees all of them, private ones included, so any link built from the space can be found and withdrawn.

Get an artifact

GET /v1/spaces/{space_id}/artifacts/{artifact_id}

Returns the artifact in the shape shown above.

Field	Description
`status`	`pending`, `running`, `completed` or `failed`.
`sharing`	`private`, `space` or `public`.
`error_code`	Why a build failed, when `status` is `failed`.
`link`	The page’s stable link. It never expires; whether it opens depends on `sharing`.
`can_publish`	Whether you may make artifacts on this space public.

PATCH /v1/spaces/{space_id}/artifacts/{artifact_id}
Content-Type: application/json

{ "sharing": "space" }

Value	Who can open the link
`private`	The creator, while they can still read the space.
`space`	Anyone who can read the space.
`public`	Anyone with the link, signed in or not.

The creator and the space owner can change sharing. Sharing with the space needs write access to it. Making an artifact public needs the space owner’s authority; anyone else receives 403 space_owner_only. Returns the updated artifact.

Delete an artifact

DELETE /v1/spaces/{space_id}/artifacts/{artifact_id}

Deletes the artifact and its page; the link stops working at once. Allowed for the creator and the space owner. Returns 204 No Content. Deleting a space deletes its artifacts too, public ones included: their links stop working at once, and any still building are cancelled without charge. Deleting an artifact that is still building cancels the build: it disappears at once, nothing is charged for it, and it still counts toward the hourly limit.

Open an artifact

GET /v1/artifacts/{artifact_id}/view

This is the access check behind the link. Authentication is optional: a public artifact opens for anyone. Response 200 OK

{
  "url": "https://...",
  "expires_in": 300,
  "title": "Billing migration overview",
  "shared_by": "Acme",
  "created_at": "2026-10-16T09:30:00Z",
  "can_manage": true,
  "csp": "default-src 'none'; ...",
  "space_id": "acme:billing",
  "sharing": "public",
  "can_publish": false
}

Field	Description
`url`	A short-lived URL of the page. Request a fresh one rather than storing it.
`expires_in`	Seconds `url` stays valid.
`shared_by`	The name of the organization that owns the space.
`can_manage`	Whether you may change sharing or delete it.
`csp`	Informational: the Content-Security-Policy the page already carries in its own `<meta>` tag. Do not set it as an iframe `csp` attribute — browsers then refuse frames whose server does not opt in, and storage cannot. Embed with `sandbox="allow-scripts"`.
`space_id`	Only when `can_manage` is true: the space id to use with the routes above to change sharing or delete. For a space shared with you it is the qualified `{owner_slug}:{space}` form. `null` otherwise.
`sharing`	Only when `can_manage` is true: `private`, `space` or `public`. `null` otherwise.
`can_publish`	Only when `can_manage` is true: whether you may make the artifact public. `null` otherwise.

Anyone else who can open the page, including a signed-out visitor to a public link, gets null for these three fields: a link never reveals which space it came from or how it is shared.

API keys

Every route above accepts an API key as well as a dashboard session. An API key acts as the member it belongs to: it has that member’s access to each space, their role, and their authority, and the artifacts it creates are theirs. A key can do exactly what its member can do in the dashboard, and no more.

Errors

Status	Code	Meaning
404	`artifact_not_found`	No such artifact, or it is not shared with you. The two are deliberately indistinguishable.
404	`space_not_found`	The space does not exist. Nothing is queued.
409	`artifact_in_progress`	You already have an artifact building in this space.
503	`artifacts_unavailable`	Artifacts are not available right now.
403	`space_read_only`	You have read-only access to the space.
403	`space_owner_only`	Only the space owner can make an artifact public.
429	`credits_exhausted`	Your balance is below what the artifact could cost.
429	`artifact_rate_limited`	Your organization has started 10 artifacts this hour, counting failed and deleted ones. The count resets each clock hour, so try again within the hour.

A failed build reports one of these in error_code:

Code	Meaning
`artifact_no_material`	The space had nothing to build a page from.
`artifact_truncated`	The page was too long to finish. Ask for a narrower page.
`artifact_too_large`	The finished page was over 2 MB.
`artifact_rejected`	The page did not pass the safety checks applied to every artifact.
`artifact_not_html`	The model did not produce a single HTML page.
`artifact_timeout`	Building the page took longer than 10 minutes.
`artifact_generation_failed`	The page could not be built after a retry.
`credits_exhausted`	When the build started, your balance was below what it could cost.
`space_unavailable`	The space could not be read when the build started: your access was removed, or its owner cannot be reached.

A failed build is not charged.

Getting Started

For Agents

API Essentials

Memory (data plane)

LLM Proxy (drop-in)

Account (control plane)

SDKs & MCP

Integrations

Guides

Use Cases

Legal

Changelog

Create an artifact

Cost

List artifacts

Get an artifact

Delete an artifact

Open an artifact

API keys

Errors

​Create an artifact

​Cost

​List artifacts

​Get an artifact

​Change sharing

​Delete an artifact

​Open an artifact

​API keys

​Errors

Create an artifact

Cost

List artifacts

Get an artifact

Change sharing

Delete an artifact

Open an artifact

API keys

Errors