Actions29
Overview
This node allows you to interact with "agents" in the BookedIn AI platform, specifically enabling you to update an existing agent's configuration. Updating an agent involves modifying its name, main objective, core instructions (prompt), AI model, webhook URL for event notifications, and whether it should update lead fields automatically.
Use cases include refining or changing the behavior and goals of an AI agent after creation, such as adjusting its personality prompt, switching to a different AI model version, or updating integration endpoints.
For example, if you initially created an agent to book meetings but want to pivot it to handle customer support queries, you can update its objective and prompt accordingly using this operation.
Properties
| Name | Meaning |
|---|---|
| Agent ID | The unique identifier of the agent to update. |
| Agent Name | A human-readable name for your agent. |
| Objective | The main objective or goal that the agent is designed to achieve. |
| Agent Prompt | Core instructions and personality traits defining how the AI behaves and responds. |
| Model | The AI model to use for the agent. Options: GPT-4o, GPT-4.1 |
| Webhook URL | Optional URL where agent events will be sent as webhooks. |
| Update Lead Fields | Boolean flag indicating whether the agent should update lead fields automatically. |
Output
The node outputs JSON data representing the updated agent object returned from the BookedIn API. This typically includes the agent's ID, name, configuration details (objective, prompt, model, webhook URL, update lead fields setting), timestamps, and other metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating requests to the BookedIn API.
- The node makes HTTP requests to
https://api.bookedin.ai/api/v1/agents/{agentId}with method PUT to update the agent. - Proper network connectivity and valid credentials are necessary.
Troubleshooting
- Invalid Agent ID: If the provided Agent ID does not exist or is malformed, the API will return an error. Verify the ID format and existence.
- Missing Required Fields: The node requires all update fields (name, objective, prompt, model) to be provided. Omitting any required field may cause errors.
- Webhook URL Format: If provided, ensure the webhook URL is a valid URL string; otherwise, the API might reject the request.
- API Authentication Errors: Ensure the API key credential is correctly configured and has permissions to update agents.
- Network Issues: Timeouts or connectivity problems will prevent successful updates.
- Model Option: Only the specified models ("GPT-4o", "GPT-4.1") are accepted. Using unsupported values will cause errors.
Links and References
- BookedIn API Documentation (assumed official docs for further details)
- OpenAI GPT Models (for understanding model options)