Skip to main content
GET
/
api
/
artifacts
List Artifacts
curl --request GET \
  --url https://genui.sh/api/artifacts
{
  "data": [
    {
      "id": "art_abc123",
      "template": "markdown",
      "title": "My Document",
      "status": "active",
      "createdAt": "2024-01-15T12:00:00Z"
    },
    {
      "id": "art_def456",
      "template": "chart",
      "title": "Sales Report",
      "status": "active",
      "createdAt": "2024-01-14T10:00:00Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}
Retrieve a list of artifacts for your account.

​
Request

​
limit
integer
Number of artifacts to return (default: 20, max: 100)
​
offset
integer
Number of artifacts to skip for pagination
​
template
string
Filter by template type: markdown, chart, table, pdf
​
status
string
Filter by status: active, expired, deleted
​
sort
string
Sort order: createdAt, -createdAt (default: -createdAt)

​
Response

​
data
array
Array of artifact objects
​
pagination
object
Pagination metadata with total, limit, offset, hasMore
{
  "data": [
    {
      "id": "art_abc123",
      "template": "markdown",
      "title": "My Document",
      "status": "active",
      "createdAt": "2024-01-15T12:00:00Z"
    },
    {
      "id": "art_def456",
      "template": "chart",
      "title": "Sales Report",
      "status": "active",
      "createdAt": "2024-01-14T10:00:00Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

​
Code Examples

curl -X GET "https://genui.sh/api/artifacts?limit=10&template=markdown" \
  -H "Authorization: Bearer $GENUI_API_KEY"