Retrieve a list of agents

get

https://company_subdomain.talkpush.com/api/talkpush_services/agents

Returns a paginated list of AI agents configured in the company account, ordered by most recently updated. Supports optional filtering by category, provider, and active status.

Query Params

api_key

string

required

The API key provided for your application.

category

string

enum

Filter agents by category. Allowed values: screen_interview, phone_call, on_site_interview, event_invitation, passive_candidate_outreach, status_update, reminders.

Allowed:

provider

string

enum

Filter agents by provider. Allowed values: elevenlabs, vapi.

Allowed:

is_active

boolean

Filter agents by active status. true returns only active agents; false returns only inactive agents. Omit to return all.

page

integer

Defaults to 1

Page number of results to return. Defaults to 1.

per_page

integer

≤ 100

Defaults to 20

Number of agents per page. Defaults to 20, maximum 100.

Responses

500

Internal server error, we will provide you with the exception message of the application.

200Agents returned successfully.