Skip to main content
GET
/
agents
/
{agent_id}
에이전트 단건 조회
curl --request GET \
  --url https://client-api.tryvox.co/v3/agents/{agent_id} \
  --header 'Authorization: Bearer <token>'
{
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "created_at": 123,
  "updated_at": 123,
  "production_version": "v1",
  "data": {
    "prompt": {
      "prompt": "",
      "firstLine": "",
      "firstLineType": "aiFirstDynamic",
      "pauseBeforeSpeakingSeconds": 0,
      "isFirstMessageInterruptible": true
    },
    "stt": {
      "languages": [
        "<string>"
      ],
      "speed": "high"
    },
    "llm": {
      "model": "<string>",
      "temperature": 1
    },
    "voice": {
      "id": "<string>",
      "provider": "<string>",
      "model": "<string>",
      "speed": 1,
      "volume": 1,
      "language": "<string>",
      "temperature": 0.9
    },
    "speech": {
      "responsiveness": 1,
      "boostedKeywords": "<string>"
    },
    "callSettings": {
      "backgroundMusic": "none",
      "backgroundMusicVolume": 0.5,
      "noiseCancellation": "bvc",
      "activationThreshold": 0.55,
      "callTimeoutInSeconds": 900,
      "silenceCallTimeoutInSeconds": 30,
      "ringDurationInSeconds": 30,
      "dtmfTerminationEnabled": false,
      "dtmfTerminationKey": "#",
      "dtmfTimeoutSeconds": 3
    },
    "postCall": {
      "actions": [
        {
          "name": "<string>",
          "isNullable": false,
          "description": "<string>",
          "enumOptions": [
            "<string>"
          ]
        }
      ]
    },
    "security": {
      "optOutSensitiveDataStorage": false
    },
    "webhookSettings": {
      "callDataWebhookUrl": "<string>",
      "inboundCallWebhookUrl": "<string>",
      "inboundCallWebhookSigningEnabled": false
    },
    "knowledge": {
      "ragEnabled": false,
      "knowledgeIds": [
        123
      ]
    },
    "presetDynamicVariables": {},
    "toolIds": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "builtInTools": [
      {
        "toolType": "<string>",
        "name": "end_call",
        "description": "<string>",
        "speakDuringExecution": {
          "enabled": false,
          "messages": [
            "<string>"
          ]
        }
      }
    ]
  },
  "flow_data": {
    "nodes": [
      {
        "id": "<string>",
        "type": "<string>",
        "data": {
          "name": "<string>",
          "prompt": "<string>",
          "staticSentence": "<string>",
          "loopCondition": "<string>",
          "isAllowInterruption": true,
          "isSkipUserResponse": true,
          "globalNodeSettings": {
            "isGlobalNode": false,
            "transitionCondition": "<string>"
          },
          "transitions": [
            {
              "id": "<string>",
              "condition": "<string>",
              "isSkipUserResponse": true,
              "isFallback": true,
              "isGlobalTransition": true
            }
          ],
          "firstLineType": "aiFirst",
          "pauseBeforeSpeakingSeconds": 2.5
        },
        "position": {
          "x": 123,
          "y": 123
        }
      }
    ],
    "edges": [
      {
        "id": "<string>",
        "source": "<string>",
        "target": "<string>",
        "type": "custom",
        "sourceHandle": "<string>"
      }
    ]
  },
  "version": {
    "version": "<string>",
    "is_production": true,
    "created_at": 123,
    "description": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

​
agent_id
string<uuid>
required

agent_id로 반환되는 에이전트 UUID입니다.

Query Parameters

​
version
string
default:current

조회할 버전 selector. "current" (default) · "production" · "v{n}".

Pattern: ^(current|production|v[1-9][0-9]*)$

Response

성공 응답

에이전트 단건 조회 응답. Summary + data·flow_data·version.

create/update 응답은 AgentMutationResponse (validator 메시지 포함).

​
agent_id
string<uuid>
required

에이전트 UUID입니다.

​
name
string
required

에이전트 이름입니다. 버전 스냅샷을 조회하더라도 현재 최상위 이름을 반환합니다.

​
type
enum<string>
required

에이전트 유형입니다. single_prompt 또는 flow 값을 사용합니다.

Available options:
single_prompt,
flow
​
created_at
integer
required

리소스 생성 시각입니다. unix milliseconds 형식입니다.

​
updated_at
integer
required

리소스 마지막 수정 시각입니다. unix milliseconds 형식입니다.

​
production_version
string | null

현재 게시된 production 버전입니다. 없으면 null입니다.

Pattern: ^v[1-9][0-9]*$
Example:

"v1"

​
data
AgentDataResponse · object

선택된 에이전트 설정 스냅샷입니다. 구조는 agent-schema/agent-data-response에 공개되어 있습니다.

​
flow_data
FlowData · object

선택된 flow 그래프 스냅샷입니다. flow 에이전트에는 값이 있고, single_prompt 에이전트는 null입니다.

​
version
AgentVersionMeta · object

스냅샷 조회 시에만 populated (version=v{n} 또는 production).