# Activity Logs

## get_activity_logs

`TOOL get_activity_logs`

Get list of activity logs for the authenticated user's organization

Authentication: no security requirement declared for this operation.

Parameters:

- `page` (argument, integer, optional) - Page number for pagination
  Type: integer
  
  Page number for pagination
  
  default: 1
  
  minimum: 1
  
  maximum: 9007199254740991

- `limit` (argument, integer, optional) - Number of items per page
  Type: integer
  
  Number of items per page
  
  default: 10
  
  minimum: 1
  
  maximum: 100

- `relations` (argument, array, optional)
  Type: array
  
  Items:
    Type: string
    
    enum: ["createdBy","employee"]

- `entity` (argument, string, optional) - Filter by entity type
  Type: string
  
  Filter by entity type
  
  enum: ["USER","EMPLOYEE","TASK","PROJECT","GOAL","INVOICE","EXPENSE","DEAL","CANDIDATE"]

- `entityId` (argument, string, uuid, optional) - Filter by entity ID
  Type: string, uuid
  
  Filter by entity ID
  
  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)$"

- `action` (argument, string, optional) - Filter by action type
  Type: string
  
  Filter by action type
  
  enum: ["CREATED","UPDATED","DELETED","VIEWED","ASSIGNED","COMPLETED","APPROVED","REJECTED"]

- `actorType` (argument, string, optional) - Filter by actor type (System, User or Agent)
  Type: string
  
  Filter by actor type (System, User or Agent)
  
  enum: ["System","User","Agent"]

- `createdByUserId` (argument, string, uuid, optional) - Filter by user who performed the action
  Type: string, uuid
  
  Filter by user who performed the action
  
  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)$"

- `employeeId` (argument, string, uuid, optional) - Filter by employee context
  Type: string, uuid
  
  Filter by employee context
  
  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)$"

