Skip to main content
GET
/
agents
/
{agent_id}
/
artifacts
cURL
curl 'https://api.gumloop.com/api/v1/agents/AGENT_ID/artifacts?page_size=20' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
{
  "artifacts": [
    {
      "id": "art_aBcDeF123",
      "version_id": "ver_xYz9012",
      "major_version": 2,
      "agent_id": "abc123DEFghiJKL",
      "session_id": "ses_8h2k4m1n",
      "filename": "q4_sales_report.pdf",
      "created_at": "2026-05-15T14:32:00Z",
      "metadata": {
        "media_type": "application/pdf",
        "size": 12345
      },
      "url": "https://storage.googleapis.com/gumloop-artifacts/art_aBcDeF123?X-Goog-Signature=...",
      "creator": {
        "id": "user_19a3bc",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "email": "ada@example.com",
        "profile_picture": "https://example.com/avatars/ada.png"
      }
    },
    {
      "id": "art_gHiJkL456",
      "version_id": "ver_aBc4567",
      "major_version": 1,
      "agent_id": "abc123DEFghiJKL",
      "session_id": "ses_8h2k4m1n",
      "filename": "summary.txt",
      "created_at": "2026-05-15T14:30:11Z",
      "metadata": {},
      "url": "https://storage.googleapis.com/gumloop-artifacts/art_gHiJkL456?X-Goog-Signature=...",
      "creator": {
        "id": "user_19a3bc",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "email": "ada@example.com",
        "profile_picture": null
      }
    }
  ],
  "next_cursor": "eyJjcmVhdGVkX3RzIjoiMjAyNi0wNS0xNVQxNDozMDoxMVoifQ=="
}

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Path Parameters

agent_id
string
required

ID of the agent whose artifacts to list.

Query Parameters

session_id
string

Filter to artifacts produced within a specific session.

search_query
string

Case-insensitive substring match against the artifact filename.

sort_order
string
default:newest

Sort order for results. Defaults to newest.

page_size
integer
default:20

Number of artifacts to return per page. Clamped to 1–100.

Required range: 1 <= x <= 100
cursor
string

Opaque pagination cursor returned by a prior call as next_cursor.

Response

Artifacts matching the provided filters.

artifacts
object[]
next_cursor
string | null

Cursor to pass as cursor on the next request. null when there are no more results.