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

# list_audit_logs

> List audit logs with Posted MCP.

Read workspace audit history. Administrator access is required; entries exclude post bodies and secrets.

## Workflow

```mermaid theme={"system"}
flowchart LR
  step0["Choose a workspace"] --> step1
  step1["Read its audit history"] --> step2
  step2["Inspect the actor and event"]
```

## Access and behavior

Administrator consent and a current administrator team role are required. Tools are listed and callable only when the current grant and role permit them.

Only administrators with access to the workspace can read these events. Logs begin after the audit feature is installed and exclude secrets and post bodies.

## Arguments

| Argument | Required | Type or meaning |
| - | - | - |
| `page` | No | One-based page number. |
| `pageSize` | No | Records per numbered page, at most 100. |
| `action` | No | string |
| `actorId` | No | JSON value |
| `resourceType` | No | workspace, member, connection, post, draft, media, delivery, api\_key |
| `from` | No | date-time |
| `workspaceId` | Yes | Workspace UUID returned by list\_workspaces, including for Default. |

> **Complete input schema**
>
> ```json theme={"system"}
> {
>   "type": "object",
>   "properties": {
>     "page": {
>       "type": "integer",
>       "minimum": 1,
>       "maximum": 9007199254740991
>     },
>     "pageSize": {
>       "type": "integer",
>       "minimum": 1,
>       "maximum": 100
>     },
>     "action": {
>       "type": "string",
>       "maxLength": 80,
>       "pattern": "^[a-z_]+\\.[a-z_]+$"
>     },
>     "actorId": {
>       "anyOf": [
>         {
>           "type": "string",
>           "format": "uuid",
>           "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
>         },
>         {
>           "type": "string",
>           "const": "system"
>         }
>       ]
>     },
>     "resourceType": {
>       "type": "string",
>       "enum": [
>         "workspace",
>         "member",
>         "connection",
>         "post",
>         "draft",
>         "media",
>         "delivery",
>         "api_key"
>       ]
>     },
>     "from": {
>       "type": "string",
>       "format": "date-time",
>       "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
>     },
>     "workspaceId": {
>       "type": "string",
>       "format": "uuid",
>       "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
>     }
>   },
>   "required": ["workspaceId"],
>   "additionalProperties": false
> }
> ```

## Example call

The client initializes the MCP connection before sending this JSON-RPC call. Example records are fictional.

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_audit_logs",
    "arguments": {
      "workspaceId": "55555555-5555-4555-8555-555555555555",
      "page": 1,
      "pageSize": 25
    }
  }
}
```

## Example result

Posted returns this object in `structuredContent` and a JSON text content block. A tool failure sets `isError`; never treat an error as a completed mutation.

```json theme={"system"}
{
  "items": [
    {
      "id": "22222222-2222-4222-8222-222222222222",
      "workspaceId": "55555555-5555-4555-8555-555555555555",
      "actorId": "66666666-6666-4666-8666-666666666666",
      "actorName": "Alex Morgan",
      "actorEmail": "alex@example.test",
      "actorKind": "session",
      "credentialId": null,
      "action": "draft.created",
      "resourceType": "draft",
      "resourceId": "33333333-3333-4333-8333-333333333333",
      "details": {
        "version": 1
      },
      "requestId": "example-request",
      "createdAt": "2027-01-18T09:30:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 20
}
```

## Related reference

[HTTP operation](https://www.posted.cc/api-reference/get_api_audit_logs.md) · [Connect an MCP client](https://www.posted.cc/mcp-connections.md) · [Request conventions](https://www.posted.cc/api-reference/overview.md)


## Related topics

- [List audit logs](https://www.posted.cc/api-reference/get_api_audit_logs.md)
- [List audit actors](https://www.posted.cc/api-reference/get_api_audit_logs_actors.md)
- [Workspaces](https://www.posted.cc/workspaces.md)
- [Docker Compose](https://www.posted.cc/installation/docker-compose.md)
- [Troubleshooting](https://www.posted.cc/troubleshooting.md)


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