Eleven Labs Conversational icon

Eleven Labs Conversational

Interact with ElevenLabs Conversational AI API

Actions26

Agent → Get Link

AI-generated

Overview

The "Get Link" operation for the Agent resource in this node retrieves a URL associated with a specific agent. This link can be used to share or access the agent externally. Optionally, the node can generate a shareable token that secures the link, controlling its validity period and usage limits.

This operation is useful when you want to provide external users or systems with controlled access to an agent instance without exposing full credentials or APIs. For example, you might generate a temporary link for a customer support chatbot agent that expires after a set number of days or uses.

Properties

Name Meaning
Agent ID The unique identifier of the agent for which to get the link.
Options Collection of optional settings:
- Generate Shareable Token Boolean flag indicating whether to create a shareable token for the agent link.
- Token Duration (Days) Number of days the generated token remains valid (only shown if token generation is enabled).
- Max Uses Maximum number of times the token can be used; 0 means unlimited (only shown if token generation is enabled).

Output

The output JSON contains the data returned from the service call to retrieve the agent's link. This typically includes the URL itself and, if requested, the generated token details such as expiration and usage limits.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the ElevenLabs Conversational AI API.
  • The node depends on internal services that handle agent operations, specifically the AgentService.
  • No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

  • Invalid Agent ID: If the provided Agent ID does not exist or is malformed, the node will likely throw an error indicating the agent could not be found. Verify the Agent ID is correct.
  • Token Generation Errors: If token generation is enabled but invalid parameters are provided (e.g., negative duration or max uses), the API may reject the request. Ensure token duration is positive and max uses is zero or a positive integer.
  • Authentication Failures: Missing or incorrect API credentials will cause authentication errors. Confirm the API key credential is properly configured.
  • Rate Limits or API Downtime: Temporary failures may occur due to API rate limiting or service outages. Retrying after some time or checking API status may resolve these issues.

Links and References

Discussion