VoiceLayerDocs
Dashboard

List an agent's declared actions

GET
/v1/agents/{id}/action-activations

Returns the catalog actions (texts, emails, bookings, connected apps) the agent's published code declares, each with the fingerprint of what was declared and whether an Admin has switched it on, plus the record of who switched what and when. A declaration runs only while its exact fingerprint is on; changing the code changes the fingerprint.

Requires an API key with the agent_actions:read scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The agent id.

Response Body

The actions the agent's published version declares, and the record of who switched what

application/json
  1. response
declared*array<>
records*array<>
Example Request
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/action-activations" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "declared": [    {      "toolName": "vl_send_text",      "actionId": "vl.send_text",      "fingerprint": "f3a9c1d2e4b5a6978877665544332211",      "confirm": false,      "sendRealValues": false,      "connectionId": null,      "active": true    }  ],  "records": [    {      "actionId": "vl.send_text",      "fingerprint": "f3a9c1d2e4b5a6978877665544332211",      "activatedBy": "user:user_2abc",      "activatedAt": "2026-10-20T15:04:05.000Z",      "revokedBy": null,      "revokedAt": null    }  ]}