# Agents The **Intelligence Layer** is the brain of your application. It's where reasoning, logic, and autonomous action take place. This layer is powered by **Taskade's AI Agents**. An Agent is more than just a chatbot. It is an autonomous worker that can be configured with a specific personality, skillset, and access to knowledge. You can use Agents to: * **Power a Chatbot:** Provide intelligent, context-aware answers to user queries based on the app's Knowledge Layer. * **Execute Complex Tasks:** Trigger agents via automations to perform multi-step operations like analyzing data, qualifying leads, or summarizing documents. * **Collaborate with Humans:** Assign tasks to agents and have them work alongside your team members within a project. These endpoints allow you to create, manage, and interact with the AI Agents that bring your applications to life. ### Learn More * [**Custom AI Agents ›**](https://help.taskade.com/en/articles/8958457-custom-ai-agents) * [**Tools for AI Agents ›**](https://help.taskade.com/en/articles/9314171-tools-for-ai-agents) ## Summary of Endpoints ### Update Agent Public Access {% openapi src="" path="/agents/{agentId}/publicAccess" method="put" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %} ### Get Agent {% openapi src="" path="/agents/{agentId}" method="get" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %} ### Delete Agent {% openapi src="" path="/agents/{agentId}" method="delete" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %} ### Update Agent {% openapi src="" path="/agents/{agentId}" method="patch" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %} ### Get Public Agent {% openapi src="" path="/agents/{agentId}/public-agent" method="get" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %} ### Update Public Agent {% openapi src="" path="/agents/{agentId}/public-agent" method="patch" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %} ### Add Project to Agent Knowledge {% openapi src="" path="/agents/{agentId}/knowledge/project" method="post" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %} ### Add Media to Agent Knowledge {% openapi src="" path="/agents/{agentId}/knowledge/media" method="post" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %} ### Remove Project from Agent Knowledge {% openapi src="" path="/agents/{agentId}/knowledge/project/{projectId}" method="delete" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %} ### Remove Media from Agent Knowledge {% openapi src="" path="/agents/{agentId}/knowledge/media/{mediaId}" method="delete" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %} ### Get Agent Conversations {% openapi src="" path="/agents/{agentId}/convos/" method="get" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %} ### Get Specific Agent Conversation {% openapi src="" path="/agents/{agentId}/convos/{convoId}" method="get" expanded="true" %} [api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-67a8dca7dcae187ca92c97983b1be8a0aecfa00b%2Fapi-0.1.0.json?alt=media\&token=e1456304-55dd-4486-b72e-cc2f742c8d81) {% endopenapi %}