Agentic - Agents

Query agents with filters, sorting and pagination

Retrieve a list of AI agents with advanced filtering, sorting, and pagination. Access complete agent configurations including prompts, settings, and integrations.

Query Capabilities:

  • Filter by agent type (prompt-based, analysis-agent, ai-assistant, node-based)
  • Search by name or system prompt content
  • Filter by language or capabilities
  • Sort by any field (name, creation date, last modified, etc.)
  • Paginate with limit and nextId

Response Includes:

  • Agent configuration (name, type, prompts)
  • Phone and email settings
  • Voice configuration and language
  • Connected knowledge bases and workflows
  • Integration settings
  • Appointment settings

Common Use Cases:

  • List all customer-facing agents
  • Find agents by capability or language
  • Export agent configurations
  • Audit agent settings across organization
post/api/v1/agentic/agents/query

Request

  • Base URL: https://api.voicelogica.ai
  • URL: https://api.voicelogica.ai/api/v1/agentic/agents/query
  • Auth: API key in header x-api-key

Headers

x-api-keystring required

Your API key for authentication. Required for all endpoints.

x-company-idstring

Optional company ID for resellers. When provided, the API request will operate on behalf of the specified subsidiary company. The API key must have access to the specified company.

Request body

Response

Agents retrieved successfully with pagination

totalinteger required

Total number of records

nextIdstring nullable

ID of the next page, if available

currentTotalinteger required

Number of records in the current response

Example response

{
  "data": [
    {}
  ],
  "total": 1,
  "nextId": null,
  "currentTotal": 1
}

Changes

No recorded changes to this operation across all 2 revisions of this API.