List all tickets with pagination.

Args: page: Page number (starts at 1). per_page: Results per page (max 100).

Retrieve a single ticket by ID, including conversations and stats.

Args: ticket_id: The numeric ticket ID.

Create a new Freshservice ticket.

Args: subject: Ticket subject line. description: Ticket description (HTML supported). email: Requester email. Creates a new contact if not found. priority: 1=Low, 2=Medium, 3=High, 4=Urgent. status: 2=Open, 3=Pending, 4=Resolved, 5=Closed. source: 1=Email, 2=Portal, 3=Phone, 4=Chat, 9=Walkup, 10=Slack. type: Ticket type (default "Incident"). group_id: ID of assigned agent group. responder_id: ID of assigned agent. department_id: Department ID. category: Ticket category. sub_category: Ticket sub-category. tags: List of tags. cc_emails: CC email addresses. custom_fields: Custom field key-value pairs. workspace_id: Workspace ID (for multi-workspace accounts).

Update an existing ticket.

Args: ticket_id: The ticket ID to update. updates: Dictionary of fields to update. Common fields: status, priority, group_id, responder_id, subject, description, category, tags, custom_fields, etc.

Trash a ticket (soft delete).

Args: ticket_id: The ticket ID to delete.

Filter tickets using Freshservice query language.

The query MUST be wrapped in double quotes. Examples: "status:2" — open tickets "priority:4" — urgent tickets "agent_id:1234 AND status:2" "group_id:5 AND priority:>2" "created_at:>'2024-01-01'"

Args: query: Freshservice filter query string (must be in double quotes). page: Page number. per_page: Results per page (max 100).

Retrieve all ticket field definitions (built-in and custom).

List all conversations (replies and notes) for a ticket.

Args: ticket_id: The ticket ID. page: Page number. per_page: Results per page (max 100).

Reply to a ticket (visible to requester).

Args: ticket_id: The ticket ID. body: Reply body (HTML supported). cc_emails: Optional CC email addresses.

Add a note to a ticket.

Args: ticket_id: The ticket ID. body: Note body (HTML supported). private: True for private (agent-only) note, False for public.

Delete a note from a ticket.

Args: ticket_id: The ticket ID. conversation_id: The conversation (note) ID to delete.

List all changes with optional filtering.

Args: page: Page number. per_page: Results per page (max 100). query: Optional filter query, MUST be in double quotes. E.g. "status:3", "approval_status:1 AND status:<6".

Filter changes with advanced queries.

Query MUST be wrapped in double quotes. Examples: "status:3" — awaiting approval "approval_status:1" — approved "approval_status:1 AND status:<6" — approved but not closed

Args: query: Freshservice filter query string. page: Page number. per_page: Results per page.

Retrieve a single change by ID.

Args: change_id: The change ID.

Create a new change request.

Args: requester_id: ID of the requester. subject: Change subject. description: Change description (HTML supported). priority: 1=Low, 2=Medium, 3=High, 4=Urgent. impact: 1=Low, 2=Medium, 3=High. status: 1=Open, 2=Planning, 3=Awaiting Approval, 4=Pending Release, 5=Pending Review, 6=Closed. risk: 1=Low, 2=Medium, 3=High, 4=Very High. change_type: 1=Minor, 2=Standard, 3=Major, 4=Emergency. planned_start_date: ISO 8601 datetime string. planned_end_date: ISO 8601 datetime string. group_id: Agent group ID. workspace_id: Workspace ID. custom_fields: Custom field key-value pairs.

Update an existing change request.

Args: change_id: The change ID. change_fields: Dictionary of fields to update. Common fields: status, priority, impact, risk, subject, description, group_id, etc.

Close a change with a result explanation.

Args: change_id: The change ID. change_result_explanation: Explanation of the change result.

Delete a change request.

Args: change_id: The change ID.

Get all tasks associated with a change.

Args: change_id: The change ID.

Add a note to a change request.

Args: change_id: The change ID. body: Note body (HTML supported). private: True for agent-only note, False for public.

List all assets with pagination.

Args: page: Page number. per_page: Results per page (max 100).

Retrieve a single asset by its display ID.

Args: display_id: The asset display ID.

Search assets by various fields.

Query examples: "name:'Dell Laptop'" "asset_tag:'ASSET-001'" "serial_number:'SN123'" "asset_state:'In Use'"

Args: query: Asset search query. page: Page number. per_page: Results per page.

