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

# List Agents

`GET /agents/`

List available AI agents with filtering options.

This endpoint returns a paginated list of AI agents that can generate various types of
content including images, videos, text, and other creative assets.

**Filtering Options:**
- `tags`: Filter agents by tags (can be provided multiple times)
- `visibility`: Filter agents by their visibility status (can be provided multiple times)
   Options include:
    - PRIVATE: Internal organization's agents
    - SHARED: Agents shared by the user
    - PUBLIC: Pletor public agents
   By default, only PRIVATE and SHARED agents are returned.
- `search`: Search agents by name (case-insensitive)

**Pagination Parameters:**
- `limit`: Maximum number of items to return (default: 20, max: 100)
- `cursor`: Cursor for pagination (optional)

**Response:**
- `data`: List of agent summaries with basic information including expected inputs
- `has_more`: Indicates if there are more results available
- `next_cursor`: Cursor for the next page of results

**Use Case:** This is typically the first endpoint called to discover available agents
before getting detailed information or executing them.

## Query parameters

- `tags` string[], nullable
- `visibility` FlowVisibility[], nullable
- `search` string, nullable — Search agents by name
- `limit` integer — Maximum number of items to return
- `cursor` string, nullable — Cursor for pagination (from next_cursor)

## Headers

- `X-Organization-Id` string, nullable — Active organization ID for multi-org support

## Response `200`

Successful Response

- CursorPaginatedResponseAgentSummary
  - `data` AgentSummary[], required
    - `id` string, uuid, required — Unique agent identifier
    - `name` string, required — Agent display name
    - `description` string, required — Agent description and purpose
    - `tags` string[] — Categorization tags for filtering
    - `estimated_cost` integer, required — Estimated credit cost per execution
    - `visibility` 'public' | 'shared' | 'private', required — Visibility levels for workflows.
    - `inputs` AgentInput[] — All inputs for this agent; check the `required` flag on each to determine which are mandatory
      - `id` string, required — Node ID to use when providing this input
      - `type` 'text_input' | 'image_input' | 'file_input' | 'video_input' | 'audio_input' | 'brand_system_input' | 'llm' | 'image_generation' | 'video_generation' | 'text_to_speech' | 'screen_mockup' | 'remove_background' | 'upscale' | 'upscale_video' | 'video_background_removal' | 'extract_video_frame' | 'image_generation_lora' | 'change_aspect_ratio' | 'meta_ads_extractor' | 'image_edit' | 'vectorize' | 'image_erase' | 'linkedin_ads_extractor' | 'instagram_posts_extractor' | 'linkedin_posts_extractor' | 'human_review' | 'match_brand_colors' | 'tiktok_extractor' | 'add_logo' | 'video_subtitle' | 'video_concat' | 'video_add_sound' | 'generic_fal' | 'comment' | 'group' | 'composer' | 'googledrive_find_file' | 'googledrive_upload_file' | 'prompt_concatenate' | 'text_split' | 'list_selector' | 'video_edit' | 'router' | 'camera_angle' | 'rename_asset' | 'music_generation' | 'merge_audio_video' | 'trim_speed' | 'extract_audio' | 'remove_audio' | 'isolate_sound' | 'clone_voice' | 'translate_audio' | 'translate_video' | 'transcribe', required
      - `description` string, required — Human-readable description of this input
      - `required` boolean — Whether this input must be provided when creating a run
    - `has_human_review` boolean — True when this agent includes a human review step that will pause execution until resolved via POST /runs/{run_id}/reviews/{review_id}. Poll GET /runs/{run_id} for `awaiting_human_review` while the run is in progress.
  - `has_more` boolean, required
  - `next_cursor` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/pletor/apis/pletor-public-api.md) · [All operations](https://skmtc.dev/pletor/apis/pletor-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pletor/pletor-public-api/revisions/e5c350c02ffb/schema)