- `startDate` (argument, string, date-time, optional) - Filter logs from this date (ISO format)
  Type: string, date-time
  
  Filter logs from this date (ISO format)
  
  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|([+-](https://sourcey-gauzy.pages.dev/mcp/activity-logs/index.md?:[01]\d|2[0-3]):[0-5]\\d)))$"

- `endDate` (argument, string, date-time, optional) - Filter logs until this date (ISO format)
  Type: string, date-time
  
  Filter logs until this date (ISO format)
  
  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|([+-](https://sourcey-gauzy.pages.dev/mcp/activity-logs/index.md?:[01]\d|2[0-3]):[0-5]\\d)))$"

- `sortBy` (argument, string, optional) - Sort logs by field
  Type: string
  
  Sort logs by field
  
  default: "createdAt"
  
  enum: ["createdAt","updatedAt","entity","action"]

- `sortOrder` (argument, string, optional) - Sort order
  Type: string
  
  Sort order
  
  default: "DESC"
  
  enum: ["ASC","DESC"]

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_activity_logs",
    "arguments": {
        "page": 1,
        "limit": 10,
        "relations": [
          "createdBy"
        ],
        "entity": "USER",
        "entityId": "550e8400-e29b-41d4-a716-446655440000",
        "action": "CREATED",
        "actorType": "System",
        "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "startDate": "2024-01-15T09:30:00Z",
        "endDate": "2024-01-15T09:30:00Z",
        "sortBy": "createdAt",
        "sortOrder": "DESC"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_activity_logs",
  "arguments": {
    "page": 1,
    "limit": 10,
    "relations": [
      "createdBy"
    ],
    "entity": "USER",
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "action": "CREATED",
    "actorType": "System",
    "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "startDate": "2024-01-15T09:30:00Z",
    "endDate": "2024-01-15T09:30:00Z",
    "sortBy": "createdAt",
    "sortOrder": "DESC"
  }
});
```

### Python

```python
result = await session.call_tool("get_activity_logs", arguments={
  "page": 1,
  "limit": 10,
  "relations": [
    "createdBy"
  ],
  "entity": "USER",
  "entityId": "550e8400-e29b-41d4-a716-446655440000",
  "action": "CREATED",
  "actorType": "System",
  "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "startDate": "2024-01-15T09:30:00Z",
  "endDate": "2024-01-15T09:30:00Z",
  "sortBy": "createdAt",
  "sortOrder": "DESC"
})
```


## get_activity_log_count

`TOOL get_activity_log_count`

Get activity log count in the authenticated user's organization

Authentication: no security requirement declared for this operation.

Parameters:

- `entity` (argument, string, optional) - Filter by entity type
  Type: string
  
  Filter by entity type
  
  enum: ["USER","EMPLOYEE","TASK","PROJECT","GOAL","INVOICE","EXPENSE","DEAL","CANDIDATE"]

- `entityId` (argument, string, uuid, optional) - Filter by entity ID
  Type: string, uuid
  
  Filter by entity ID
  
  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)$"

- `action` (argument, string, optional) - Filter by action type
  Type: string
  
  Filter by action type
  
  enum: ["CREATED","UPDATED","DELETED","VIEWED","ASSIGNED","COMPLETED","APPROVED","REJECTED"]

- `actorType` (argument, string, optional) - Filter by actor type (System, User or Agent)
  Type: string
  
  Filter by actor type (System, User or Agent)
  
  enum: ["System","User","Agent"]

- `createdByUserId` (argument, string, uuid, optional) - Filter by user who performed the action
  Type: string, uuid
  
  Filter by user who performed the action
  
  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)$"

- `employeeId` (argument, string, uuid, optional) - Filter by employee context
  Type: string, uuid
  
  Filter by employee context
  
  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)$"

- `startDate` (argument, string, optional) - Filter logs from this date (ISO format)
  Type: string
  
  Filter logs from this date (ISO format)

- `endDate` (argument, string, optional) - Filter logs until this date (ISO format)
  Type: string
  
  Filter logs until this date (ISO format)

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_activity_log_count",
    "arguments": {
        "entity": "USER",
        "entityId": "550e8400-e29b-41d4-a716-446655440000",
        "action": "CREATED",
        "actorType": "System",
        "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "startDate": "string",
        "endDate": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_activity_log_count",
  "arguments": {
    "entity": "USER",
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "action": "CREATED",
    "actorType": "System",
    "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "startDate": "string",
    "endDate": "string"
  }
});
```

### Python

```python
result = await session.call_tool("get_activity_log_count", arguments={
  "entity": "USER",
  "entityId": "550e8400-e29b-41d4-a716-446655440000",
  "action": "CREATED",
  "actorType": "System",
  "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "startDate": "string",
  "endDate": "string"
})
```


## get_activity_log

`TOOL get_activity_log`

Get a specific activity log by ID

Authentication: no security requirement declared for this operation.

Parameters:

- `id` (argument, string, uuid, required) - The activity log ID
  Type: string, uuid
  
  The activity log ID
  
  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)$"

- `relations` (argument, array, optional) - Relations to include (e.g., ["createdBy", "employee"])
  Type: array
  
  Relations to include (e.g., ["createdBy", "employee"])
  
  Items:
    Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_activity_log",
    "arguments": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "relations": [
          "string"
        ]
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_activity_log",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "relations": [
      "string"
    ]
  }
});
```

### Python

```python
result = await session.call_tool("get_activity_log", arguments={
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "relations": [
    "string"
  ]
})
```


## create_activity_log

`TOOL create_activity_log`

Create a new activity log entry in the authenticated user's organization

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `log_data` (required)
  Type: object
  
  The data for creating the activity log
  
  - `entity` (required)
    Type: string
    
    enum: ["USER","EMPLOYEE","TASK","PROJECT","GOAL","INVOICE","EXPENSE","DEAL","CANDIDATE"]
  
  - `entityId` (required)
    Type: string, 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)$"
  
  - `action` (required)
    Type: string
    
    enum: ["CREATED","UPDATED","DELETED","VIEWED","ASSIGNED","COMPLETED","APPROVED","REJECTED"]
  
  - `data` (optional)
    Type: object
    
    Additional properties: 
      Type: unknown
  
  - `previousValues` (optional)
    Type: object
    
    Additional properties: 
      Type: unknown
  
  - `updatedFields` (optional)
    Type: array
    
    Items:
      Type: string
  
  - `actorType` (optional)
    Type: string
    
    enum: ["System","User","Agent"]
  
  - `createdByUserId` (optional)
    Type: string, 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)$"
  
  - `employeeId` (optional)
    Type: string, 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)$"
  
  - `employee` (optional)
    Type: object
    
    Additional properties: 
      Type: unknown

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_activity_log",
    "arguments": {
        "log_data": {
          "entity": "USER",
          "entityId": "550e8400-e29b-41d4-a716-446655440000",
          "action": "CREATED",
          "data": {},
          "previousValues": {},
          "updatedFields": [
            "string"
          ],
          "actorType": "System",
          "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
          "employeeId": "550e8400-e29b-41d4-a716-446655440000",
          "employee": {}
        }
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "create_activity_log",
  "arguments": {
    "log_data": {
      "entity": "USER",
      "entityId": "550e8400-e29b-41d4-a716-446655440000",
      "action": "CREATED",
      "data": {},
      "previousValues": {},
      "updatedFields": [
        "string"
      ],
      "actorType": "System",
      "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
      "employeeId": "550e8400-e29b-41d4-a716-446655440000",
      "employee": {}
    }
  }
});
```