Filter assets using Freshservice query language.

Args: query: Filter query. E.g. "asset_type_id:1", "department_id:5". page: Page number. per_page: Results per page.

Create a new asset.

Args: name: Asset name. asset_type_id: Asset type ID (from get_asset_types). description: Asset description. impact: 1=Low, 2=Medium, 3=High. user_id: User assigned to the asset. department_id: Department ID. location_id: Location ID. agent_id: Agent managing the asset. asset_tag: Custom asset tag. custom_fields: Custom field key-value pairs.

Update an existing asset.

Args: display_id: The asset display ID. updates: Dictionary of fields to update.

Delete an asset (soft delete / trash).

Args: display_id: The asset display ID.

List all asset types.

Args: page: Page number. per_page: Results per page.

List all requesters with pagination.

Args: page: Page number. per_page: Results per page (max 100).

Retrieve a single requester by ID.

Args: requester_id: The requester ID.

Filter requesters. Query examples: email, name, department, etc.

Args: query: Filter query string. page: Page number. per_page: Results per page.

Create a new requester / contact.

Args: first_name: Requester first name. email: Requester email address. last_name: Requester last name. phone: Phone number. department_ids: List of department IDs. custom_fields: Custom fields.

List all agents with pagination.

Args: page: Page number. per_page: Results per page (max 100).

Retrieve a single agent by ID.

Args: agent_id: The agent ID.

Filter agents by various criteria.

Args: query: Filter query (e.g. email, name, department, active status). page: Page number. per_page: Results per page.

List all agent groups.

Args: page: Page number. per_page: Results per page.

Get details of a specific agent group.

Args: group_id: The group ID.

List all requester groups.

Args: page: Page number. per_page: Results per page.

Get details of a specific requester group.

Args: group_id: The group ID.

List all products.

Args: page: Page number. per_page: Results per page.

Get details of a specific product.

Args: product_id: The product ID.

List all workspaces.

Args: page: Page number. per_page: Results per page.

List all canned response folders.

List all canned responses within a folder.

Args: folder_id: The canned response folder ID.

Get a specific canned response by ID.

Args: response_id: The canned response ID.

List all solution (knowledge base) categories.

Args: page: Page number. per_page: Results per page.

View a specific solution category.

Args: category_id: The category ID.

Create a new solution category.

Args: name: Category name. description: Category description.

List all solution folders in a category.

Args: category_id: The parent category ID. page: Page number. per_page: Results per page.

View a specific solution folder.

Args: folder_id: The folder ID.

Create a new solution folder.

Args: category_id: Parent category ID. name: Folder name. description: Folder description. visibility: 1=All, 2=Logged-in users, 3=Agents only.

List all solution articles in a folder.

Args: folder_id: The parent folder ID. page: Page number. per_page: Results per page.

View a specific solution article.

Args: article_id: The article ID.

Create a new solution article.

Args: folder_id: Parent folder ID. title: Article title. description: Article body (HTML supported). status: 1=Draft, 2=Published. article_type: 1=Permanent, 2=Workaround. tags: Optional list of tags.

Search solution articles by keyword.

Args: search_term: Text to search for in articles.

List all problems with pagination.

Args: page: Page number. per_page: Results per page (max 100).

Retrieve a single problem by ID.

Args: problem_id: The problem ID.

Create a new problem.

Args: subject: Problem subject. description: Problem description (HTML). requester_id: Requester ID. priority: 1=Low, 2=Medium, 3=High, 4=Urgent. impact: 1=Low, 2=Medium, 3=High. status: 1=Open, 2=Change Requested, 3=Closed. group_id: Agent group ID. custom_fields: Custom fields.

List all departments.

Args: page: Page number. per_page: Results per page.

View a specific department.

Args: department_id: The department ID.

List all locations.

Args: page: Page number. per_page: Results per page.

List all software entries.

Args: page: Page number. per_page: Results per page.

View a specific software entry.

Args: software_id: The software ID.

List all vendors.

Args: page: Page number. per_page: Results per page.

List all service catalog items.

Args: page: Page number. per_page: Results per page.

View a specific service catalog item.

Args: item_id: The service catalog item ID.

List all announcements.

Args: page: Page number. per_page: Results per page.

List all contracts.

Args: page: Page number. per_page: Results per page.

View a specific contract.

Args: contract_id: The contract ID.

List all purchase orders.

Args: page: Page number. per_page: Results per page.