# Employee Awards

## get_employee_awards

`TOOL get_employee_awards`

Get list of employee awards 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 award name
  Type: string
  
  Search term for award name

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

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

- `year` (argument, string, optional) - Filter by award year
  Type: string
  
  Filter by award year

- `sortBy` (argument, string, optional) - Sort awards by field
  Type: string
  
  Sort awards by field
  
  enum: ["name","year","createdAt","updatedAt"]

- `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_employee_awards",
    "arguments": {
        "page": 1,
        "limit": 10,
        "search": "string",
        "relations": [
          "string"
        ],
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "year": "string",
        "sortBy": "name",
        "sortOrder": "DESC"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_employee_awards",
  "arguments": {
    "page": 1,
    "limit": 10,
    "search": "string",
    "relations": [
      "string"
    ],
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "year": "string",
    "sortBy": "name",
    "sortOrder": "DESC"
  }
});
```

### Python

```python
result = await session.call_tool("get_employee_awards", arguments={
  "page": 1,
  "limit": 10,
  "search": "string",
  "relations": [
    "string"
  ],
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "year": "string",
  "sortBy": "name",
  "sortOrder": "DESC"
})
```


## get_employee_award

`TOOL get_employee_award`

Get a specific employee award by ID

Authentication: no security requirement declared for this operation.

Parameters:

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

## Examples

### JSON-RPC

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

### TypeScript

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

### Python

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


## create_employee_award

`TOOL create_employee_award`

Create a new employee award in the authenticated user's organization

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `award_data` (required)
  Type: object
  
  The data for creating the employee award
  
  - `name` (required)
    Type: string
    
    The award name (required)
  
  - `year` (required)
    Type: number
    
    The year (required)
  
  - `employeeId` (required)
    Type: string
    
    The employee ID (required)
  
  Additional properties: 
    Type: unknown

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_employee_award",
    "arguments": {
        "award_data": {
          "name": "string",
          "year": 0,
          "employeeId": "string"
        }
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "create_employee_award",
  "arguments": {
    "award_data": {
      "name": "string",
      "year": 0,
      "employeeId": "string"
    }
  }
});
```

### Python

```python
result = await session.call_tool("create_employee_award", arguments={
  "award_data": {
    "name": "string",
    "year": 0,
    "employeeId": "string"
  }
})
```


## update_employee_award

`TOOL update_employee_award`

Update an existing employee award

Authentication: no security requirement declared for this operation.

Parameters:

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

- `award_data` (argument, object, required) - The data for updating the employee award
  Type: object
  
  The data for updating the employee award
  
  Additional properties: 
    Type: unknown

## Examples

### JSON-RPC

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

### TypeScript

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

### Python

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


## delete_employee_award

`TOOL delete_employee_award`

Delete an employee award

Authentication: no security requirement declared for this operation.

Parameters:

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

### TypeScript

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

### Python

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


## get_employee_awards_by_employee

`TOOL get_employee_awards_by_employee`

Get awards for a specific employee

Authentication: no security requirement declared for this operation.

Parameters:

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

- `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

- `year` (argument, string, optional) - Filter by award year
  Type: string
  
  Filter by award year

- `sortBy` (argument, string, optional) - Sort awards by field
  Type: string
  
  Sort awards by field
  
  default: "year"
  
  enum: ["name","year","createdAt"]

- `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_employee_awards_by_employee",
    "arguments": {
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "page": 1,
        "limit": 10,
        "year": "string",
        "sortBy": "year",
        "sortOrder": "DESC"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_employee_awards_by_employee",
  "arguments": {
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "page": 1,
    "limit": 10,
    "year": "string",
    "sortBy": "year",
    "sortOrder": "DESC"
  }
});
```

### Python

```python
result = await session.call_tool("get_employee_awards_by_employee", arguments={
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "page": 1,
  "limit": 10,
  "year": "string",
  "sortBy": "year",
  "sortOrder": "DESC"
})
```


## get_employee_awards_by_year

`TOOL get_employee_awards_by_year`

Get employee awards for a specific year

Authentication: no security requirement declared for this operation.

Parameters:

- `year` (argument, string, required) - The award year
  Type: string
  
  The award year

- `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

- `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

