> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> Manage agent primitives.

Manage agent primitives.

List agents across the projects you can access, or edit definitions within a project. To start an agent run, use [`POST /runs`](/docs/cloud/rest/api-reference/execution-runs-runs/create-run) with `project_id` and `target: { type: "agent", id }`.

[Agents](#agents) · [Prompts](#prompts) · [Tools](#tools) · [Skills](#skills) · [Resources](#resources) · [Tasks](#tasks) · [Workflows](#workflows)

## Agents

List agents you can access across projects. Each result includes the project needed to locate its definition.

Browse agent templates. Use [agent installation](/docs/cloud/rest/apis/agents#agents) to add a selected template.

Configure agent definitions, capabilities, labels, avatars, and installations. Use the [run endpoints](/docs/cloud/rest/apis/orchestration) to start and monitor agent runs.

Read project capabilities and the capabilities enabled for an agent.

Search tools that can be attached to agents.

List, create, update, or delete labels on an agent.

Preview, generate, or read agent avatars.

Install or remove agents from selected projects.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/agents` | [GET](/docs/cloud/rest/api-reference/agents-agents-agents/list-agents), [POST](/docs/cloud/rest/api-reference/agents-agents-agents/create-agent) | List agents; Create agent |
| `/agents` | [GET](/docs/cloud/rest/api-reference/agents-agents-agents/list-agents-across-projects) | List agents across projects |
| `/projects/{project_reference}/agents/{agent_id}/card` | [GET](/docs/cloud/rest/api-reference/agents-agents-agents/get-agent) | Get agent |
| `/projects/{project_reference}/agents/{agent_id}` | [GET](/docs/cloud/rest/api-reference/agents-agents-agents/get-agent-source), [PUT](/docs/cloud/rest/api-reference/agents-agents-agents/update-agent), [DELETE](/docs/cloud/rest/api-reference/agents-agents-agents/delete-agent) | Get agent source; Update agent; Delete agent |
| `/projects/{project_reference}/agents/{agent_id}/rename` | [POST](/docs/cloud/rest/api-reference/agents-agents-agents/rename-agent) (deprecated) | Rename agent |
| `/projects/{project_reference}/agents/{agent_id}/labels` | [GET](/docs/cloud/rest/api-reference/agents-agents-agent-labels/list-agent-labels), [POST](/docs/cloud/rest/api-reference/agents-agents-agent-labels/create-agent-label) | List agent labels; Create agent label |
| `/projects/{project_reference}/agents/{agent_id}/labels/{label_id}` | [PUT](/docs/cloud/rest/api-reference/agents-agents-agent-labels/update-agent-label), [DELETE](/docs/cloud/rest/api-reference/agents-agents-agent-labels/delete-agent-label) | Update agent label; Delete agent label |
| `/agent-templates` | [GET](/docs/cloud/rest/api-reference/agents-agents-agent-templates/list-agent-templates) | List agent templates |
| `/projects/{project_reference}/agent-tool-references` | [GET](/docs/cloud/rest/api-reference/agents-agents-agent-tool-references/search-attachable-agent-tools) | Search attachable agent tools |
| `/projects/{project_reference}/agents/{agent_id}/avatar.svg` | [GET](/docs/cloud/rest/api-reference/agents-agents-agent-avatars/get-agent-avatar) | Get agent avatar |
| `/projects/{project_reference}/agents/{agent_id}/avatar` | [POST](/docs/cloud/rest/api-reference/agents-agents-agent-avatars/create-agent-avatar) | Create agent avatar |
| `/projects/{project_reference}/agents/avatar` | [POST](/docs/cloud/rest/api-reference/agents-agents-agent-avatars/preview-agent-avatar) (deprecated) | Preview agent avatar |
| `/projects/{project_reference}/agents/{agent_id}/capabilities` | [GET](/docs/cloud/rest/api-reference/agents-agents-agent-capabilities/get-agent-capabilities) | Get agent capabilities |
| `/projects/{project_reference}/capabilities` | [GET](/docs/cloud/rest/api-reference/agents-agents-agent-capabilities/get-capabilities) | Get capabilities |
| `/projects/{project_reference}/agents/{agent_id}/install` | [POST](/docs/cloud/rest/api-reference/agents-agents-agent-installation/install-agent), [DELETE](/docs/cloud/rest/api-reference/agents-agents-agent-installation/uninstall-agent) | Install agent; Uninstall agent |
| `/projects/{project_reference}/agents/{agent_id}/install-selected` | [POST](/docs/cloud/rest/api-reference/agents-agents-agent-installation/install-agents) | Install agents |

## Prompts

Manage prompts stored in project source. List prompts, read their source, and edit supported fields for the selected source version.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/prompts` | [GET](/docs/cloud/rest/api-reference/agents-prompts-project-prompts/list-prompts), [POST](/docs/cloud/rest/api-reference/agents-prompts-project-prompts/create-prompt) | List prompts; Create prompt |
| `/projects/{project_reference}/prompts/{prompt_id}` | [GET](/docs/cloud/rest/api-reference/agents-prompts-project-prompts/get-prompt), [PUT](/docs/cloud/rest/api-reference/agents-prompts-project-prompts/update-prompt), [DELETE](/docs/cloud/rest/api-reference/agents-prompts-project-prompts/delete-prompt) | Get prompt; Update prompt; Delete prompt |
| `/projects/{project_reference}/prompts/{prompt_id}/source` | [GET](/docs/cloud/rest/api-reference/agents-prompts-project-prompts/read-prompt-source) | Read prompt source |

## Tools

Manage tool definitions in project source. Use [integration tool endpoints](/docs/cloud/rest/apis/integrations#integrations) to discover and invoke connected-service tools.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/tools` | [GET](/docs/cloud/rest/api-reference/agents-tools-project-tools/list-tools), [POST](/docs/cloud/rest/api-reference/agents-tools-project-tools/create-tool) | List tools; Create tool |
| `/projects/{project_reference}/tools/{tool_id}` | [GET](/docs/cloud/rest/api-reference/agents-tools-project-tools/get-tool), [PUT](/docs/cloud/rest/api-reference/agents-tools-project-tools/update-tool), [DELETE](/docs/cloud/rest/api-reference/agents-tools-project-tools/delete-tool) | Get tool; Update tool; Delete tool |
| `/projects/{project_reference}/tools/{tool_id}/source` | [GET](/docs/cloud/rest/api-reference/agents-tools-project-tools/read-tool-source) | Read tool source |

## Skills

Manage skills stored in project source. List skills, read their source, and edit the fields supported by the selected source and definition format.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/skills` | [GET](/docs/cloud/rest/api-reference/agents-skills-project-skills/list-skills), [POST](/docs/cloud/rest/api-reference/agents-skills-project-skills/create-skill) | List skills; Create skill |
| `/projects/{project_reference}/skills/{skill_id}` | [GET](/docs/cloud/rest/api-reference/agents-skills-project-skills/get-skill), [PUT](/docs/cloud/rest/api-reference/agents-skills-project-skills/update-skill), [DELETE](/docs/cloud/rest/api-reference/agents-skills-project-skills/delete-skill) | Get skill; Update skill; Delete skill |
| `/projects/{project_reference}/skills/{skill_id}/source` | [GET](/docs/cloud/rest/api-reference/agents-skills-project-skills/read-skill-source) | Read skill source |

## Resources

Create and edit project resources, the MCP resource definitions stored in project source, and read their source. Manage servers and other deployment infrastructure through the [Deployment API](/docs/cloud/rest/apis/deployments).

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/resources` | [GET](/docs/cloud/rest/api-reference/agents-resources-project-resources/list-project-resources), [POST](/docs/cloud/rest/api-reference/agents-resources-project-resources/create-project-resource) | List project resources; Create project resource |
| `/projects/{project_reference}/resources/{resource_id}` | [GET](/docs/cloud/rest/api-reference/agents-resources-project-resources/get-project-resource), [PUT](/docs/cloud/rest/api-reference/agents-resources-project-resources/update-project-resource), [DELETE](/docs/cloud/rest/api-reference/agents-resources-project-resources/delete-project-resource) | Get project resource; Update project resource; Delete project resource |
| `/projects/{project_reference}/resources/{resource_id}/source` | [GET](/docs/cloud/rest/api-reference/agents-resources-project-resources/read-project-resource-source) | Read project resource source |

## Tasks

Manage task definitions stored in project source. List definitions, read their source, and edit supported fields. To start a task run, use [`POST /runs`](/docs/cloud/rest/api-reference/execution-runs-runs/create-run) with `project_id` and `target: { type: "task", id }`.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/tasks` | [GET](/docs/cloud/rest/api-reference/agents-tasks-tasks/list-tasks), [POST](/docs/cloud/rest/api-reference/agents-tasks-tasks/create-task) | List tasks; Create task |
| `/projects/{project_reference}/tasks/{task_id}` | [GET](/docs/cloud/rest/api-reference/agents-tasks-tasks/get-task), [PUT](/docs/cloud/rest/api-reference/agents-tasks-tasks/update-task-with-put-legacy) (deprecated), [PATCH](/docs/cloud/rest/api-reference/agents-tasks-tasks/update-task), [DELETE](/docs/cloud/rest/api-reference/agents-tasks-tasks/delete-task) | Get task; Update task with PUT (legacy); Update task; Delete task |
| `/projects/{project_reference}/tasks/{task_id}/source` | [GET](/docs/cloud/rest/api-reference/agents-tasks-tasks/read-task-source) | Read task source |

## Workflows

Manage workflow definitions stored in project source. List definitions, read their source, and edit supported fields. To start a workflow run, use [`POST /runs`](/docs/cloud/rest/api-reference/execution-runs-runs/create-run) with `project_id` and `target: { type: "workflow", id }`.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/workflows` | [GET](/docs/cloud/rest/api-reference/agents-workflows-workflows/list-workflows), [POST](/docs/cloud/rest/api-reference/agents-workflows-workflows/create-workflow) | List workflows; Create workflow |
| `/projects/{project_reference}/workflows/{workflow_id}` | [GET](/docs/cloud/rest/api-reference/agents-workflows-workflows/get-workflow), [PUT](/docs/cloud/rest/api-reference/agents-workflows-workflows/update-workflow-with-put-legacy) (deprecated), [PATCH](/docs/cloud/rest/api-reference/agents-workflows-workflows/update-workflow), [DELETE](/docs/cloud/rest/api-reference/agents-workflows-workflows/delete-workflow) | Get workflow; Update workflow with PUT (legacy); Update workflow; Delete workflow |
| `/projects/{project_reference}/workflows/{workflow_id}/source` | [GET](/docs/cloud/rest/api-reference/agents-workflows-workflows/read-workflow-source) | Read workflow source |

[Back to REST API reference](/docs/cloud/rest)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.