# iwy.ai Documentation

## Docs

- [API Reference](https://docs.iwy.ai/api-reference/api-reference.md): Complete API reference for creating and managing AI agents
- [Create ephemeral agent](https://docs.iwy.ai/api-reference/code-first/create-ephemeral-agent.md): Creates a one-time use agent with automatic expiration.
- [Single-Use Agents](https://docs.iwy.ai/api-reference/code-first/overview.md): Create agents that activate once and then expire
- [Create a new agent](https://docs.iwy.ai/api-reference/dashboard/agents/create-a-new-agent.md): Creates a new agent with the specified configuration. The agent will be linked to your account and can be used immediately.
- [Delete agent](https://docs.iwy.ai/api-reference/dashboard/agents/delete-agent.md): Permanently deletes the specified agent. This action cannot be undone. All associated sessions and data will be removed.
- [Get agent by ID](https://docs.iwy.ai/api-reference/dashboard/agents/get-agent-by-id.md): Returns the complete configuration for a specific agent, including all settings for LLM, STT, TTS, video, and tool integrations.
- [List all agents](https://docs.iwy.ai/api-reference/dashboard/agents/list-all-agents.md): Returns a list of all agents linked to your account. The response includes basic information about each agent including UUID, name, and timestamps.
- [Update agent configuration](https://docs.iwy.ai/api-reference/dashboard/agents/update-agent-configuration.md): Updates the configuration of an existing agent. Only the fields provided in the request will be updated; other fields will remain unchanged.
- [Permanent Agents](https://docs.iwy.ai/api-reference/dashboard/overview.md): Create reusable agents manageable via the iwy dashboard
- [Sessions & Deployment](https://docs.iwy.ai/api-reference/dashboard/sessions/overview.md): Understand sessions and choose how to deploy your agents
- [Start agent session](https://docs.iwy.ai/api-reference/dashboard/sessions/start-agent-session.md): Starts a video call session with an agent. This endpoint creates a Daily.co room and returns the connection details needed to join the call.
- [Create a new tool](https://docs.iwy.ai/api-reference/dashboard/tools/create-a-new-tool.md): Creates a new custom tool that agents can use. Tools are defined by their parameters schema (JSON Schema format) and the webhook endpoint they call.
- [Delete tool](https://docs.iwy.ai/api-reference/dashboard/tools/delete-tool.md): Permanently deletes the specified tool. This action cannot be undone. Agents using this tool will no longer be able to call it.
- [Get tool by ID](https://docs.iwy.ai/api-reference/dashboard/tools/get-tool-by-id.md): Returns the complete configuration for a specific tool, including its parameters schema, webhook URL, and authentication settings.
- [List all tools](https://docs.iwy.ai/api-reference/dashboard/tools/list-all-tools.md): Returns a list of all custom tools linked to your account. Tools are functions that your agents can call to interact with external services.
- [Tools](https://docs.iwy.ai/api-reference/dashboard/tools/overview.md): Extend your agents with custom functions via webhooks
- [Test tool execution](https://docs.iwy.ai/api-reference/dashboard/tools/test-tool-execution.md): Tests a tool by executing it with the provided parameters. This allows you to verify that your webhook is configured correctly and returns the expected response. You can also use `validate_only` to test parameter validation without actually calling the webhook.
- [Update tool configuration](https://docs.iwy.ai/api-reference/dashboard/tools/update-tool-configuration.md): Updates the configuration of an existing tool. You can modify the parameters schema, webhook URL, headers, and other settings.
- [Hosted](https://docs.iwy.ai/connect-embed/hosted.md): Direct agent URLs for easy sharing
- [Iframe Embed](https://docs.iwy.ai/connect-embed/iframe-embed.md): Embed AI agents using iframe for flexible website integration
- [Connect & Embed](https://docs.iwy.ai/connect-embed/index.md)
- [Script Tag Embed](https://docs.iwy.ai/connect-embed/script-tag-embed.md): Add agent widget to your website with a script tag
- [White-Label Hosted](https://docs.iwy.ai/connect-embed/white-label-hosted.md): Custom-branded hosting on your own domain
- [Common Use Cases](https://docs.iwy.ai/examples/common-use-cases.md): Get started on your conversational AI agent journey
- [iwy](https://docs.iwy.ai/index.md): Understand how and why iwy helps remove operational complexity
- [FAQ](https://docs.iwy.ai/overview/faq.md): Frequently asked questions and troubleshooting
- [Quickstart](https://docs.iwy.ai/overview/quickstart.md): Create your first AI agent in under 30 seconds

## OpenAPI Specs

- [openapi](https://docs.iwy.ai/api-reference/openapi.json)

## Optional

- [Homepage](https://www.iwy.ai)
- [Dashboard](https://app.iwy.ai)
- [GitHub](https://github.com/iwy-ai)