Get activity logs for envelopes and team

You can list team activity logs (e.g. API key created, member joined) and envelope activity logs (e.g. envelope created, document signed) with the same endpoint. Use it for audit trails or syncing activity to your system.

Permissions

Your team API key must have the right permission for the category you request:

Category	Required permission
`team`	Read Team
`envelope`	Read Envelope

When creating or editing the key in Subnoto (Settings → API keys), enable the matching permission. A key with only Read Team can list team logs; it cannot list envelope logs.

Request

Endpoint: POST /public/logs/list

Body:

category: "team" or "envelope" (required)
For envelope: optional workspaceUuid, envelopeUuid
Optional: eventTypes, page, limit, sortBy, sortOrder

Example (team logs, first page):

{
  "category": "team",
  "page": 1,
  "limit": 50
}

Example (envelope logs for one envelope):

{
  "category": "envelope",
  "envelopeUuid": "your-envelope-uuid",
  "page": 1,
  "limit": 50
}

Response: { "logs": [ ... ], "totalCount": number }. Each log has category, eventType, eventData, timestamp, author, and for envelope logs envelopeUuid and workspaceUuid.

Event types

Pass eventTypes in the request body to filter by one or more events. Use only events for the category you request (envelope events with category: "envelope", team events with category: "team").

Envelope events

Event type	Description
`ENVELOPE_CREATED`	Envelope was created
`ENVELOPE_SENT`	Envelope was sent to recipients
`DOCUMENT_SIGNED`	A document was signed
`ENVELOPE_COMPLETED`	Envelope was completed
`ENVELOPE_OPENED`	Envelope was opened
`ENVELOPE_DECLINED`	Envelope was declined
`ENVELOPE_CANCELED`	Envelope was canceled
`RECIPIENT_VERIFIED`	Recipient was verified

Team events

Event type	Description
`TEAM_CREATED`	Team was created
`TEAM_CONFIG_UPDATED`	Team configuration changed
`MEMBER_INVITED`	Member was invited
`INVITE_REVOKED`	Invite was revoked
`MEMBER_JOINED`	Member joined the team
`MEMBER_REMOVED`	Member was removed
`MEMBER_ROLE_UPDATED`	Member role was updated
`API_KEY_CREATED`	API key was created
`API_KEY_UPDATED`	API key was updated
`API_KEY_INVALIDATED`	API key was invalidated
`WEBHOOK_CREATED`	Webhook was created
`WEBHOOK_UPDATED`	Webhook was updated
`WEBHOOK_DELETED`	Webhook was deleted
`SSO_CONFIG_CREATED`	SSO config was created
`SSO_CONFIG_UPDATED`	SSO config was updated
`SSO_CONFIG_DELETED`	SSO config was deleted

For the full request and response schema, see the Public API OpenAPI spec.

Example (curl)

curl -X POST https://enclave.subnoto.com/public/logs/list \
  -H "Authorization: Bearer YOUR_ACCESS_KEY:YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"team","page":1,"limit":50}'

If you use the Encryption Proxy, replace the host with your proxy URL and use the same path and body.