> ## 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 API

> Define agents, tasks and workflows, and configure their prompts, skills, tools and resources.

For API groups, see [Agents API](/docs/cloud/apis/agents).

## Queries

| Operation | Description |
| - | - |
| [`agents`](/docs/cloud/graphql/operations/agents-api/queries/agents) | Lists runnable agents across projects you can access. |
| [`agentTemplates`](/docs/cloud/graphql/operations/agents-api/queries/agenttemplates) | Lists agent templates and installable catalog agents. |
| [`projectAgent`](/docs/cloud/graphql/operations/agents-api/queries/projectagent) | Returns an agent definition from the selected project source. |
| [`projectAgentCapabilities`](/docs/cloud/graphql/operations/agents-api/queries/projectagentcapabilities) | Returns a project agent and the capabilities resolved for it. |
| [`projectAgentDocument`](/docs/cloud/graphql/operations/agents-api/queries/projectagentdocument) | Returns the agent source document and its editable fields. |
| [`projectAgentLabels`](/docs/cloud/graphql/operations/agents-api/queries/projectagentlabels) | Lists labels for a project agent. |
| [`projectAgents`](/docs/cloud/graphql/operations/agents-api/queries/projectagents) | Lists agents from the selected project source. |
| [`projectAgentsDiscovery`](/docs/cloud/graphql/operations/agents-api/queries/projectagentsdiscovery) | Lists agents with source discovery diagnostics. |
| [`projectAgentToolReferences`](/docs/cloud/graphql/operations/agents-api/queries/projectagenttoolreferences) | Searches the tools a project agent can reference. |
| [`projectCapabilities`](/docs/cloud/graphql/operations/agents-api/queries/projectcapabilities) | Returns the capabilities that agents in a project can use. |
| [`projectPrompt`](/docs/cloud/graphql/operations/agents-api/queries/projectprompt) | Returns a prompt definition from the selected project source. |
| [`projectPromptDocument`](/docs/cloud/graphql/operations/agents-api/queries/projectpromptdocument) | Returns the prompt source document and its editable fields. |
| [`projectPrompts`](/docs/cloud/graphql/operations/agents-api/queries/projectprompts) | Lists prompts from the selected project source. |
| [`projectPromptsDiscovery`](/docs/cloud/graphql/operations/agents-api/queries/projectpromptsdiscovery) | Lists prompts with source discovery diagnostics. |
| [`projectResource`](/docs/cloud/graphql/operations/agents-api/queries/projectresource) | Returns a resource definition from the selected project source. |
| [`projectResourceDocument`](/docs/cloud/graphql/operations/agents-api/queries/projectresourcedocument) | Returns the resource source document and its editable fields. |
| [`projectResources`](/docs/cloud/graphql/operations/agents-api/queries/projectresources) | Lists resources from the selected project source. |
| [`projectResourcesDiscovery`](/docs/cloud/graphql/operations/agents-api/queries/projectresourcesdiscovery) | Lists resources with source discovery diagnostics. |
| [`projectSkill`](/docs/cloud/graphql/operations/agents-api/queries/projectskill) | Returns a skill definition from the selected project source. |
| [`projectSkillDocument`](/docs/cloud/graphql/operations/agents-api/queries/projectskilldocument) | Returns the skill source document and its editable fields. |
| [`projectSkills`](/docs/cloud/graphql/operations/agents-api/queries/projectskills) | Lists skills from the selected project source. |
| [`projectSkillsDiscovery`](/docs/cloud/graphql/operations/agents-api/queries/projectskillsdiscovery) | Lists skills with source discovery diagnostics. |
| [`projectTask`](/docs/cloud/graphql/operations/agents-api/queries/projecttask) | Returns a task definition from the selected project source. |
| [`projectTaskDocument`](/docs/cloud/graphql/operations/agents-api/queries/projecttaskdocument) | Returns the task source document and its editable fields. |
| [`projectTasks`](/docs/cloud/graphql/operations/agents-api/queries/projecttasks) | Lists tasks from the selected project source. |
| [`projectTasksDiscovery`](/docs/cloud/graphql/operations/agents-api/queries/projecttasksdiscovery) | Lists tasks with source discovery diagnostics. |
| [`projectTool`](/docs/cloud/graphql/operations/agents-api/queries/projecttool) | Returns a tool definition from the selected project source. |
| [`projectToolDocument`](/docs/cloud/graphql/operations/agents-api/queries/projecttooldocument) | Returns the tool source document and its editable fields. |
| [`projectTools`](/docs/cloud/graphql/operations/agents-api/queries/projecttools) | Lists tools from the selected project source. |
| [`projectToolsDiscovery`](/docs/cloud/graphql/operations/agents-api/queries/projecttoolsdiscovery) | Lists tools with source discovery diagnostics. |
| [`projectWorkflow`](/docs/cloud/graphql/operations/agents-api/queries/projectworkflow) | Returns a workflow definition from the selected project source. |
| [`projectWorkflowDocument`](/docs/cloud/graphql/operations/agents-api/queries/projectworkflowdocument) | Returns the workflow source document and its editable fields. |
| [`projectWorkflows`](/docs/cloud/graphql/operations/agents-api/queries/projectworkflows) | Lists workflows from the selected project source. |
| [`projectWorkflowsDiscovery`](/docs/cloud/graphql/operations/agents-api/queries/projectworkflowsdiscovery) | Lists workflows with source discovery diagnostics. |

