Skip to main content
GET
/
v1
/
agents
List Agents
curl --request GET \
  --url https://api.sigmamind.ai/v1/agents \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "agentId": "SPIlVscbB0kkXBvZ",
      "agentName": "Auralis",
      "instructions": "You are a helpful customer support assistant. Answer concisely and professionally.",
      "welcomeMessageType": "static",
      "welcomeMessage": "Welcome to our service! How can I assist you today?",
      "agentSettings": {
        "language": "en_US",
        "aiStartsConversation": true,
        "backgroundSound": "keyboard_typing",
        "globalPrompt": "You are a professional virtual assistant. Always respond politely and keep answers concise.",
        "remindersIntervalDuration": 15,
        "remindersLimit": 3,
        "endCallOnSilenceDuration": 30,
        "maxCallDuration": 40,
        "llmModel": "gpt-4o-mini",
        "llmTemperature": 0.5,
        "llmTopP": 0.5,
        "llmTopK": 40,
        "voiceId": "elevenlabs_SGbOfpm28edC83pZ9iGb",
        "voiceModelId": "eleven_turbo_v2_5",
        "ttsSpeed": 0.7,
        "ttsTemperature": 0.5,
        "ttsVolume": 0.5,
        "aiStartsSpeakingPlan": 0.5,
        "aiStopsSpeakingPlan": 0.5,
        "ivrHangup": true,
        "agentTimezone": "Asia/Kolkata",
        "autoVolumeNormalization": true,
        "backgroundNoiseFilter": true,
        "echoCancellation": true,
        "enablePostConversationAnalysis": true,
        "postConversationAnalysisLlmModel": "gpt-4o-mini",
        "postConversationAnalysis": [
          {
            "insightName": "conversation summary",
            "insightInstructions": "<string>",
            "dataType": "string",
            "options": [
              "Interested",
              "Not Interested",
              "Follow Up Later"
            ]
          }
        ],
        "webhooks": [
          {
            "webhookId": "wh_BUbkx3PsbzQm5V10",
            "name": "My Webhook",
            "url": "https://example.com/webhook",
            "secret": "mK9vXq2pL8nR5tY1wA3sD6fH0jC4bE7u",
            "events": [
              "<string>"
            ]
          }
        ]
      },
      "tools": [
        {
          "type": "voice_transfer_call",
          "instruction": "<string>",
          "transferToRouting": "static",
          "transferTo": "+9187788XXXXX",
          "extensionNumber": "1234",
          "transferSettings": {
            "transferType": "warm",
            "ringingDuration": 40,
            "waitForParticipantAnswer": true,
            "enableWhisperMessage": true,
            "whisperMessage": "<string>",
            "whisperMessageType": "static",
            "enableThreeWayMessage": true,
            "threeWayMessage": "<string>",
            "threeWayMessageType": "static",
            "customHeaders": {}
          }
        }
      ]
    }
  ],
  "page": 123,
  "size": 123,
  "totalCount": 123,
  "totalPages": 123,
  "hasNext": true,
  "hasPrevious": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.sigmamind.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-Key
string
header
required

Authenticate every request by passing your API key in the X-API-Key header. To get your key, go to Dashboard → API Keys and create or copy your Production API key.

Query Parameters

page
integer<int32>
default:0

Zero-based page number to retrieve. Use 0 for the first page. Must be 0 or greater.

size
integer<int32>
default:10

Number of single prompt changes to retrieve per page. Must be 1 or greater.

Response

OK

Standard wrapper for paginated API responses. Use this when returning list data that is split across multiple pages. Includes the current page of results along with pagination metadata to help clients navigate through large datasets efficiently.

data
object[]

List of items for the current page. Contains up to 'size' number of records.

page
integer<int32>

Current page number (0-based index). Indicates which page of results is being returned.

size
integer<int32>

Number of items requested per page. Determines the maximum size of the 'data' list.

totalCount
integer<int64>

Total number of records available across all pages. Useful for calculating pagination on the client side.

totalPages
integer<int32>

Total number of pages available based on totalCounts and size. Helps clients understand how many pages exist in total.

hasNext
boolean

Indicates whether there is a next page available after the current one. Useful for implementing 'Load More' or next navigation.

hasPrevious
boolean

Indicates whether there is a previous page before the current one. Useful for enabling backward navigation.