- `sortBy` (argument, string, optional) - Sort awards by field
  Type: string
  
  Sort awards by field
  
  default: "name"
  
  enum: ["name","createdAt","employee"]

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

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_employee_awards_by_year",
    "arguments": {
        "year": "string",
        "page": 1,
        "limit": 10,
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "relations": [
          "string"
        ],
        "sortBy": "name",
        "sortOrder": "ASC"
      }
  }
}
```

### TypeScript

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

### Python

```python
result = await session.call_tool("get_employee_awards_by_year", arguments={
  "year": "string",
  "page": 1,
  "limit": 10,
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "relations": [
    "string"
  ],
  "sortBy": "name",
  "sortOrder": "ASC"
})
```


## get_employee_awards_count

`TOOL get_employee_awards_count`

Get employee awards count in the authenticated user's organization

Authentication: no security requirement declared for this operation.

Parameters:

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

- `year` (argument, string, optional) - Filter by award year
  Type: string
  
  Filter by award year

- `search` (argument, string, optional) - Search term for award name
  Type: string
  
  Search term for award name

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_employee_awards_count",
    "arguments": {
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "year": "string",
        "search": "string"
      }
  }
}
```

### TypeScript

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

### Python

```python
result = await session.call_tool("get_employee_awards_count", arguments={
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "year": "string",
  "search": "string"
})
```


## get_employee_awards_statistics

`TOOL get_employee_awards_statistics`

Get employee awards statistics for the authenticated user's organization

Authentication: no security requirement declared for this operation.

Parameters:

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

- `year` (argument, string, optional) - Filter by award year
  Type: string
  
  Filter by award year

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

- `groupBy` (argument, string, optional) - Group statistics by field
  Type: string
  
  Group statistics by field
  
  enum: ["employee","year","month"]

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_employee_awards_statistics",
    "arguments": {
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "year": "string",
        "startDate": "string",
        "endDate": "string",
        "groupBy": "employee"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "get_employee_awards_statistics",
  "arguments": {
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "year": "string",
    "startDate": "string",
    "endDate": "string",
    "groupBy": "employee"
  }
});
```

### Python

```python
result = await session.call_tool("get_employee_awards_statistics", arguments={
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "year": "string",
  "startDate": "string",
  "endDate": "string",
  "groupBy": "employee"
})
```


## bulk_create_employee_awards

`TOOL bulk_create_employee_awards`

Create multiple employee awards in bulk for the authenticated user's organization

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `awards` (required)
  Type: array
  
  Array of employee award data to create
  
  Items:
    Type: object
    
    Employee award data
    
    - `name` (required)
      Type: string
      
      The award name (required)
    
    - `year` (required)
      Type: number
      
      The year (required)
    
    - `employeeId` (required)
      Type: string
      
      The employee ID (required)
    
    Additional properties: 
      Type: unknown

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bulk_create_employee_awards",
    "arguments": {
        "awards": [
          {
            "name": "string",
            "year": 0,
            "employeeId": "string"
          }
        ]
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "bulk_create_employee_awards",
  "arguments": {
    "awards": [
      {
        "name": "string",
        "year": 0,
        "employeeId": "string"
      }
    ]
  }
});
```

### Python

```python
result = await session.call_tool("bulk_create_employee_awards", arguments={
  "awards": [
    {
      "name": "string",
      "year": 0,
      "employeeId": "string"
    }
  ]
})
```


## bulk_update_employee_awards

`TOOL bulk_update_employee_awards`

Update multiple employee awards in bulk

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `awards` (required)
  Type: array
  
  Array of employee award updates
  
  Items:
    Type: object
    
    - `id` (required)
      Type: string, uuid
      
      The employee award 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)$"
    
    - `data` (required)
      Type: object
      
      The data to update
      
      Additional properties: 
        Type: unknown

## Examples

### JSON-RPC

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

### TypeScript

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

### Python

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


## bulk_delete_employee_awards

`TOOL bulk_delete_employee_awards`

Delete multiple employee awards in bulk

Authentication: no security requirement declared for this operation.

Parameters:

- `ids` (argument, array, required) - Array of employee award IDs to delete
  Type: array
  
  Array of employee award IDs to delete
  
  Items:
    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)$"

## Examples

### JSON-RPC

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

### TypeScript

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

### Python

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