## Mutations

| Operation | Description |
| - | - |
| [`createProjectAgent`](/docs/cloud/graphql/operations/agents-api/mutations/createprojectagent) | Creates an agent definition in project source. |
| [`createProjectAgentLabel`](/docs/cloud/graphql/operations/agents-api/mutations/createprojectagentlabel) | Adds a label to a project agent. |
| [`createProjectPrompt`](/docs/cloud/graphql/operations/agents-api/mutations/createprojectprompt) | Creates a prompt definition in project source. |
| [`createProjectResource`](/docs/cloud/graphql/operations/agents-api/mutations/createprojectresource) | Creates a resource definition in project source. |
| [`createProjectSkill`](/docs/cloud/graphql/operations/agents-api/mutations/createprojectskill) | Creates a skill definition in project source. |
| [`createProjectTask`](/docs/cloud/graphql/operations/agents-api/mutations/createprojecttask) | Creates a task definition in project source. |
| [`createProjectTool`](/docs/cloud/graphql/operations/agents-api/mutations/createprojecttool) | Creates a tool definition in project source. |
| [`createProjectWorkflow`](/docs/cloud/graphql/operations/agents-api/mutations/createprojectworkflow) | Creates a workflow definition in project source. |
| [`deleteProjectAgent`](/docs/cloud/graphql/operations/agents-api/mutations/deleteprojectagent) | Deletes an agent definition from project source. |
| [`deleteProjectAgentLabel`](/docs/cloud/graphql/operations/agents-api/mutations/deleteprojectagentlabel) | Soft-delete a label from a project agent in the selected source. |
| [`deleteProjectPrompt`](/docs/cloud/graphql/operations/agents-api/mutations/deleteprojectprompt) | Deletes a prompt definition from project source. |
| [`deleteProjectResource`](/docs/cloud/graphql/operations/agents-api/mutations/deleteprojectresource) | Deletes a resource definition from project source. |
| [`deleteProjectSkill`](/docs/cloud/graphql/operations/agents-api/mutations/deleteprojectskill) | Deletes a skill definition from project source. |
| [`deleteProjectTask`](/docs/cloud/graphql/operations/agents-api/mutations/deleteprojecttask) | Deletes a task definition from project source. |
| [`deleteProjectTool`](/docs/cloud/graphql/operations/agents-api/mutations/deleteprojecttool) | Deletes a tool definition from project source. |
| [`deleteProjectWorkflow`](/docs/cloud/graphql/operations/agents-api/mutations/deleteprojectworkflow) | Deletes a workflow definition from project source. |
| [`generateProjectAgentAvatar`](/docs/cloud/graphql/operations/agents-api/mutations/generateprojectagentavatar) | Generates an avatar for a project agent and optionally assigns it. |
| [`installProjectAgent`](/docs/cloud/graphql/operations/agents-api/mutations/installprojectagent) | Installs a catalog agent in a project by creating or reusing its access grant. |
| [`installProjectAgentForSelectedProjects`](/docs/cloud/graphql/operations/agents-api/mutations/installprojectagentforselectedprojects) | Installs a catalog agent in the selected projects. |
| [`previewProjectAgentAvatar`](/docs/cloud/graphql/operations/agents-api/mutations/previewprojectagentavatar) | Previews an agent avatar from an avatar configuration without saving it. |
| [`renameProjectAgent`](/docs/cloud/graphql/operations/agents-api/mutations/renameprojectagent) | Renames a project agent. |
| [`uninstallProjectAgent`](/docs/cloud/graphql/operations/agents-api/mutations/uninstallprojectagent) | Revokes the project’s access grant for an installed catalog agent. |
| [`updateProjectAgent`](/docs/cloud/graphql/operations/agents-api/mutations/updateprojectagent) | Updates supported fields in a project agent definition. |
| [`updateProjectAgentLabel`](/docs/cloud/graphql/operations/agents-api/mutations/updateprojectagentlabel) | Replaces a label of a project agent. |
| [`updateProjectPrompt`](/docs/cloud/graphql/operations/agents-api/mutations/updateprojectprompt) | Updates supported fields in a project prompt definition. |
| [`updateProjectResource`](/docs/cloud/graphql/operations/agents-api/mutations/updateprojectresource) | Updates supported fields in a project resource definition. |
| [`updateProjectSkill`](/docs/cloud/graphql/operations/agents-api/mutations/updateprojectskill) | Updates supported fields in a project skill definition. |
| [`updateProjectTask`](/docs/cloud/graphql/operations/agents-api/mutations/updateprojecttask) | Updates supported fields in a project task definition. |
| [`updateProjectTool`](/docs/cloud/graphql/operations/agents-api/mutations/updateprojecttool) | Updates supported fields in a project tool definition. |
| [`updateProjectWorkflow`](/docs/cloud/graphql/operations/agents-api/mutations/updateprojectworkflow) | Updates supported fields in a project workflow definition. |


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