VoiceLayerDocs
Dashboard

Switch on a declared action

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

Switches on one declaration of the agent's published version, by actionId and fingerprint. It needs a workspace admin's session: a key that asks gets 403 forbidden. A fingerprint the published version does not declare is 409 declaration_not_found. Activating again after a revoke adds a new record; the earlier one stays.

Requires an API key with the agent_actions:write 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.

Request Body

application/json
  1. body
actionId*string

The declared action.

Length1 <= length <= 200
fingerprint*string

The fingerprint from the list.

Length1 <= length <= 400

Response Body

Switched on

application/json
  1. response
activated*boolean
Example Request
curl -X PUT "https://api.vlayers.ai/v1/agents/$AGENT_ID/action-activations" \  -H "Authorization: Bearer $VOICELAYER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "actionId": "vl.send_text",    "fingerprint": "f3a9c1d2e4b5a6978877665544332211"  }'
Example Response
{  "activated": true}