v1

latestOpenAPI 3.1.02026-07-24239123562.1 KB

Logs

Query System Logs

This endpoint retrieves System Logs for user activity in the Data Lake. You can query logs based on various parameters to track user actions or file operations and changes.

get/v1/datalake/queryActivityLog

Query parameters

queryIdstring

Query ID to retrieve more logs

maxinteger

Maximum number of logs to return

nextstring

Next page token

takeinteger

Number of logs to take

skipinteger

Number of logs to skip

actorstring

Filter by actor name (case-insensitive partial match)

targetTypestring

Filter by target type (exact match)

targetNamestring

Filter by target name (case-insensitive partial match)

actionstring

Filter by single action type

actionsstring

Filter by multiple action types (comma-separated)

fromstring date-time

Filter logs after this timestamp (ISO format)

tostring date-time

Filter logs before this timestamp (ISO format)

idsstring[]

Filter by array of IDs

idstring

Filter by target ID (case-insensitive partial match)

changeReasonstring

Filter by change reason (case-insensitive partial match)

targetIdsstring

Filter by multiple target IDs (comma-separated)

formatstring

Format of the response (use "csv" to download a CSV file)

sortDirectionstring

Order of sorting by timestamp ("asc" for ASC, DESC by default)

Headers

ts-auth-tokenstring required

JWT Token

x-org-slugstring required

Your organization slug

Response

Successfully retrieved activity logs

queryIdstring

hasMoreboolean

Example response

{
  "queryId": "c61f201d-e55d-44f0-b196-b0728cf354fb",
  "logs": [
    {
      "id": "1044121d-bf56-4cdd-93d3-4b71b83e0062",
      "type": "user.logout.v1",
      "category": "event",
      "created_at": "2025-01-29T15:25:21.571Z",
      "tenant_id": "64682d30-7d38-6866-10b7-b0fe58fb4073",
      "org_slug": "cell-culture-app-test",
      "actor": {
        "id": "59eb8bd4-8b10-43b3-ac57-fe3ab86c05fd",
        "type": "user",
        "name": "Administrator Administrator",
        "email": "admin@tetrascience.com"
      },
      "action": "logout",
      "target": {
        "id": "59eb8bd4-8b10-43b3-ac57-fe3ab86c05fd",
        "type": "user",
        "name": "Administrator Administrator11"
      },
      "source": {
        "id": "tdp",
        "type": "platform",
        "tracking": {
          "ipaddress": "11.1.11.111",
          "useragent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36",
          "token": "xxxxxx"
        }
      },
      "tags": {},
      "before": {},
      "after": {}
    }
  ],
  "hasMore": true
}