List 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.