Test Function

Automation endpoint used by voice agents and trusted clients to execute workflow actions or retrieve evaluation results.

POST /test-function

cURL

curl --request POST \
  --url 'https://api.voice.stateset.com/test-function' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "args": {
    "order_id": "12345"
  },
  "context": {
    "agent_name": "Front Desk",
    "authenticated": true,
    "customer_id": "cust-789",
    "customer_phone": "[phone]",
    "org_id": "org-456",
    "session_id": "sess-abc123"
  },
  "name": "get_order"
}'

200

{
  "ok": true,
  "result": {
    "order": {
      "id": "12345",
      "status": "shipped"
    }
  }
}

Automation endpoint used by voice agents and trusted clients to execute workflow actions or retrieve evaluation results.

Request body

FunctionTestRequest

args · object · required

Function arguments as JSON

context · FunctionContextInput,null

name · string · required

Function name to execute

Response

FunctionTestResponse

error · string,null

Error message (if failed)

ok · boolean · required

Whether the function executed successfully

result · object

Function result (if successful)

Status codes

Code	Meaning
200	Function executed
401	Unauthorized
500	Function execution failed

cURL

curl --request POST \
  --url 'https://api.voice.stateset.com/test-function' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "args": {
    "order_id": "12345"
  },
  "context": {
    "agent_name": "Front Desk",
    "authenticated": true,
    "customer_id": "cust-789",
    "customer_phone": "[phone]",
    "org_id": "org-456",
    "session_id": "sess-abc123"
  },
  "name": "get_order"
}'

200

{
  "ok": true,
  "result": {
    "order": {
      "id": "12345",
      "status": "shipped"
    }
  }
}