### Python

```python
result = await session.call_tool("create_activity_log", arguments={
  "log_data": {
    "entity": "USER",
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "action": "CREATED",
    "data": {},
    "previousValues": {},
    "updatedFields": [
      "string"
    ],
    "actorType": "System",
    "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "employee": {}
  }
})
```


## get_activity_logs_by_entity

`TOOL get_activity_logs_by_entity`

Get activity logs for a specific entity

Authentication: no security requirement declared for this operation.

Parameters:

- `entity` (argument, string, required) - The entity type
  Type: string
  
  The entity type
  
  enum: ["USER","EMPLOYEE","TASK","PROJECT","GOAL","INVOICE","EXPENSE","DEAL","CANDIDATE"]

- `entityId` (argument, string, uuid, required) - The entity ID
  Type: string, uuid
  
  The entity ID
  
  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)$"

- `page` (argument, number, optional) - Page number for pagination
  Type: number
  
  Page number for pagination
  
  default: 1

- `limit` (argument, number, optional) - Number of items per page
  Type: number
  
  Number of items per page
  
  default: 10

- `relations` (argument, array, optional)
  Type: array
  
  Items:
    Type: string
    
    enum: ["createdBy","employee"]

- `action` (argument, string, optional) - Filter by action type
  Type: string
  
  Filter by action type
  
  enum: ["CREATED","UPDATED","DELETED","VIEWED","ASSIGNED","COMPLETED","APPROVED","REJECTED"]

- `actorType` (argument, string, optional) - Filter by actor type (System, User or Agent)
  Type: string
  
  Filter by actor type (System, User or Agent)
  
  enum: ["System","User","Agent"]

- `createdByUserId` (argument, string, uuid, optional) - Filter by user who performed the action
  Type: string, uuid
  
  Filter by user who performed the action
  
  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)$"

- `employeeId` (argument, string, uuid, optional) - Filter by employee context
  Type: string, uuid
  
  Filter by employee context
  
  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)$"

- `startDate` (argument, string, optional) - Filter logs from this date (ISO format)
  Type: string
  
  Filter logs from this date (ISO format)

- `endDate` (argument, string, optional) - Filter logs until this date (ISO format)
  Type: string
  
  Filter logs until this date (ISO format)

- `sortBy` (argument, string, optional) - Sort logs by field
  Type: string
  
  Sort logs by field
  
  default: "createdAt"
  
  enum: ["createdAt","updatedAt","entity","action"]

