Time Off

get_time_off_requests

Get list of time-off requests for the authenticated user's organization

get_time_off_requests

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_time_off_requests",
    "arguments": {
        "page": 1,
        "limit": 10,
        "search": "string",
        "relations": [
          "string"
        ],
        "status": "REQUESTED",
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "policyId": "550e8400-e29b-41d4-a716-446655440000",
        "startDate": "string",
        "endDate": "string"
      }
  }
}

const result = await client.callTool({
  "name": "get_time_off_requests",
  "arguments": {
    "page": 1,
    "limit": 10,
    "search": "string",
    "relations": [
      "string"
    ],
    "status": "REQUESTED",
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "policyId": "550e8400-e29b-41d4-a716-446655440000",
    "startDate": "string",
    "endDate": "string"
  }
});

result = await session.call_tool("get_time_off_requests", arguments={
  "page": 1,
  "limit": 10,
  "search": "string",
  "relations": [
    "string"
  ],
  "status": "REQUESTED",
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "policyId": "550e8400-e29b-41d4-a716-446655440000",
  "startDate": "string",
  "endDate": "string"
})

Parameters

pagenumber1

Page number for pagination

limitnumber10

Number of items per page

searchstring

Search term for request description

relationsArray<string>

Relations to include (e.g., ["employee", "policy", "approvedBy"])

statusstringREQUESTEDAPPROVEDDENIEDCANCELLED

Filter by request status

employeeIdstring<uuid>

Filter by employee ID

policyIdstring<uuid>

Filter by policy ID

startDatestring

Filter requests from this date (ISO format)

endDatestring

Filter requests until this date (ISO format)

get_time_off_request_count

Get time-off request count in the authenticated user's organization

get_time_off_request_count

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_time_off_request_count",
    "arguments": {
        "status": "REQUESTED",
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "policyId": "550e8400-e29b-41d4-a716-446655440000",
        "startDate": "string",
        "endDate": "string"
      }
  }
}

const result = await client.callTool({
  "name": "get_time_off_request_count",
  "arguments": {
    "status": "REQUESTED",
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "policyId": "550e8400-e29b-41d4-a716-446655440000",
    "startDate": "string",
    "endDate": "string"
  }
});

result = await session.call_tool("get_time_off_request_count", arguments={
  "status": "REQUESTED",
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "policyId": "550e8400-e29b-41d4-a716-446655440000",
  "startDate": "string",
  "endDate": "string"
})

Parameters

statusstringREQUESTEDAPPROVEDDENIEDCANCELLED

Filter by request status

employeeIdstring<uuid>

Filter by employee ID

policyIdstring<uuid>

Filter by policy ID

startDatestring

Filter requests from this date (ISO format)

endDatestring

Filter requests until this date (ISO format)

get_time_off_request

Get a specific time-off request by ID

get_time_off_request

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

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

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

Parameters

idstring<uuid>required

The time-off request ID

relationsArray<string>

Relations to include (e.g., ["employee", "policy", "approvedBy"])

create_time_off_request

Create a new time-off request in the authenticated user's organization

create_time_off_request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_time_off_request",
    "arguments": {
        "request_data": {
          "startDate": "string",
          "endDate": "string",
          "employeeId": "string",
          "policyId": "string"
        }
      }
  }
}

const result = await client.callTool({
  "name": "create_time_off_request",
  "arguments": {
    "request_data": {
      "startDate": "string",
      "endDate": "string",
      "employeeId": "string",
      "policyId": "string"
    }
  }
});

result = await session.call_tool("create_time_off_request", arguments={
  "request_data": {
    "startDate": "string",
    "endDate": "string",
    "employeeId": "string",
    "policyId": "string"
  }
})

Request Body

{
  "request_data": {
    "startDate": "string",
    "endDate": "string",
    "employeeId": "string",
    "policyId": "string"
  }
}

Body

application/json

request_dataobjectrequired

The data for creating the time-off request

Show child attributes

startDatestringrequired

The start date (required)

endDatestringrequired

The end date (required)

employeeIdstringrequired

The employee ID (required)

policyIdstringrequired

The policy ID (required)

[key: string]any

update_time_off_request

Update an existing time-off request

update_time_off_request

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

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

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

Parameters

idstring<uuid>required

The time-off request ID

request_dataobjectrequired

The data for updating the time-off request

delete_time_off_request

Delete a time-off request

delete_time_off_request

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

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

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

Parameters

idstring<uuid>required

The time-off request ID

approve_time_off_request

Approve a time-off request

