AI Agent instructions, signup and documentation found at llms.txt
agenttools
Sign in
Artifacts

Create an artifact

No auth required

Creates an artifact (markdown or html content). With an API key it is owned by the key's organization; without one it is created public and the response includes a one-time `claim_token`.

POST/api/artifacts

Request body

namestringrequired
contentstringrequired
format"markdown" | "html"
external_idstring | null

Responses

201The created artifact.
idstring
Unique identifier for the artifact, prefixed with `art_`.Example: "art_xxxxxxxxxxxxxxxxxxxxxxxx"
object"artifact"
organization_idstring | null
Owning organization ID, or null if the resource is public (created without an API key).
namestring
sizeinteger
Size of the stored content in bytes (UTF-8).
contentstring
The stored content. Returned when fetching a single artifact; omitted from list responses — use `raw_url` to fetch the body.
format"markdown" | "html"
Content format. Determines the content type the raw endpoint serves.
raw_urlstring
Path serving the raw content with the format's content type (`text/html` for html, `text/markdown` for markdown).
external_idstring | null
Caller-supplied identifier (your own name, key, or ID for this resource). Free-form, not required to be unique. Filter with ?external_id= on the list endpoint. Null when not set.
created_atinteger | null
When the artifact was created. Unix timestamp in seconds.
updated_atinteger | null
When the artifact was last updated. Unix timestamp in seconds.
claim_tokenstring
One-time token to claim ownership of this resource via POST /api/claim/{id}. Only present when created without an API key.
claim_urlstring
Relative URL for claiming the resource.
400The request was malformed or failed validation.
errorobject
type"invalid_request_error" | "authentication_error" | "authorization_error" | "not_found_error" | "rate_limit_error" | "api_error"
codestring
Machine-readable error code.
messagestring
Human-readable error message.
paramstring | null
The offending parameter, when applicable.
401No valid credential was provided.
errorobject
type"invalid_request_error" | "authentication_error" | "authorization_error" | "not_found_error" | "rate_limit_error" | "api_error"
codestring
Machine-readable error code.
messagestring
Human-readable error message.
paramstring | null
The offending parameter, when applicable.

Example request

curl
curl -X POST https://agtls.dev/api/artifacts \
  -H "Content-Type: application/json" \
  -d '{ … }'