Agent Blueprints

Retrieves all available agent blueprints and their default version configurations along with workflow mappings. This endpoint provides comprehensive information about voice agents including their full configuration, version details, and which workflows they are associated with.

GET /agent/blueprints

Retrieve agent blueprints

cURL

curl --request GET \
  --url https://api.subverseai.com/api/agent/blueprints \
  --header 'x-api-key: <api-key>'

200

{
  "responseCode": 200,
  "message": "Agent blueprints retrieved successfully!",
  "data": {
    "agents": [
      {
        "agentId": "customer_support_agent",
        "config": {
          "llmService": {
            "provider": "openai",
            "model": "gpt-4o-mini",
            "temperature": 0.5
          },
          "sttService": {
            "provider": "deepgram",
            "model": "nova-2-general",
            "language": "en-US",
            "smartFormat": false,
            "numerals": false,
            "keywords": null
          },
          "ttsService": {
            "provider": "elevenlabs",
            "model": "eleven_flash_v2_5",
            "language": "en-US",
            "gender": "female",
            "voiceName": "monika",
            "customVoiceId": "",
            "speed": 1,
            "stability": 0.5,
            "similarityBoost": 0.8,
            "pitch": 1,
            "volume": 1
          },
          "agentInstructions": {
            "initialMessage": {
              "messageContent": "Hello! I'm your virtual assistant. How can I help you today?",
              "messageType": "say",
              "firstSpeaker": "assistant"
            },
            "systemContext": [
              {
                "system": "You are a helpful customer service agent for a telecommunications company."
              }
            ],
            "conversationalFlow": {
              "nodes": [
                {
                  "id": "welcome",
                  "type": "message",
                  "data": {
                    "message": "Welcome!"
                  },
                  "position": {
                    "x": 0,
                    "y": 0
                  }
                }
              ],
              "edges": []
            }
          },
          "callSettings": {
            "dtmfEnabled": false,
            "transferTo": "",
            "transferDtmf": "",
            "warmTransfer": false,
            "sipRefer": false,
            "backgroundAmbient": false,
            "backgroundThinking": false,
            "whisper": false,
            "falseInterruptionTimer": 3,
            "preemptiveGeneration": true
          },
          "pipelineSettings": {
            "commMethod": "two_way",
            "silenceTime": 8,
            "silenceTurns": 2,
            "knowledgeBaseId": "",
            "maxDuration": 600
          },
          "turnManagement": {
            "interruptionOverall": true,
            "interruptionInitial": false,
            "interruptionSensitivity": 2,
            "agentResponsiveness": 4,
            "agentBackchannel": {
              "enabled": true,
              "threshold": 0,
              "fillerWords": [],
              "probability": 1,
              "interruptions": true,
              "addToContext": false
            }
          },
          "analyticsConfig": {
            "enabled": true,
            "provider": "openai",
            "model": "gpt-4o-mini",
            "instructions": null,
            "queries": [
              {
                "name": "summary",
                "description": "Summary of discussion",
                "type": "text",
                "options": []
              }
            ]
          },
          "functionSettings": {
            "preCall": [],
            "duringCall": [
              "end_call",
              "transfer_call"
            ],
            "postCall": []
          },
          "agentsList": [
            {
              "transferTo": "billing_agent",
              "useBaseSettings": true,
              "agentVersion": "DEFAULT"
            }
          ],
          "dynamicVariablesConfig": [
            {
              "name": "customer_name",
              "description": "Customer's full name"
            }
          ]
        },
        "version": {
          "name": "v0",
          "description": "First version",
          "number": 0
        }
      }
    ],
    "workflowList": [
      {
        "workflowId": "customer_support",
        "agentId": "customer_support_agent"
      }
    ]
  }
}

Authorizations

x-api-key · string · header · required

Authentication header containing API key from SubVerse dashboard.

Response

200

application/json

Agent blueprints retrieved successfully

responseCode · integer · required

HTTP status code indicating the result of the request.

Example:

200

message · string · required

Human-readable message describing the result of the request.

Example:

"Agent blueprints retrieved successfully!"

data · object · required

Show child attributes