- `sortOrder` (argument, string, optional) - Sort order
  Type: string
  
  Sort order
  
  default: "DESC"
  
  enum: ["ASC","DESC"]

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_activity_logs_by_entity",
    "arguments": {
        "entity": "USER",
        "entityId": "550e8400-e29b-41d4-a716-446655440000",
        "page": 1,
        "limit": 10,
        "relations": [
          "createdBy"
        ],
        "action": "CREATED",
        "actorType": "System",
        "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "startDate": "string",
        "endDate": "string",
        "sortBy": "createdAt",
        "sortOrder": "DESC"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_activity_logs_by_entity",
  "arguments": {
    "entity": "USER",
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "page": 1,
    "limit": 10,
    "relations": [
      "createdBy"
    ],
    "action": "CREATED",
    "actorType": "System",
    "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "startDate": "string",
    "endDate": "string",
    "sortBy": "createdAt",
    "sortOrder": "DESC"
  }
});
```

### Python

```python
result = await session.call_tool("get_activity_logs_by_entity", arguments={
  "entity": "USER",
  "entityId": "550e8400-e29b-41d4-a716-446655440000",
  "page": 1,
  "limit": 10,
  "relations": [
    "createdBy"
  ],
  "action": "CREATED",
  "actorType": "System",
  "createdByUserId": "550e8400-e29b-41d4-a716-446655440000",
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "startDate": "string",
  "endDate": "string",
  "sortBy": "createdAt",
  "sortOrder": "DESC"
})
```


## get_activity_logs_by_user

`TOOL get_activity_logs_by_user`

Get activity logs created by a specific user

Authentication: no security requirement declared for this operation.

Parameters:

- `userId` (argument, string, uuid, required) - The user ID
  Type: string, uuid
  
  The user ID
  
  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)$"

- `page` (argument, number, optional) - Page number for pagination
  Type: number
  
  Page number for pagination
  
  default: 1

- `limit` (argument, number, optional) - Number of items per page
  Type: number
  
  Number of items per page
  
  default: 10

- `entity` (argument, string, optional) - Filter by entity type
  Type: string
  
  Filter by entity type
  
  enum: ["USER","EMPLOYEE","TASK","PROJECT","GOAL","INVOICE","EXPENSE","DEAL","CANDIDATE"]

- `action` (argument, string, optional) - Filter by action type
  Type: string
  
  Filter by action type
  
  enum: ["CREATED","UPDATED","DELETED","VIEWED","ASSIGNED","COMPLETED","APPROVED","REJECTED"]

- `startDate` (argument, string, optional) - Filter logs from this date (ISO format)
  Type: string
  
  Filter logs from this date (ISO format)

- `endDate` (argument, string, optional) - Filter logs until this date (ISO format)
  Type: string
  
  Filter logs until this date (ISO format)

- `relations` (argument, array, optional) - Relations to include
  Type: array
  
  Relations to include
  
  Items:
    Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_activity_logs_by_user",
    "arguments": {
        "userId": "550e8400-e29b-41d4-a716-446655440000",
        "page": 1,
        "limit": 10,
        "entity": "USER",
        "action": "CREATED",
        "startDate": "string",
        "endDate": "string",
        "relations": [
          "string"
        ]
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_activity_logs_by_user",
  "arguments": {
    "userId": "550e8400-e29b-41d4-a716-446655440000",
    "page": 1,
    "limit": 10,
    "entity": "USER",
    "action": "CREATED",
    "startDate": "string",
    "endDate": "string",
    "relations": [
      "string"
    ]
  }
});
```

### Python

```python
result = await session.call_tool("get_activity_logs_by_user", arguments={
  "userId": "550e8400-e29b-41d4-a716-446655440000",
  "page": 1,
  "limit": 10,
  "entity": "USER",
  "action": "CREATED",
  "startDate": "string",
  "endDate": "string",
  "relations": [
    "string"
  ]
})
```


## get_my_activity_logs

`TOOL get_my_activity_logs`

Get activity logs created by the current authenticated user

Authentication: no security requirement declared for this operation.

Parameters:

- `page` (argument, number, optional) - Page number for pagination
  Type: number
  
  Page number for pagination
  
  default: 1

- `limit` (argument, number, optional) - Number of items per page
  Type: number
  
  Number of items per page
  
  default: 10

- `entity` (argument, string, optional) - Filter by entity type
  Type: string
  
  Filter by entity type
  
  enum: ["USER","EMPLOYEE","TASK","PROJECT","GOAL","INVOICE","EXPENSE","DEAL","CANDIDATE"]

- `action` (argument, string, optional) - Filter by action type
  Type: string
  
  Filter by action type
  
  enum: ["CREATED","UPDATED","DELETED","VIEWED","ASSIGNED","COMPLETED","APPROVED","REJECTED"]

- `startDate` (argument, string, optional) - Filter logs from this date (ISO format)
  Type: string
  
  Filter logs from this date (ISO format)

- `endDate` (argument, string, optional) - Filter logs until this date (ISO format)
  Type: string
  
  Filter logs until this date (ISO format)

