# Comments

## get_comments

`TOOL get_comments`

Get list of comments for the authenticated user's organization

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

- `search` (argument, string, optional) - Search term for comment content
  Type: string
  
  Search term for comment content

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

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

- `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)$"

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

- `parentId` (argument, string, uuid, optional) - Filter by parent comment ID (for replies)
  Type: string, uuid
  
  Filter by parent comment ID (for replies)
  
  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_comments",
    "arguments": {
        "page": 1,
        "limit": 10,
        "search": "string",
        "relations": [
          "string"
        ],
        "entity": "TASK",
        "entityId": "550e8400-e29b-41d4-a716-446655440000",
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "parentId": "550e8400-e29b-41d4-a716-446655440000"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_comments",
  "arguments": {
    "page": 1,
    "limit": 10,
    "search": "string",
    "relations": [
      "string"
    ],
    "entity": "TASK",
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "parentId": "550e8400-e29b-41d4-a716-446655440000"
  }
});
```

### Python

```python
result = await session.call_tool("get_comments", arguments={
  "page": 1,
  "limit": 10,
  "search": "string",
  "relations": [
    "string"
  ],
  "entity": "TASK",
  "entityId": "550e8400-e29b-41d4-a716-446655440000",
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "parentId": "550e8400-e29b-41d4-a716-446655440000"
})
```


## get_comment_count

`TOOL get_comment_count`

Get comment 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: ["TASK","PROJECT","GOAL","CANDIDATE","DEAL","INVOICE","OTHER"]

- `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)$"

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

- `parentId` (argument, string, uuid, optional) - Filter by parent comment ID
  Type: string, uuid
  
  Filter by parent comment 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_comment_count",
    "arguments": {
        "entity": "TASK",
        "entityId": "550e8400-e29b-41d4-a716-446655440000",
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "parentId": "550e8400-e29b-41d4-a716-446655440000"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_comment_count",
  "arguments": {
    "entity": "TASK",
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "parentId": "550e8400-e29b-41d4-a716-446655440000"
  }
});
```

### Python

```python
result = await session.call_tool("get_comment_count", arguments={
  "entity": "TASK",
  "entityId": "550e8400-e29b-41d4-a716-446655440000",
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "parentId": "550e8400-e29b-41d4-a716-446655440000"
})
```


## get_comment

`TOOL get_comment`

Get a specific comment by ID

Authentication: no security requirement declared for this operation.

Parameters:

- `id` (argument, string, uuid, required) - The comment ID
  Type: string, uuid
  
  The comment 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", "parent", "replies"])
  Type: array
  
  Relations to include (e.g., ["createdBy", "employee", "parent", "replies"])
  
  Items:
    Type: string

## Examples

### JSON-RPC

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

### TypeScript

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

### Python

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


## create_comment

`TOOL create_comment`

Create a new comment in the authenticated user's organization

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `comment_data` (required)
  Type: object
  
  The data for creating the comment
  
  - `comment` (required)
    Type: string
    
    The comment text (required)
  
  - `entity` (required)
    Type: string
    
    The entity type (required)
  
  - `entityId` (required)
    Type: string
    
    The entity ID (required)
  
  Additional properties: 
    Type: unknown

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_comment",
    "arguments": {
        "comment_data": {
          "comment": "string",
          "entity": "string",
          "entityId": "string"
        }
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "create_comment",
  "arguments": {
    "comment_data": {
      "comment": "string",
      "entity": "string",
      "entityId": "string"
    }
  }
});
```

### Python

```python
result = await session.call_tool("create_comment", arguments={
  "comment_data": {
    "comment": "string",
    "entity": "string",
    "entityId": "string"
  }
})
```


## update_comment

`TOOL update_comment`

Update an existing comment

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

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

- `comment_data` (required)
  Type: object
  
  The data for updating the comment (only comment text can be updated)
  
  - `comment` (required)
    Type: string
    
    The comment text

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_comment",
    "arguments": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "comment_data": {
          "comment": "string"
        }
      }
  }
}
```

### TypeScript

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

### Python

```python
result = await session.call_tool("update_comment", arguments={
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "comment_data": {
    "comment": "string"
  }
})
```


