---
title: "List agents"
method: GET
path: "/api/workflows"
tags: ["Agents"]
---

# List agents

`GET /api/workflows`

## Request

- Base URL: `https://platform.ultralytics.com`
- URL: `https://platform.ultralytics.com/api/workflows`
- Auth: HTTP bearer

Returns up to 100 saved agents, most recently updated first. Pass id to return that agent with its graph.

## Query parameters

- `owner` string
- `id` string
- `search` string

## Response `200`

Saved agents

- ListAgentsResponse
  - `workflows` object[], required
    - `id` string, required
    - `username` string, required
    - `name` string, required
    - `version` integer, required
    - `graph` object: Returned when id is requested
      - `nodes` object[], required
        - `id` string, required
        - `type` 'agent', required
        - `position` object, required
          - `x` number, required
          - `y` number, required
        - `data` object, required
          - `label` string, required
          - `type` 'Dataset' | 'Image' | 'YOLO' | 'LLM' | 'Gate' | 'Export' | 'Deployment' | 'Output' | 'Slack' | 'Webhook', required
          - `config` object, required
      - `edges` object[], required
        - `id` string, required
        - `source` string, required
        - `target` string, required
      - `templateId` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid agent ID
- `401`: Missing or invalid authentication
- `403`: Workspace access denied
- `429`: Rate limit exceeded

## Changes

- **2026-10-01** `9da7270119bb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ultralytics/apis/ultralytics-platform-api/changes/api/workflows/get.md)

---

[API](https://skmtc.dev/ultralytics/apis/ultralytics-platform-api.md) - [All operations](https://skmtc.dev/ultralytics/apis/ultralytics-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ultralytics/apis/ultralytics-platform-api/revisions/9c562e23b0e4?raw)