---
title: "List saved agents"
method: GET
path: "/saved-agents"
---

# List saved agents

`GET /saved-agents`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/saved-agents`
- Auth: HTTP bearer

The caller's saved agents as My Agents lists them. `?for=composer` lists the agents the composer offers (saved ones, then the ones listed in the workspace); `?for=form` adds what the New agent form needs: the caller's skills, the channels an agent may allow, the longest name, and the provider account forms.

## Query parameters

- `for` 'composer' | 'form'

## Response `200`

OK

- object

## Other responses

- `401`: Error — { error: { code, message } }
- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/saved-agents/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)