Audit Logs

Audit logs provide a record of all actions taken in the workspace, including who performed the action, when it was done, and what was changed. Learn more about audit logs here.

List Workspace Audit Logs

get

This endpoint retrieves a list of all activity logs for the workspace, providing a record of actions taken by users. These logs include information about who performed the action, when it was done, and what was changed.

You can filter the logs by user or resource to get more specific audit information:

• To get user-specific audit logs, use the sender_id filter parameter

• To get resource-specific audit logs, use the resource_id filter parameter

Authorizations

Query parameters

daysintegerOptional

Number of days to look back for activity logs (default is 90 days)

Default: 90

sender_idstring · uuidOptional

Filter logs by the ID of the user who performed the actions

Example: 550e8400-e29b-41d4-a716-446655440000

resource_idstringOptional

Filter logs by the ID of the resource that was affected

Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7

pageintegerOptional

Page number for paginated results

Default: 1

page_sizeintegerOptional

Number of results per page (default is 20)

Default: 20

Responses

200

Successfully retrieved workspace activity logs

application/json

401

Unauthorized - Authentication credentials were not provided or are invalid

403

Forbidden - User does not have permission to access workspace activity logs

500

Internal server error

get

HTTPcURLJavaScriptPython

GET /notification/workspace/ HTTP/1.1
Host: api.secoda.co
Authorization: Bearer string
Accept: */*

{
  "count": 1,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-05-17T08:26:25.083Z",
      "resource_id": "text",
      "resource_title": "text",
      "resource_type": "text",
      "event": "text",
      "content": "text",
      "sender": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "email": "[e-mail]",
        "first_name": "text",
        "last_name": "text"
      },
      "metadata": {},
      "short_summary": "text",
      "short_summary_markdown": "text",
      "subject": "text",
      "entity_type": "text",
      "entity_id": "text",
      "entity_snapshot_key": "text"
    }
  ]
}