list_audit_logs

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

Workflow

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

{
  "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.

{
  "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.

{
  "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
}

HTTP operation · Connect an MCP client · Request conventions

Connect a client

MCP reference

API Reference

list_audit_logs

Workflow

Access and behavior

Arguments

Example call

Example result

​Workflow

​Access and behavior

​Arguments

​Example call

​Example result

​Related reference

Workflow

Access and behavior

Arguments

Example call

Example result

Related reference