## delete_comment

`TOOL delete_comment`

Delete a comment

Authentication: no security requirement declared for this operation.

Parameters:

- `id` (argument, string, uuid, required) - The comment ID
  Type: string, uuid
  
  The comment 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": "delete_comment",
    "arguments": {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
  }
}
```

### TypeScript

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

### Python

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


## get_comments_by_entity

`TOOL get_comments_by_entity`

Get all comments 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: ["TASK","PROJECT","GOAL","CANDIDATE","DEAL","INVOICE","OTHER"]

- `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) - Relations to include
  Type: array
  
  Relations to include
  
  Items:
    Type: string

- `includeReplies` (argument, boolean, optional) - Include reply comments
  Type: boolean
  
  Include reply comments
  
  default: true

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_comments_by_entity",
    "arguments": {
        "entity": "TASK",
        "entityId": "550e8400-e29b-41d4-a716-446655440000",
        "page": 1,
        "limit": 10,
        "relations": [
          "string"
        ],
        "includeReplies": true
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_comments_by_entity",
  "arguments": {
    "entity": "TASK",
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "page": 1,
    "limit": 10,
    "relations": [
      "string"
    ],
    "includeReplies": true
  }
});
```

### Python

```python
result = await session.call_tool("get_comments_by_entity", arguments={
  "entity": "TASK",
  "entityId": "550e8400-e29b-41d4-a716-446655440000",
  "page": 1,
  "limit": 10,
  "relations": [
    "string"
  ],
  "includeReplies": true
})
```


## reply_to_comment

`TOOL reply_to_comment`

Reply to an existing comment

Authentication: no security requirement declared for this operation.

Parameters:

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

- `comment` (argument, string, required) - The reply comment text
  Type: string
  
  The reply comment text

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

- `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)$"

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reply_to_comment",
    "arguments": {
        "parentId": "550e8400-e29b-41d4-a716-446655440000",
        "comment": "string",
        "entity": "TASK",
        "entityId": "550e8400-e29b-41d4-a716-446655440000"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "reply_to_comment",
  "arguments": {
    "parentId": "550e8400-e29b-41d4-a716-446655440000",
    "comment": "string",
    "entity": "TASK",
    "entityId": "550e8400-e29b-41d4-a716-446655440000"
  }
});
```

### Python

```python
result = await session.call_tool("reply_to_comment", arguments={
  "parentId": "550e8400-e29b-41d4-a716-446655440000",
  "comment": "string",
  "entity": "TASK",
  "entityId": "550e8400-e29b-41d4-a716-446655440000"
})
```


## get_comment_replies

`TOOL get_comment_replies`

Get all replies to a specific comment

Authentication: no security requirement declared for this operation.

Parameters:

- `parentId` (argument, string, uuid, required) - The parent comment ID
  Type: string, uuid
  
  The parent comment 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) - 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_comment_replies",
    "arguments": {
        "parentId": "550e8400-e29b-41d4-a716-446655440000",
        "page": 1,
        "limit": 10,
        "relations": [
          "string"
        ]
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_comment_replies",
  "arguments": {
    "parentId": "550e8400-e29b-41d4-a716-446655440000",
    "page": 1,
    "limit": 10,
    "relations": [
      "string"
    ]
  }
});
```

### Python

```python
result = await session.call_tool("get_comment_replies", arguments={
  "parentId": "550e8400-e29b-41d4-a716-446655440000",
  "page": 1,
  "limit": 10,
  "relations": [
    "string"
  ]
})
```


## get_my_comments

`TOOL get_my_comments`

Get comments 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: ["TASK","PROJECT","GOAL","CANDIDATE","DEAL","INVOICE","OTHER"]