- `relations` (argument, array, optional) - Relations to include
  Type: array
  
  Relations to include
  
  Items:
    Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_my_activity_logs",
    "arguments": {
        "page": 1,
        "limit": 10,
        "entity": "USER",
        "action": "CREATED",
        "startDate": "string",
        "endDate": "string",
        "relations": [
          "string"
        ]
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_my_activity_logs",
  "arguments": {
    "page": 1,
    "limit": 10,
    "entity": "USER",
    "action": "CREATED",
    "startDate": "string",
    "endDate": "string",
    "relations": [
      "string"
    ]
  }
});
```

### Python

```python
result = await session.call_tool("get_my_activity_logs", arguments={
  "page": 1,
  "limit": 10,
  "entity": "USER",
  "action": "CREATED",
  "startDate": "string",
  "endDate": "string",
  "relations": [
    "string"
  ]
})
```


## get_recent_activity_logs

`TOOL get_recent_activity_logs`

Get recent activity logs for the authenticated user's organization

Authentication: no security requirement declared for this operation.

Parameters:

- `limit` (argument, number, optional) - Maximum number of recent logs
  Type: number
  
  Maximum number of recent logs
  
  default: 20

- `entity` (argument, string, optional) - Filter by entity type
  Type: string
  
  Filter by entity type
  
  enum: ["USER","EMPLOYEE","TASK","PROJECT","GOAL","INVOICE","EXPENSE","DEAL","CANDIDATE"]

- `action` (argument, string, optional) - Filter by action type
  Type: string
  
  Filter by action type
  
  enum: ["CREATED","UPDATED","DELETED","VIEWED","ASSIGNED","COMPLETED","APPROVED","REJECTED"]

- `hours` (argument, number, optional) - Get logs from the last N hours
  Type: number
  
  Get logs from the last N hours
  
  default: 24

- `relations` (argument, array, optional) - Relations to include
  Type: array
  
  Relations to include
  
  Items:
    Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_recent_activity_logs",
    "arguments": {
        "limit": 20,
        "entity": "USER",
        "action": "CREATED",
        "hours": 24,
        "relations": [
          "string"
        ]
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_recent_activity_logs",
  "arguments": {
    "limit": 20,
    "entity": "USER",
    "action": "CREATED",
    "hours": 24,
    "relations": [
      "string"
    ]
  }
});
```

### Python

```python
result = await session.call_tool("get_recent_activity_logs", arguments={
  "limit": 20,
  "entity": "USER",
  "action": "CREATED",
  "hours": 24,
  "relations": [
    "string"
  ]
})
```


## get_activity_log_statistics

`TOOL get_activity_log_statistics`

Get activity log statistics for the authenticated user's organization

Authentication: no security requirement declared for this operation.

Parameters:

- `startDate` (argument, string, optional) - Start date for statistics (ISO format)
  Type: string
  
  Start date for statistics (ISO format)

- `endDate` (argument, string, optional) - End date for statistics (ISO format)
  Type: string
  
  End date for statistics (ISO format)

- `entity` (argument, string, optional) - Filter by entity type
  Type: string
  
  Filter by entity type
  
  enum: ["USER","EMPLOYEE","TASK","PROJECT","GOAL","INVOICE","EXPENSE","DEAL","CANDIDATE"]

- `action` (argument, string, optional) - Filter by action type
  Type: string
  
  Filter by action type
  
  enum: ["CREATED","UPDATED","DELETED","VIEWED","ASSIGNED","COMPLETED","APPROVED","REJECTED"]

- `groupBy` (argument, string, optional) - Group statistics by
  Type: string
  
  Group statistics by
  
  default: "entity"
  
  enum: ["entity","action","user","date","hour"]

- `userId` (argument, string, uuid, optional) - Filter by specific user ID
  Type: string, uuid
  
  Filter by specific user ID
  
  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)$"

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_activity_log_statistics",
    "arguments": {
        "startDate": "string",
        "endDate": "string",
        "entity": "USER",
        "action": "CREATED",
        "groupBy": "entity",
        "userId": "550e8400-e29b-41d4-a716-446655440000"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_activity_log_statistics",
  "arguments": {
    "startDate": "string",
    "endDate": "string",
    "entity": "USER",
    "action": "CREATED",
    "groupBy": "entity",
    "userId": "550e8400-e29b-41d4-a716-446655440000"
  }
});
```

### Python

```python
result = await session.call_tool("get_activity_log_statistics", arguments={
  "startDate": "string",
  "endDate": "string",
  "entity": "USER",
  "action": "CREATED",
  "groupBy": "entity",
  "userId": "550e8400-e29b-41d4-a716-446655440000"
})
```


## delete_activity_logs

`TOOL delete_activity_logs`

Delete activity logs based on criteria (for cleanup purposes)

Authentication: no security requirement declared for this operation.

Parameters:

- `olderThanDays` (argument, number, optional) - Delete logs older than N days
  Type: number
  
  Delete logs older than N days

- `entity` (argument, string, optional) - Delete logs for specific entity type
  Type: string
  
  Delete logs for specific entity type
  
  enum: ["USER","EMPLOYEE","TASK","PROJECT","GOAL","INVOICE","EXPENSE","DEAL","CANDIDATE"]

- `entityId` (argument, string, uuid, optional) - Delete logs for specific entity ID
  Type: string, uuid
  
  Delete logs for specific entity ID
  
  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)$"

- `action` (argument, string, optional) - Delete logs for specific action type
  Type: string
  
  Delete logs for specific action type
  
  enum: ["CREATED","UPDATED","DELETED","VIEWED","ASSIGNED","COMPLETED","APPROVED","REJECTED"]

- `confirm` (argument, boolean, required) - Confirmation flag - must be true to proceed with deletion
  Type: boolean
  
  Confirmation flag - must be true to proceed with deletion

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_activity_logs",
    "arguments": {
        "olderThanDays": 0,
        "entity": "USER",
        "entityId": "550e8400-e29b-41d4-a716-446655440000",
        "action": "CREATED",
        "confirm": true
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "delete_activity_logs",
  "arguments": {
    "olderThanDays": 0,
    "entity": "USER",
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "action": "CREATED",
    "confirm": true
  }
});
```

