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

# Get agent actions

> Every action an AI agent took on a contract through the Sendforsign MCP server: which agent, on whose behalf, what it did, and whether it was allowed.

Returns the agent action log of one contract, oldest first. Each change an AI agent makes through the
[MCP server](https://sendforsign.com/docs/ai-agents/overview.md) is recorded, including actions that were blocked by the connection's mode or domain
allowlist. The same entries appear in the contract timeline of the editor. See [Accountability](https://sendforsign.com/docs/ai-agents/accountability.md).

### Query parameters

**clientKey** `string` *required*

Key of the client.

**contractKey** `string` *required*

Key of the contract.

### Response

An array of actions:

**createTime** `string`

When the action happened.

**agent** `string`

The agent or AI application (the OAuth app name or `X-Sendforsign-Agent`).

**onBehalfOf** `string`

The person the agent acted for, when known.

**mode** `string`

`read_only`, `draft` or `send`.

**tool** `string`

The MCP tool, such as `create_contract` or `send_for_signature`.

**outcome** `string`

`ok`, `blocked` or `error`.

**message** `string`

Why it was blocked or failed.

```bash cURL theme={null}
curl -X GET 'https://api.sendforsign.com/api/agent_action?clientKey=CLIENT_KEY&contractKey=CONTRACT_KEY' \
     -H 'X-Sendforsign-Key: YOUR_API_KEY'
```

```json Response theme={null}
[
  { "createTime": "2026-11-18T10:02:11Z", "agent": "Claude", "onBehalfOf": "mia@studionord.example",
    "mode": "send", "tool": "create_contract", "outcome": "ok", "message": null },
  { "createTime": "2026-11-18T10:03:40Z", "agent": "Claude", "onBehalfOf": "mia@studionord.example",
    "mode": "send", "tool": "send_for_signature", "outcome": "blocked",
    "message": "<why the connection's rules refused it>" }
]
```


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