- `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)$"

- `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_comments",
    "arguments": {
        "page": 1,
        "limit": 10,
        "entity": "TASK",
        "entityId": "550e8400-e29b-41d4-a716-446655440000",
        "relations": [
          "string"
        ]
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_my_comments",
  "arguments": {
    "page": 1,
    "limit": 10,
    "entity": "TASK",
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "relations": [
      "string"
    ]
  }
});
```

### Python

```python
result = await session.call_tool("get_my_comments", arguments={
  "page": 1,
  "limit": 10,
  "entity": "TASK",
  "entityId": "550e8400-e29b-41d4-a716-446655440000",
  "relations": [
    "string"
  ]
})
```


## add_comment_to_task

`TOOL add_comment_to_task`

Add a comment to a specific task

Authentication: no security requirement declared for this operation.

Parameters:

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

- `comment` (argument, string, required) - The comment text
  Type: string
  
  The comment text

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_comment_to_task",
    "arguments": {
        "taskId": "550e8400-e29b-41d4-a716-446655440000",
        "comment": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "add_comment_to_task",
  "arguments": {
    "taskId": "550e8400-e29b-41d4-a716-446655440000",
    "comment": "string"
  }
});
```

### Python

```python
result = await session.call_tool("add_comment_to_task", arguments={
  "taskId": "550e8400-e29b-41d4-a716-446655440000",
  "comment": "string"
})
```


## add_comment_to_project

`TOOL add_comment_to_project`

Add a comment to a specific project

Authentication: no security requirement declared for this operation.

Parameters:

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

- `comment` (argument, string, required) - The comment text
  Type: string
  
  The comment text

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_comment_to_project",
    "arguments": {
        "projectId": "550e8400-e29b-41d4-a716-446655440000",
        "comment": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "add_comment_to_project",
  "arguments": {
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "comment": "string"
  }
});
```

### Python

```python
result = await session.call_tool("add_comment_to_project", arguments={
  "projectId": "550e8400-e29b-41d4-a716-446655440000",
  "comment": "string"
})
```


## add_comment_to_goal

`TOOL add_comment_to_goal`

Add a comment to a specific goal

Authentication: no security requirement declared for this operation.

Parameters:

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

- `comment` (argument, string, required) - The comment text
  Type: string
  
  The comment text

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_comment_to_goal",
    "arguments": {
        "goalId": "550e8400-e29b-41d4-a716-446655440000",
        "comment": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "add_comment_to_goal",
  "arguments": {
    "goalId": "550e8400-e29b-41d4-a716-446655440000",
    "comment": "string"
  }
});
```

### Python

```python
result = await session.call_tool("add_comment_to_goal", arguments={
  "goalId": "550e8400-e29b-41d4-a716-446655440000",
  "comment": "string"
})
```


## search_comments

`TOOL search_comments`

Search comments by content

Authentication: no security requirement declared for this operation.

Parameters:

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

- `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: ["TASK","PROJECT","GOAL","CANDIDATE","DEAL","INVOICE","OTHER"]

- `employeeId` (argument, string, uuid, optional) - Filter by employee ID
  Type: string, uuid
  
  Filter by employee 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": "search_comments",
    "arguments": {
        "query": "string",
        "limit": 20,
        "entity": "TASK",
        "employeeId": "550e8400-e29b-41d4-a716-446655440000"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "search_comments",
  "arguments": {
    "query": "string",
    "limit": 20,
    "entity": "TASK",
    "employeeId": "550e8400-e29b-41d4-a716-446655440000"
  }
});
```

### Python

```python
result = await session.call_tool("search_comments", arguments={
  "query": "string",
  "limit": 20,
  "entity": "TASK",
  "employeeId": "550e8400-e29b-41d4-a716-446655440000"
})
```


## get_recent_comments

`TOOL get_recent_comments`

Get recent comments for the authenticated user's organization

Authentication: no security requirement declared for this operation.

Parameters:

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

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

- `employeeId` (argument, string, uuid, optional) - Filter by employee ID
  Type: string, uuid
  
  Filter by employee 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
  Type: array
  
  Relations to include
  
  Items:
    Type: string

## Examples

### JSON-RPC

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

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_recent_comments",
  "arguments": {
    "limit": 20,
    "entity": "TASK",
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "relations": [
      "string"
    ]
  }
});
```

### Python

```python
result = await session.call_tool("get_recent_comments", arguments={
  "limit": 20,
  "entity": "TASK",
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "relations": [
    "string"
  ]
})
```