Returns a list of your agents (formerly known as projects). The agents are returned sorted by creation date, with the most recent agents appearing first. It is a paginated API and you can use the page parameter to fetch the next page of agents. The default page size is 10.
Here is an example to list agents: using API and using our python SDK.
Purpose
Returns a list of your agents (formerly known as projects). The agents are returned sorted by creation date, with the most recent agents appearing first. It is a paginated API and you can use the page parameter to fetch the next page of agents. The default page size is 10.
Here is an example to list agents: using API and using our python SDK.
In practical terms, this is the main read entry point for your agents catalogue. It feeds any “list of agents” page in your dashboard, lets you page through agents for audit scripts, and gives you a stable way to discover projectId values before calling more specific endpoints.
At a high level, this is the canonical way to work with agents (your deployed CustomGPT assistants) via the CustomGPT API.
When to use
- When you need to list all agents as part of your backend or automation workflows.
- To power an internal UI that lists all agents, including filters and pagination, rather than relying on the web dashboard.
- Before calling agent‑specific endpoints, to discover or verify the
projectIdvalues that exist in an account.