Skip to main content
GET
/
api
/
artifacts
/
{id}
Get Artifact
curl --request GET \
  --url https://genui.sh/api/artifacts/{id}
{
  "id": "art_abc123",
  "template": "markdown",
  "title": "My Document",
  "description": "A sample document",
  "content": {
    "text": "# Hello World\n\nThis is my artifact."
  },
  "status": "active",
  "metadata": {
    "author": "john@example.com"
  },
  "createdAt": "2024-01-15T12:00:00Z",
  "updatedAt": "2024-01-15T12:00:00Z",
  "expiresAt": "2024-01-22T12:00:00Z"
}
Retrieve a single artifact by ID.

​
Request

​
id
string
required
The artifact ID (format: art_xxx)

​
Response

​
id
string
Unique artifact ID
​
template
string
Template type used
​
title
string
Display title
​
description
string
Description text
​
content
object
The artifact’s content object
​
status
string
Current status: active, expired, deleted
​
metadata
object
Custom metadata key-value pairs
​
createdAt
string
ISO 8601 creation timestamp
​
updatedAt
string
ISO 8601 last update timestamp
​
expiresAt
string
ISO 8601 expiration timestamp (if set)
{
  "id": "art_abc123",
  "template": "markdown",
  "title": "My Document",
  "description": "A sample document",
  "content": {
    "text": "# Hello World\n\nThis is my artifact."
  },
  "status": "active",
  "metadata": {
    "author": "john@example.com"
  },
  "createdAt": "2024-01-15T12:00:00Z",
  "updatedAt": "2024-01-15T12:00:00Z",
  "expiresAt": "2024-01-22T12:00:00Z"
}

​
Code Examples

curl -X GET https://genui.sh/api/artifacts/art_abc123 \
  -H "Authorization: Bearer $GENUI_API_KEY"