### Python

```python
result = await session.call_tool("delete_activity_logs", arguments={
  "olderThanDays": 0,
  "entity": "USER",
  "entityId": "550e8400-e29b-41d4-a716-446655440000",
  "action": "CREATED",
  "confirm": true
})
```


## search_activity_logs

`TOOL search_activity_logs`

Search activity logs by metadata or data content

Authentication: no security requirement declared for this operation.

Parameters:

- `query` (argument, string, required) - Search query for data content
  Type: string
  
  Search query for data content

- `limit` (argument, number, optional) - Maximum number of results
  Type: number
  
  Maximum number of results
  
  default: 20

- `entity` (argument, string, optional) - Filter by entity type
  Type: string
  
  Filter by entity type
  
  enum: ["USER","EMPLOYEE","TASK","PROJECT","GOAL","INVOICE","EXPENSE","DEAL","CANDIDATE"]

- `action` (argument, string, optional) - Filter by action type
  Type: string
  
  Filter by action type
  
  enum: ["CREATED","UPDATED","DELETED","VIEWED","ASSIGNED","COMPLETED","APPROVED","REJECTED"]

- `startDate` (argument, string, optional) - Filter logs from this date (ISO format)
  Type: string
  
  Filter logs from this date (ISO format)

- `endDate` (argument, string, optional) - Filter logs until this date (ISO format)
  Type: string
  
  Filter logs until this date (ISO format)

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_activity_logs",
    "arguments": {
        "query": "string",
        "limit": 20,
        "entity": "USER",
        "action": "CREATED",
        "startDate": "string",
        "endDate": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "search_activity_logs",
  "arguments": {
    "query": "string",
    "limit": 20,
    "entity": "USER",
    "action": "CREATED",
    "startDate": "string",
    "endDate": "string"
  }
});
```

### Python

```python
result = await session.call_tool("search_activity_logs", arguments={
  "query": "string",
  "limit": 20,
  "entity": "USER",
  "action": "CREATED",
  "startDate": "string",
  "endDate": "string"
})
```


## get_activity_timeline

`TOOL get_activity_timeline`

Get activity timeline for a specific entity

Authentication: no security requirement declared for this operation.

Parameters:

- `entity` (argument, string, required) - The entity type
  Type: string
  
  The entity type
  
  enum: ["USER","EMPLOYEE","TASK","PROJECT","GOAL","INVOICE","EXPENSE","DEAL","CANDIDATE"]

- `entityId` (argument, string, uuid, required) - The entity ID
  Type: string, uuid
  
  The entity ID
  
  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)$"

- `limit` (argument, number, optional) - Maximum number of timeline entries
  Type: number
  
  Maximum number of timeline entries
  
  default: 50

- `startDate` (argument, string, optional) - Timeline start date (ISO format)
  Type: string
  
  Timeline start date (ISO format)

- `endDate` (argument, string, optional) - Timeline end date (ISO format)
  Type: string
  
  Timeline end date (ISO format)

- `includeRelated` (argument, boolean, optional) - Include related entity activities
  Type: boolean
  
  Include related entity activities
  
  default: false

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_activity_timeline",
    "arguments": {
        "entity": "USER",
        "entityId": "550e8400-e29b-41d4-a716-446655440000",
        "limit": 50,
        "startDate": "string",
        "endDate": "string",
        "includeRelated": false
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_activity_timeline",
  "arguments": {
    "entity": "USER",
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "limit": 50,
    "startDate": "string",
    "endDate": "string",
    "includeRelated": false
  }
});
```

### Python

```python
result = await session.call_tool("get_activity_timeline", arguments={
  "entity": "USER",
  "entityId": "550e8400-e29b-41d4-a716-446655440000",
  "limit": 50,
  "startDate": "string",
  "endDate": "string",
  "includeRelated": false
})
```