Activity logs

This API is not available for self-service at the moment, and you will need to contact us if you are interested in using it.

List activity logs

This endpoint allows to list activity logs on a particular project and environment.

Records are returned sorted by createdAt date, in descending order (from most recent to least recent).

Pagination can be achieved by filtering on createdAt date.

get
Authorizations
Path parameters
environmentNamestring · min: 1Required

The case sensitive environment name

projectNamestring · min: 1Required

The case sensitive project name

Query parameters
limitinteger · min: 1 · max: 100Optional

This specifies a limit on the number of objects to return, ranging between 1 and 100. Limit is set to 10 by default

Default: 10
userEmailstring · emailOptional

The user email

userIdinteger · min: 1Optional

The user id

teamNamestring · min: 1Optional

The team name

collectionNamestring · min: 1Optional

The collection name (same as in the schema).

recordIdstring · min: 1Optional

The record id

actionstring · enumOptional

The action performed

Possible values:
typestring · enumOptional

The type of the activity log

Possible values:
createdAt.eqstring · date-timeOptional

Value to filter by

createdAt.ltstring · date-timeOptional

Maximum value to filter by (exclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

createdAt.ltestring · date-timeOptional

Minimum value to filter by (inclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

createdAt.gtstring · date-timeOptional

Minimum value to filter by (exclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

createdAt.gtestring · date-timeOptional

Maximum value to filter by (inclusive). This filter supports date-time values in ISO 8601 format (YYYY-MM-DDTHH:MM), e.g., 2024-06-04T09:21:26.159Z.

Responses
200
List of activity logs
application/json
get
GET /v1/project/{projectName}/environment/{environmentName}/activity-logs HTTP/1.1
Host: public-api.forestadmin.com
Authorization: Bearer JWT
Accept: */*
{
  "hasMore": false,
  "parameters": {
    "projectName": "Forest",
    "environmentName": "Production",
    "limit": 10
  },
  "data": [
    {
      "object": "activityLog",
      "id": "rbCb98wCZ1y-_zv4wrXz",
      "type": "write",
      "action": "update",
      "label": "updated",
      "recordIds": [
        "42"
      ],
      "createdAt": "2024-03-14T15:09:26.535Z",
      "user": {
        "object": "user",
        "id": 1,
        "username": "alice",
        "email": "[email protected]"
      },
      "environment": {
        "object": "environment",
        "name": "Production"
      },
      "collection": {
        "object": "collection",
        "name": "subscriptions"
      },
      "team": {
        "object": "team",
        "name": "Sales"
      }
    },
    {
      "object": "activityLog",
      "id": "fHCb9IXCZ1y_Pzv4wrXz",
      "type": "write",
      "action": "startProcessingInboxTask",
      "label": "assigned to",
      "recordIds": [
        "4242"
      ],
      "createdAt": "2024-03-14T15:09:26.535Z",
      "user": {
        "object": "user",
        "id": 2,
        "username": "bob",
        "email": "[email protected]"
      },
      "environment": {
        "object": "environment",
        "name": "Production"
      },
      "collection": {
        "object": "collection",
        "name": "subscriptions"
      },
      "team": {
        "object": "team",
        "name": "Operations"
      },
      "inbox": {
        "object": "inbox",
        "name": "Ids check"
      }
    },
    {
      "object": "activityLog",
      "id": "vEgu7pYBRgCf1BhhPe83",
      "type": "write",
      "action": "completeWorkflow",
      "label": "completed the workflow \"KYC Process\"",
      "recordIds": [
        "74"
      ],
      "createdAt": "2025-05-20T14:52:09.909Z",
      "user": {
        "object": "user",
        "id": 2,
        "username": "bob",
        "email": "[email protected]"
      },
      "environment": {
        "object": "environment",
        "name": "Production"
      },
      "collection": {
        "object": "collection",
        "name": "subscriptions"
      },
      "team": {
        "object": "team",
        "name": "Operations"
      },
      "workflow": {
        "object": "workflow",
        "name": "KYC Process",
        "runId": "26",
        "stepName": "Migrate user for next step"
      }
    }
  ]
}

Last updated