approve_time_off_request

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

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

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

Parameters

idstring<uuid>required

The time-off request ID

deny_time_off_request

Deny a time-off request

deny_time_off_request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "deny_time_off_request",
    "arguments": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "reason": "string"
      }
  }
}

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

result = await session.call_tool("deny_time_off_request", arguments={
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "string"
})

Parameters

idstring<uuid>required

The time-off request ID

reasonstring

Reason for denial

cancel_time_off_request

Cancel a time-off request

cancel_time_off_request

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

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

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

Parameters

idstring<uuid>required

The time-off request ID

get_my_time_off_requests

Get time-off requests for the current authenticated user

get_my_time_off_requests

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_my_time_off_requests",
    "arguments": {
        "page": 1,
        "limit": 10,
        "status": "REQUESTED",
        "policyId": "550e8400-e29b-41d4-a716-446655440000",
        "startDate": "string",
        "endDate": "string",
        "relations": [
          "string"
        ]
      }
  }
}

const result = await client.callTool({
  "name": "get_my_time_off_requests",
  "arguments": {
    "page": 1,
    "limit": 10,
    "status": "REQUESTED",
    "policyId": "550e8400-e29b-41d4-a716-446655440000",
    "startDate": "string",
    "endDate": "string",
    "relations": [
      "string"
    ]
  }
});

result = await session.call_tool("get_my_time_off_requests", arguments={
  "page": 1,
  "limit": 10,
  "status": "REQUESTED",
  "policyId": "550e8400-e29b-41d4-a716-446655440000",
  "startDate": "string",
  "endDate": "string",
  "relations": [
    "string"
  ]
})

Parameters

pagenumber1

Page number for pagination

limitnumber10

Number of items per page

statusstringREQUESTEDAPPROVEDDENIEDCANCELLED

Filter by request status

policyIdstring<uuid>

Filter by policy ID

startDatestring

Filter requests from this date (ISO format)

endDatestring

Filter requests until this date (ISO format)

relationsArray<string>

Relations to include

get_pending_time_off_requests

Get pending time-off requests for the authenticated user's organization

get_pending_time_off_requests

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_pending_time_off_requests",
    "arguments": {
        "page": 1,
        "limit": 10,
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "policyId": "550e8400-e29b-41d4-a716-446655440000",
        "relations": [
          "string"
        ]
      }
  }
}

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

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

Parameters

pagenumber1

Page number for pagination

limitnumber10

Number of items per page

employeeIdstring<uuid>

Filter by employee ID

policyIdstring<uuid>

Filter by policy ID

relationsArray<string>

Relations to include

get_time_off_policies

Get list of time-off policies for the authenticated user's organization

get_time_off_policies

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_time_off_policies",
    "arguments": {
        "page": 1,
        "limit": 10,
        "search": "string",
        "relations": [
          "string"
        ],
        "type": "VACATION",
        "requiresApproval": true,
        "paid": true
      }
  }
}

const result = await client.callTool({
  "name": "get_time_off_policies",
  "arguments": {
    "page": 1,
    "limit": 10,
    "search": "string",
    "relations": [
      "string"
    ],
    "type": "VACATION",
    "requiresApproval": true,
    "paid": true
  }
});

result = await session.call_tool("get_time_off_policies", arguments={
  "page": 1,
  "limit": 10,
  "search": "string",
  "relations": [
    "string"
  ],
  "type": "VACATION",
  "requiresApproval": true,
  "paid": true
})

Parameters

pagenumber1

Page number for pagination

limitnumber10

Number of items per page

searchstring

Search term for policy name

relationsArray<string>

Relations to include (e.g., ["employees"])

typestringVACATIONSICK_LEAVEPERSONALMATERNITYPATERNITYBEREAVEMENTOTHER

Filter by policy type

requiresApprovalboolean

Filter by approval requirement

paidboolean

Filter by paid status

get_time_off_policy

Get a specific time-off policy by ID

get_time_off_policy

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

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

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

Parameters

idstring<uuid>required

The time-off policy ID

relationsArray<string>

Relations to include (e.g., ["employees"])

create_time_off_policy

Create a new time-off policy in the authenticated user's organization

create_time_off_policy

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_time_off_policy",
    "arguments": {
        "policy_data": {
          "name": "string",
          "type": "string"
        }
      }
  }
}

const result = await client.callTool({
  "name": "create_time_off_policy",
  "arguments": {
    "policy_data": {
      "name": "string",
      "type": "string"
    }
  }
});

