agenttools
Artifacts

Get an artifact

No auth required
GET/api/artifacts/{id}

Parameters

Path
idstringrequired
The artifact ID (`art_…`).

Responses

200The 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).
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.
401No valid API key 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.
403The caller is authenticated but lacks access to the resource.
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.
404The resource does not exist or is not visible to the caller.
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 https://agtls.dev/api/artifacts/{id}