**Source URL:** https://general.veevavault.dev/sitevault/ai-agents/api/retrieve-agent-action.md

# Retrieve Agent Action

<Aside type="note">The functionality described on this page is only available to customers who have licensed Veeva AI.</Aside>
Retrieve the details of a specific agent action.

<Endpoint path="/api/{version}/services/ai/agent_action/{agent_name}/{actionName}" method="GET"></Endpoint>

## Headers {#headers}

<FieldTable>
| Name | Description |
| --- | --- |
| `Accept` | `application/json` (default) or `application/xml` |
</FieldTable>

## URI Path Parameters {#uri-path-parameters}

<FieldTable>
| Name | Description |
| --- | --- |
| `{agent_name}` | The name of the agent to retrieve. For example, `promomats_document_chat__v`. |
| `{action_name}` | The name of the action to retrieve. For example, `spelling_grammar__v`. |
</FieldTable>

## Request {#request}

<CodeExample title="">
```
curl --location 'https://myvault.veevavault.com/api/v26.1/services/ai/agent_action/quick_check__v/spelling_grammar__v' \
--header 'Accept: application/json' \
--header 'Authorization: {SESSION_ID}' \
--header 'X-VaultAPI-ClientID: veeva-vault-api-reference-example'

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
   "responseStatus": "SUCCESS",
   "agentAction": {
       "name": "spelling_grammar__v",
       "label": "Spelling and Grammar",
       "active": true,
       "source": "standard",
       "description": "Performs a mechanical proofreading check on the document. Identifies spelling errors, typos, malformed technical terminology, and structural grammatical faults (syntax, morphology, and punctuation). Focuses strictly on linguistic accuracy and reading flow, leveraging domain-specific medical knowledge to identify technical errors while ignoring regulatory or scientific validity.",
       "supportChat": false,
       "toolEvaluation": "AUTO"
   }
}

```
</CodeExample>

## Response Details {#response-details}

On `SUCCESS`, the response contains details about the specified agent and each action it can perform.



---

**Previous:** [Retrieve All Agent Actions](/sitevault/ai-agents/api/retrieve-agent-actions)  
**Next:** [Execute Agent Action](/sitevault/ai-agents/api/execute-agent-action)