result = await session.call_tool("create_time_off_policy", arguments={
  "policy_data": {
    "name": "string",
    "type": "string"
  }
})

Request Body

{
  "policy_data": {
    "name": "string",
    "type": "string"
  }
}

Body

application/json

policy_dataobjectrequired

The data for creating the time-off policy

Show child attributes

namestringrequired

The policy name (required)

typestringrequired

The policy type (required)

[key: string]any

update_time_off_policy

Update an existing time-off policy

update_time_off_policy

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

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

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

Parameters

idstring<uuid>required

The time-off policy ID

policy_dataobjectrequired

The data for updating the time-off policy

delete_time_off_policy

Delete a time-off policy

delete_time_off_policy

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

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

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

Parameters

idstring<uuid>required

The time-off policy ID

assign_employees_to_time_off_policy

Assign employees to a time-off policy

assign_employees_to_time_off_policy

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "assign_employees_to_time_off_policy",
    "arguments": {
        "policyId": "550e8400-e29b-41d4-a716-446655440000",
        "employeeIds": [
          "550e8400-e29b-41d4-a716-446655440000"
        ]
      }
  }
}

const result = await client.callTool({
  "name": "assign_employees_to_time_off_policy",
  "arguments": {
    "policyId": "550e8400-e29b-41d4-a716-446655440000",
    "employeeIds": [
      "550e8400-e29b-41d4-a716-446655440000"
    ]
  }
});

result = await session.call_tool("assign_employees_to_time_off_policy", arguments={
  "policyId": "550e8400-e29b-41d4-a716-446655440000",
  "employeeIds": [
    "550e8400-e29b-41d4-a716-446655440000"
  ]
})

Parameters

policyIdstring<uuid>required

The time-off policy ID

employeeIdsArray<string>required

Array of employee IDs to assign

get_time_off_balance

Get time-off balance for an employee

get_time_off_balance

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_time_off_balance",
    "arguments": {
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "policyId": "550e8400-e29b-41d4-a716-446655440000",
        "year": 0
      }
  }
}

const result = await client.callTool({
  "name": "get_time_off_balance",
  "arguments": {
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "policyId": "550e8400-e29b-41d4-a716-446655440000",
    "year": 0
  }
});

result = await session.call_tool("get_time_off_balance", arguments={
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "policyId": "550e8400-e29b-41d4-a716-446655440000",
  "year": 0
})

Parameters

employeeIdstring<uuid>required

The employee ID

policyIdstring<uuid>

Filter by specific policy ID

yearnumber

Filter by specific year

get_my_time_off_balance

Get time-off balance for the current authenticated user

get_my_time_off_balance

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_my_time_off_balance",
    "arguments": {
        "policyId": "550e8400-e29b-41d4-a716-446655440000",
        "year": 0
      }
  }
}

const result = await client.callTool({
  "name": "get_my_time_off_balance",
  "arguments": {
    "policyId": "550e8400-e29b-41d4-a716-446655440000",
    "year": 0
  }
});

result = await session.call_tool("get_my_time_off_balance", arguments={
  "policyId": "550e8400-e29b-41d4-a716-446655440000",
  "year": 0
})

Parameters

policyIdstring<uuid>

Filter by specific policy ID

yearnumber

Filter by specific year

get_time_off_statistics

Get time-off statistics for the authenticated user's organization

get_time_off_statistics

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_time_off_statistics",
    "arguments": {
        "startDate": "string",
        "endDate": "string",
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "policyId": "550e8400-e29b-41d4-a716-446655440000",
        "type": "VACATION",
        "groupBy": "employee"
      }
  }
}

const result = await client.callTool({
  "name": "get_time_off_statistics",
  "arguments": {
    "startDate": "string",
    "endDate": "string",
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "policyId": "550e8400-e29b-41d4-a716-446655440000",
    "type": "VACATION",
    "groupBy": "employee"
  }
});

result = await session.call_tool("get_time_off_statistics", arguments={
  "startDate": "string",
  "endDate": "string",
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "policyId": "550e8400-e29b-41d4-a716-446655440000",
  "type": "VACATION",
  "groupBy": "employee"
})

Parameters

startDatestring

Start date for statistics (ISO format)

endDatestring

End date for statistics (ISO format)

employeeIdstring<uuid>

Filter by specific employee ID

policyIdstring<uuid>

Filter by specific policy ID

typestringVACATIONSICK_LEAVEPERSONALMATERNITYPATERNITYBEREAVEMENTOTHER

Filter by time-off type

groupBystringemployeepolicytypemonth

Group statistics by

Stack Overflow Website Demo