Tools
402 available tools
Search the tool definitions captured from the MCP server. The live list can vary with version, deployment, and credentials.
402 tools found.
Add entity type field
Tool name:
add_entity_type_fieldDeprecated: use POST /v2/entity-type-fields.
Add label to app instance
Tool name:
add_label_to_app_instanceDEPRECATED: use AddTagToSubject.
Add tag to subject
Tool name:
add_tag_to_subjectAttach a tag to a subject (resource, role, app instance, workflow, or guidance).
Add ticket assignment group
Tool name:
add_ticket_assignment_groupAdd a group to the team's configured assignment groups.
Add ticket relevant asset
Tool name:
add_ticket_relevant_assetAdd a relevant asset to a ticket.
Aggregate entities
Tool name:
aggregate_entitiesAggregate live-entity counts for one entity schema (database), grouped by entity type or by creation-time bucket (day or month).
Archive entity
Tool name:
archive_entityArchive an entity, hiding it from active browse while keeping its key reserved so the key cannot be reused.
Archive ticket
Tool name:
archive_ticketMove a ticket into cold storage, removing it from most views.
Await workflow run result
Tool name:
await_workflow_run_resultBlock until the workflow run reaches a terminal status or wait_timeout_seconds elapses.
Batch create app resources
Tool name:
batch_create_app_resourcesCreate multiple app resources for an app instance in a single request.
Batch get review items
Tool name:
batch_get_review_itemsRead before and after documents for 1–20 unique item IDs from one review, in request order.
Batch update app resource roles
Tool name:
batch_update_app_resource_rolesUpdate multiple app resource roles in a single transactional request.
Batch update app resources
Tool name:
batch_update_app_resourcesUpdate multiple app resources in a single transactional request.
Bulk add label to app instances
Tool name:
bulk_add_label_to_app_instancesDEPRECATED: use AddTagToSubject per app instance.
Bulk remove label from app instances
Tool name:
bulk_remove_label_from_app_instancesDEPRECATED: use RemoveTagFromSubject per app instance.
Cancel schema migration
Tool name:
cancel_schema_migrationCancel a still-pending schema migration.
Connect ticket to external ticket
Tool name:
connect_ticket_to_external_ticketConnect an existing Serval ticket to an existing external ticket in a sync channel.
Count workflow runs
Tool name:
count_workflow_runsCount workflow runs matching the same filters as Search Workflow Runs (workflow ID, status, user IDs, time range, linked ticket, parent run, include_child_runs, include_runs_with_linked_ticket).
Create access policy
Tool name:
create_access_policyCreate a new access policy for a team.
Create access policy approval procedure
Tool name:
create_access_policy_approval_procedureCreate a new approval procedure for an access policy.
Create access profile
Tool name:
create_access_profileCreate a new access profile for a team.
Create access profile grant
Tool name:
create_access_profile_grantAttach an access profile to a workflow, app resource role, or form.
Create access relationship
Tool name:
create_access_relationshipCreate an access relationship on a subject (app instance, resource, role, or team).
Create access request
Tool name:
create_access_requestCreate an access request for a role.
Create agent
Tool name:
create_agentCreate a new agent.
Create app instance
Tool name:
create_app_instanceCreate a new app instance for a team.
Create app instance label
Tool name:
create_app_instance_labelDEPRECATED: use the Tag API.
Create app relationship
Tool name:
create_app_relationshipDEPRECATED: use CreateAccessRelationship.
Create app resource
Tool name:
create_app_resourceCreate a new app resource for an app instance.
Create app resource role
Tool name:
create_app_resource_roleCreate a new app resource role for a resource.
Create approval delegation
Tool name:
create_approval_delegationCreate a new approval delegation rule.
Create approval procedure
Tool name:
create_approval_procedureCreate a named, team-scoped approval procedure.
Create assignment rule
Tool name:
create_assignment_ruleCreate an assignment rule on a team.
Create category option
Tool name:
create_category_optionCreate a category (or subcategory) for a team.
Create change blackout schedule
Tool name:
create_change_blackout_scheduleCreate a one-off change-blackout window during which changes are frozen.
Create custom field option
Tool name:
create_custom_field_optionCreate a custom field definition on a team's ticket type.
Create custom role
Tool name:
create_custom_roleCreate a custom role on a team.
Create custom service
Tool name:
create_custom_serviceCreate a new custom service for a team.
Create database rule
Tool name:
create_database_ruleCreate a rule on a table.
Create entity
Tool name:
create_entityCreate a new entity for a team.
Create entity field mapping
Tool name:
create_entity_field_mappingCreate a field mapping binding an external source field (from an ingestion config's discovered external schema) to an internal entity-type field.
Create entity ingestion config
Tool name:
create_entity_ingestion_configCreate an entity ingestion config that links a workflow to an entity type for periodic data synchronization.
Create entity type
Tool name:
create_entity_typeCreate a new entity type with optional fields for a team.
Create entity type field
Tool name:
create_entity_type_fieldCreate a field on an entity type.
Create folder
Tool name:
create_folderCreate a folder to organize folder items.
Create form
Tool name:
create_formCreate a form for a team from module source (TSX importing "serval/forms").
Create group
Tool name:
create_groupCreate a new group.
Create guidance
Tool name:
create_guidanceCreate a new guidance for a team.
Create help agent simulation
Tool name:
create_help_agent_simulationRun a help-agent simulation from a saved simulation config.
Create help agent simulation config
Tool name:
create_help_agent_simulation_configCreate a saved help-agent simulation config (a reusable evaluation scenario).
Create knowledge base
Tool name:
create_knowledge_baseCreate a native knowledge base for a team.
Create knowledge document
Tool name:
create_knowledge_documentCreate a knowledge document (page or folder).
Create label
Tool name:
create_labelCreate a ticket label for a help-desk team.
Create reclamation candidate
Tool name:
create_reclamation_candidateFlag an entitlement grant for reclamation now, on your own logic, without waiting for the inactivity sweep.
Create schedule
Tool name:
create_scheduleCreate a recurring schedule for a team.
Create sla definition
Tool name:
create_sla_definitionCreate an SLA definition for a team.
Create status
Tool name:
create_statusCreate a ticket status for a team.
Create tag
Tool name:
create_tagCreate a new tag.
Create team
Tool name:
create_teamCreate a new team.
Create team group
Tool name:
create_team_groupBind a group to a team with a specified role.
Create team user
Tool name:
create_team_userAdd a user to a team with a specified role.
Create ticket
Tool name:
create_ticketCreate a new ticket.
Create ticket external messages
Tool name:
create_ticket_external_messagesRegister Serval messages as already present in an external channel.
Create ticket message
Tool name:
create_ticket_messageCreate a new message in a ticket.
Create ticket model field
Tool name:
create_ticket_model_fieldAdd a custom field to a ticket model.
Create ticket model transition
Tool name:
create_ticket_model_transitionCreate a transition in a ticket model.
Create ticket subscribers
Tool name:
create_ticket_subscribersAdd subscribers to a ticket.
Create user
Tool name:
create_userCreate a new user.
Create user relationship
Tool name:
create_user_relationshipCreate or update a user relationship.
Create workflow
Tool name:
create_workflowCreate a new workflow for a team.
Create workflow approval procedure
Tool name:
create_workflow_approval_procedureCreate a new approval procedure for a workflow.
Delete access policy
Tool name:
delete_access_policyDelete an access policy.
Delete access policy approval procedure
Tool name:
delete_access_policy_approval_procedureDelete an approval procedure for an access policy.
Delete access profile
Tool name:
delete_access_profileDelete an access profile.
Delete access profile grant
Tool name:
delete_access_profile_grantDelete an access profile grant, detaching the profile from the resource.
Delete access relationship
Tool name:
delete_access_relationshipDelete an access relationship.
Delete agent
Tool name:
delete_agentDelete an agent.
Delete app instance
Tool name:
delete_app_instanceDelete an app instance.
Delete app instance label
Tool name:
delete_app_instance_labelDEPRECATED: use the Tag API.
Delete app relationship
Tool name:
delete_app_relationshipDEPRECATED: use DeleteAccessRelationship.
Delete app resource
Tool name:
delete_app_resourceDelete an app resource.
Delete app resource role
Tool name:
delete_app_resource_roleDelete an app resource role.
Delete approval delegation
Tool name:
delete_approval_delegationDelete an approval delegation rule.
Delete approval procedure
Tool name:
delete_approval_procedureDelete an approval procedure.
Delete assignment rule
Tool name:
delete_assignment_ruleDelete an assignment rule.
Delete category option
Tool name:
delete_category_optionDelete a category and its subcategories.
Delete change blackout schedule
Tool name:
delete_change_blackout_scheduleDelete a change-blackout schedule.
Delete custom role
Tool name:
delete_custom_roleDelete a custom role.
Delete custom service
Tool name:
delete_custom_serviceDelete a custom service.
Delete database rule
Tool name:
delete_database_ruleDelete a workflow or validation rule from a table.
Delete entity
Tool name:
delete_entityDelete an entity.
Delete entity field mapping
Tool name:
delete_entity_field_mappingDelete a field mapping.
Delete entity ingestion config
Tool name:
delete_entity_ingestion_configDelete an entity ingestion config.
Delete entity type
Tool name:
delete_entity_typeDelete an entity type.
Delete entity type field
Tool name:
delete_entity_type_fieldDelete an entity type field.
Delete entity workflow rule
Tool name:
delete_entity_workflow_ruleDelete a workflow rule.
Delete folder
Tool name:
delete_folderDelete a folder.
Delete form
Tool name:
delete_formDelete a form.
Delete group
Tool name:
delete_groupDelete a group.
Delete guidance
Tool name:
delete_guidanceDelete a guidance.
Delete help agent simulation config
Tool name:
delete_help_agent_simulation_configDelete a saved help-agent simulation config.
Delete knowledge base
Tool name:
delete_knowledge_baseDelete a knowledge base and all of its documents.
Delete knowledge document
Tool name:
delete_knowledge_documentDelete a knowledge document and its descendants.
Delete label
Tool name:
delete_labelDelete a ticket label.
Delete sla definition
Tool name:
delete_sla_definitionDelete an SLA definition.
Delete status
Tool name:
delete_statusDelete an unused, non-default ticket status.
Delete tag
Tool name:
delete_tagDelete a tag.
Delete team
Tool name:
delete_teamDelete a team.
Delete team group
Tool name:
delete_team_groupRemove a group's role binding from a team.
Delete team user
Tool name:
delete_team_userRemove a user from a team.
Delete ticket model status entry action
Tool name:
delete_ticket_model_status_entry_actionDelete a status entry action wiring.
Delete ticket model transition
Tool name:
delete_ticket_model_transitionDelete a ticket model transition.
Delete ticket subscribers
Tool name:
delete_ticket_subscribersRemove a subscriber from a ticket.
Delete user
Tool name:
delete_userDelete a user.
Delete user relationship
Tool name:
delete_user_relationshipDelete a user relationship.
Delete workflow
Tool name:
delete_workflowDelete a workflow.
Delete workflow approval procedure
Tool name:
delete_workflow_approval_procedureDelete an approval procedure for a workflow.
Deprecate ticket model field
Tool name:
deprecate_ticket_model_fieldDeprecate a custom field on a ticket model.
Disconnect ticket from external ticket
Tool name:
disconnect_ticket_from_external_ticketDisconnect a Serval ticket from an external sync channel.
Dismiss database issue
Tool name:
dismiss_database_issueResolve an issue by closing every open occurrence.
Dismiss reclamation candidate
Tool name:
dismiss_reclamation_candidateDismiss an in-review reclamation candidate: conclude its review as dismissed, leaving the grant in place.
Get access policy
Tool name:
get_access_policyGet a specific access policy by ID.
Get access policy approval procedure
Tool name:
get_access_policy_approval_procedureGet a specific approval procedure by ID for an access policy.
Get access profile
Tool name:
get_access_profileGet a specific access profile by ID.
Get access profile grant
Tool name:
get_access_profile_grantGet a specific access profile grant by ID.
Get access relationship
Tool name:
get_access_relationshipGet a specific access relationship by ID.
Get access request
Tool name:
get_access_requestGet a specific access request by ID.
Get agent
Tool name:
get_agentGet an agent by ID.
Get agent session
Tool name:
get_agent_sessionGet an agent run's current state.
Get agent session transcript
Tool name:
get_agent_session_transcriptGet the full transcript of an agent session — every message and the actions (tool calls) the agent took, in order.
Get app instance
Tool name:
get_app_instanceGet a specific app instance by ID.
Get app instance agent card
Tool name:
get_app_instance_agent_cardGet the A2A agent card discovered for a connected external agent app instance: the agent's name, description, and advertised skills.
Get app relationship
Tool name:
get_app_relationshipDEPRECATED: use GetAccessRelationship.
Get app resource
Tool name:
get_app_resourceGet a specific app resource by ID.
Get app resource role
Tool name:
get_app_resource_roleGet a specific app resource role by ID.
Get approval delegation
Tool name:
get_approval_delegationGet an approval delegation rule by its ID.
Get approval procedure
Tool name:
get_approval_procedureGet a specific approval procedure by ID.
Get approval request
Tool name:
get_approval_requestGet a single approval request by ID.
Get approval request step
Tool name:
get_approval_request_stepGet a single step for an approval request.
Get assignment rule
Tool name:
get_assignment_ruleRetrieve a single assignment rule by ID.
Get category option
Tool name:
get_category_optionGet a category (or subcategory) by ID.
Get change blackout schedule
Tool name:
get_change_blackout_scheduleGet a change-blackout schedule by id.
Get current user
Tool name:
get_current_userGet the current authenticated user's profile, including their organization role and team memberships with roles.
Get custom role
Tool name:
get_custom_roleGet a custom role, including the actions it grants on top of its base role.
Get custom service
Tool name:
get_custom_serviceGet a specific custom service by ID.
Get custom service endpoint
Tool name:
get_custom_service_endpointReturn the full parameter list and request/response schemas for ONE endpoint of a custom app's uploaded API spec.
Get dashboard
Tool name:
get_dashboardRetrieve a single dashboard by ID, with its tabs and the widgets placed on each.
Get database issue
Tool name:
get_database_issueGet one issue on a table by its id, as returned by List database issues: its category, code and reason, when it was first and last observed, how many occurrences are open, and the details for its…
Get database rule
Tool name:
get_database_ruleGet a workflow or validation rule on a table.
Get entity
Tool name:
get_entityGet a specific entity by ID.
Get entity field mapping
Tool name:
get_entity_field_mappingGet a field mapping by ID.
Get entity file
Tool name:
get_entity_fileGet the metadata and a short-lived download URL for a file stored in an entity's file field.
Get entity ingestion config
Tool name:
get_entity_ingestion_configGet a specific entity ingestion config by ID.
Get entity ingestion config sync status
Tool name:
get_entity_ingestion_config_sync_statusGet the sync status for an entity ingestion config, including last sync time, current phase, and data availability flags.
Get entity schema
Tool name:
get_entity_schemaGet Entity Schema [Scope: team]
Get entity type
Tool name:
get_entity_typeGet an entity type by ID.
Get entity type field
Tool name:
get_entity_type_fieldGet an entity type field by ID, including its enum options.
Get entity workflow rule
Tool name:
get_entity_workflow_ruleGet a workflow rule.
Get external entity schema
Tool name:
get_external_entity_schemaGet the external schema discovered from the most recent sync of an ingestion config.
Get folder
Tool name:
get_folderGet a single folder by ID.
Get form
Tool name:
get_formGet a specific form by ID, including the module source of the version currently shown in the builder (the latest draft, or the published version when there is no newer draft).
Get group
Tool name:
get_groupGet a specific group by ID.
Get guidance
Tool name:
get_guidanceGet a specific guidance by ID.
Get help agent form
Tool name:
get_help_agent_formFetch a form the help-desk agent opened on a conversation, so it can be rendered and answered.
Get help agent simulation
Tool name:
get_help_agent_simulationGet the status or result of a help-agent simulation.
Get help agent simulation config
Tool name:
get_help_agent_simulation_configGet a saved help-agent simulation config including its scenario.
Get help agent simulation run
Tool name:
get_help_agent_simulation_runInspect a recorded simulation run by its run UUID, including status, transcript and judge results.
Get help agent simulation suite
Tool name:
get_help_agent_simulation_suiteGet a saved help-agent simulation suite, including its ordered member config ids.
Get help agent simulation suite run
Tool name:
get_help_agent_simulation_suite_runInspect a recorded simulation suite run by its suite-run UUID.
Get journey
Tool name:
get_journeyFetch a single journey snapshot with tasks, health checks, and workflow failures.
Get knowledge base
Tool name:
get_knowledge_baseGet a knowledge base by ID.
Get knowledge document
Tool name:
get_knowledge_documentGet a knowledge document, including its body rendered as Markdown/plain text.
Get priority
Tool name:
get_priorityGet a priority by ID.
Get review
Tool name:
get_reviewRead a review's source, apply state, and current approval requirement.
Get review item
Tool name:
get_review_itemRead secret-scrubbed before and after documents using the review UI's comparison baseline.
Get schema migration
Tool name:
get_schema_migrationGet a schema migration by ID, including its current status (PENDING, IN_PROGRESS, APPLIED, COMPLETED, FAILED, or CANCELLED).
Get sla definition
Tool name:
get_sla_definitionRetrieve a single SLA definition by ID, including its conditions, attachment criteria, and action definitions.
Get sla statistics
Tool name:
get_sla_statisticsGet aggregate SLA compliance statistics for a team — the same numbers the native Analytics -> SLA page shows: met/breached/active counts, compliance rate, and completion-time percentiles.
Get sla timeseries
Tool name:
get_sla_timeseriesGet a per-day SLA outcome timeseries for a team — met, breached, and active-on-track counts bucketed by day over the window.
Get status
Tool name:
get_statusGet a ticket status by ID.
Get tag
Tool name:
get_tagGet a specific tag by ID.
Get team
Tool name:
get_teamGet a specific team by ID.
Get team assignment settings
Tool name:
get_team_assignment_settingsRetrieve the Settings tab of the team's Assignment page: the assignment preferences (default member assignment, restriction to team members, custom escalation workflow) and the assignment groups with…
Get team group
Tool name:
get_team_groupGet a specific team group binding by team ID and group ID, or by composite ID.
Get team user
Tool name:
get_team_userGet a specific team user by team ID and user ID, or by composite ID.
Get ticket
Tool name:
get_ticketGet a specific ticket by ID.
Get ticket custom field values
Tool name:
get_ticket_custom_field_valuesGet the custom field values that have been explicitly set on a ticket.
Get ticket model definition
Tool name:
get_ticket_model_definitionGet a ticket model's full definition.
Get ticket relationship
Tool name:
get_ticket_relationshipGet a ticket relationship by its ID.
Get ticket snapshot
Tool name:
get_ticket_snapshotGet an internal troubleshooting snapshot for a ticket.
Get ticket statistics
Tool name:
get_ticket_statisticsGet a team's lifetime ticket activity — the same 'All time' numbers the native Analytics landing shows: AI-resolved tickets, AI-assisted tickets, total ticket-attached workflow runs, and median time…
Get ticket timeseries
Tool name:
get_ticket_timeseriesGet a team's per-ticket time series over a window — creation and resolution timestamps and responded-feedback sentiment counts — the raw rows the native Analytics landing's requests, time-to-resolve,…
Get user
Tool name:
get_userGet a specific user by ID.
Get user custom fields schema
Tool name:
get_user_custom_fields_schemaGet the organization's user custom fields schema — the custom attributes carried on every user (department, manager, etc.) beyond id/email, with each field's key, type, and valid ENUM/MULTI_SELECT…
Get user relationship
Tool name:
get_user_relationshipGet a user's relationship of the given type (e.g. their manager).
Get widget
Tool name:
get_widgetRetrieve a single widget by ID, with its type and the matching config.
Get workflow
Tool name:
get_workflowGet a specific workflow by ID.
Get workflow approval procedure
Tool name:
get_workflow_approval_procedureGet a specific approval procedure by ID for a workflow.
Get workflow run
Tool name:
get_workflow_runGet a specific workflow run by ID.
Get workflow run task
Tool name:
get_workflow_run_taskGet the full (size-capped) input and output for a single task (step) of a workflow run.
Install change models
Tool name:
install_change_modelsInstall ITIL change models for the team.
Install schema template
Tool name:
install_schema_templateInstall Schema Template [Scope: team]
Link tickets
Tool name:
link_ticketsLink two tickets together with a linked relationship.
List access policies
Tool name:
list_access_policiesList all access policies for a team.
List access policy approval procedures
Tool name:
list_access_policy_approval_proceduresList all approval procedures for an access policy.
List access profile grants
Tool name:
list_access_profile_grantsList access profile grants for a team, optionally filtered by access profile, resource type, or resource.
List access profiles
Tool name:
list_access_profilesList all access profiles for a team.
List access relationships
Tool name:
list_access_relationshipsList access relationships for a subject (app instance, resource, role, or team).
List access requests
Tool name:
list_access_requestsList access requests for a team.
List agent sessions
Tool name:
list_agent_sessionsList the sessions (executions) produced by an agent, most recent first.
List agents
Tool name:
list_agentsList agents for a team.
List app instance integrations
Tool name:
list_app_instance_integrationsList integrations for an app instance.
List app instance labels
Tool name:
list_app_instance_labelsDEPRECATED: use the Tag API.
List app instances
Tool name:
list_app_instancesList app instances owned by the team along with those shared with it.
List app relationships
Tool name:
list_app_relationshipsDEPRECATED: use ListAccessRelationships.
List app resource roles
Tool name:
list_app_resource_rolesList all app resource roles for a team, optionally filtered by resource.
List app resources
Tool name:
list_app_resourcesList all app resources for a team, optionally filtered by app instance.
List approval delegations
Tool name:
list_approval_delegationsList approval delegation rules.
List approval procedures
Tool name:
list_approval_proceduresList a team's approval procedures.
List approval request steps
Tool name:
list_approval_request_stepsList all steps for an approval request, including approver resolutions.
List approval requests
Tool name:
list_approval_requestsList all approval requests for a team.
List assignment rules
Tool name:
list_assignment_rulesList a team's assignment rules in precedence order, lowest display_order first.
List audit logs
Tool name:
list_audit_logsList your organization's audit log events from the last 90 days, newest first.
List category options
Tool name:
list_category_optionsList categories (including nested subcategories) for a team.
List change blackout schedules
Tool name:
list_change_blackout_schedulesList the team's change-blackout schedules.
List change schedule conflicts
Tool name:
list_change_schedule_conflictsRead what's scheduled during a window and what each change collides with (CAB prep, blast-radius, find-a-window).
List connected channels
Tool name:
list_connected_channelsList existing Slack and Microsoft Teams channel connections, including disabled channels.
List custom field options
Tool name:
list_custom_field_optionsList the available custom field definitions for a team and ticket type.
List custom roles
Tool name:
list_custom_rolesList a team's custom roles.
List custom services
Tool name:
list_custom_servicesList all custom services for a team.
List database issue evidence
Tool name:
list_database_issue_evidenceList the occurrences grouped into one issue, such as each failed workflow run or rejected item, newest first.
List database issues
Tool name:
list_database_issuesList a table's open issues, most recently observed first: synced items a rule rejected or that failed to publish, sync and schema-migration failures, and workflow rule runs or held changes that did…
List database rules
Tool name:
list_database_rulesList a table's workflow and validation rules.
List document templates
Tool name:
list_document_templatesList the team's document-signing templates with the recipient roles, variables (tokens), and fillable fields a signature input references.
List email intake configs
Tool name:
list_email_intake_configsList the email addresses a team receives tickets through.
List entities
Tool name:
list_entitiesList entities for a team.
List entity field mappings
Tool name:
list_entity_field_mappingsList the field mappings for an entity type, optionally narrowed to a single ingestion config's source.
List entity field value history
Tool name:
list_entity_field_value_historyList the change history for an entity's field values.
List entity ingestion configs
Tool name:
list_entity_ingestion_configsList entity ingestion configs for a team, optionally filtered by app instance.
List entity ingestion runs
Tool name:
list_entity_ingestion_runsList the ingestion runs for an entity ingestion config, most-recent-first, including status, per-item counts, and any failure.
List entity pending changes
Tool name:
list_entity_pending_changesList changes to a table that before-workflow rules are holding until their workflows decide, with each run's state.
List entity schemas
Tool name:
list_entity_schemasList Entity Schemas [Scope: team]
List entity types
Tool name:
list_entity_typesList all entity types for a team.
List entity workflow rules
Tool name:
list_entity_workflow_rulesList workflow rules for an entity type.
List folder contents
Tool name:
list_folder_contentsList the direct items in a folder.
List folders
Tool name:
list_foldersList a team's folders of a given item_type as a flat list (use parent_folder_id to reconstruct the tree).
List forms
Tool name:
list_formsList a team's forms.
List groups
Tool name:
list_groupsList groups.
List guidance versions
Tool name:
list_guidance_versionsList the version history of a guidance (Help Desk Skill).
List guidances
Tool name:
list_guidancesList all guidances for a team.
List help agent simulation configs
Tool name:
list_help_agent_simulation_configsList the team's saved help-agent simulation configs (without scenarios).
List help agent simulation runs
Tool name:
list_help_agent_simulation_runsList standalone simulation run history.
List help agent simulation suite runs
Tool name:
list_help_agent_simulation_suite_runsList recorded simulation suite runs, optionally filtered by suite_id.
List help agent simulation suites
Tool name:
list_help_agent_simulation_suitesList the team's saved help-agent simulation suites (without membership).
List journeys
Tool name:
list_journeysList lean journey rows for a team.
List knowledge bases
Tool name:
list_knowledge_basesList the knowledge bases for a team.
List knowledge documents
Tool name:
list_knowledge_documentsList the documents in a knowledge base.
List labels
Tool name:
list_labelsList labels for a team.
List priorities
Tool name:
list_prioritiesList priorities for a team.
List reclamation candidates
Tool name:
list_reclamation_candidatesList a team's reclamation-candidate reclamations — entitlement grants flagged for review or reclaim because the user stopped signing in.
List reports
Tool name:
list_reportsList reports for a team.
List requestable roles
Tool name:
list_requestable_rolesList roles that are available for requesting access.
List resources for app instance
Tool name:
list_resources_for_app_instanceList Resources For App Instance [Scope: team]
List review items
Tool name:
list_review_itemsList review item metadata using page_size and page_token.
List reviews
Tool name:
list_reviewsList a team's session reviews and incoming promotions, or use outgoing=true for promotions from that team.
List schedules
Tool name:
list_schedulesList a team's recurring schedules.
List schema migrations
Tool name:
list_schema_migrationsList the schema migration history for an entity type, newest first.
List schema templates
Tool name:
list_schema_templatesList Schema Templates [Scope: team]
List sla definitions
Tool name:
list_sla_definitionsList all SLA definitions for a team.
List statuses
Tool name:
list_statusesList statuses for a team.
List subject tags
Tool name:
list_subject_tagsList the tags attached to a subject.
List tags
Tool name:
list_tagsList all tags for a team.
List team access policy approval procedures
Tool name:
list_team_access_policy_approval_proceduresList all access policy approval procedures for a team.
List team groups
Tool name:
list_team_groupsList team group bindings.
List team users
Tool name:
list_team_usersList team users.
List team workflow approval procedures
Tool name:
list_team_workflow_approval_proceduresList all workflow approval procedures for a team.
List teams
Tool name:
list_teamsList all teams.
List ticket assignment groups
Tool name:
list_ticket_assignment_groupsList the groups tickets on this team can be routed to.
List ticket external messages
Tool name:
list_ticket_external_messagesList all origin external messages for a ticket.
List ticket external tickets
Tool name:
list_ticket_external_ticketsList all external tickets linked to a Serval ticket.
List ticket feedback
Tool name:
list_ticket_feedbackList feedback items across tickets for a team.
List ticket messages
Tool name:
list_ticket_messagesList messages for a ticket.
List ticket model transitions
Tool name:
list_ticket_model_transitionsList all ticket model transitions for the team.
List ticket models
Tool name:
list_ticket_modelsList the team's ticket models across all ticket types (journey, request, incident, ...).
List ticket relevant assets
Tool name:
list_ticket_relevant_assetsList all relevant assets associated with a ticket.
List ticket sla instances
Tool name:
list_ticket_sla_instancesList a team's SLA instances — one per SLA attachment to a ticket, carrying its definition ID, lifecycle state, clock timestamps, and progress snapshots.
List ticket subscribers
Tool name:
list_ticket_subscribersList all subscribers for a ticket.
List tickets
Tool name:
list_ticketsList tickets for a team.
List topics
Tool name:
list_topicsList the AI-generated topic taxonomy for a team.
List user phone numbers
Tool name:
list_user_phone_numbersList current phone assignments and their login trust.
List user relationships
Tool name:
list_user_relationshipsList user relationships.
List users
Tool name:
list_usersList all users.
List worker egress failures
Tool name:
list_worker_egress_failuresList connections the team's worker replicas could not open while running workflows, aggregated per replica, app instance, and cause (dns, timeout, refused, tls_untrusted, tls_hostname, tls_handshake,…
List worker replicas
Tool name:
list_worker_replicasList the team's worker replicas (worker processes, Serval-managed and self-hosted) that reported recently: hosting, chart version, image tags, queues, the config generation each was installed with,…
List workers
Tool name:
list_workersList the team's self-hosted (hybrid) workers — customer-run workers that serve app instances with route_direct_from_worker — with each worker's name, creation time, last connection to Serval, and…
List workflow approval procedures
Tool name:
list_workflow_approval_proceduresList all approval procedures for a workflow.
List workflow run tasks
Tool name:
list_workflow_run_tasksList the tasks (steps) of a workflow run, ordered by step, with truncated input/output previews and a resolved outcome per step.
List workflow runs
Tool name:
list_workflow_runsList all workflow runs for a team, ordered by created_at desc.
List workflow versions
Tool name:
list_workflow_versionsList the version history of a workflow.
List workflows
Tool name:
list_workflowsList all workflows for a team.
Move knowledge document
Tool name:
move_knowledge_documentRe-parent a knowledge document within its knowledge base, or move it to the top level.
Move ticket to team
Tool name:
move_ticket_to_teamMove a ticket to a different team.
Notify user
Tool name:
notify_userSend an agent-run notification to a recipient the agent resolved in-session.
Preview schema template install
Tool name:
preview_schema_template_installPreview Schema Template Install [Scope: team]
Promote incident to major incident
Tool name:
promote_incident_to_major_incidentPromote an incident in place to a major incident, recording the optional reason on the ticket's activity log and carrying existing custom-field values onto the major-incident field set.
Publish knowledge document
Tool name:
publish_knowledge_documentPublish a knowledge document so it becomes agent-retrievable (kicks off indexing).
Put entity workflow rule
Tool name:
put_entity_workflow_ruleConfigure a workflow rule for entity changes.
Query change tickets
Tool name:
query_change_ticketsRead the team's change tickets for fleet-level analysis.
Reactivate user
Tool name:
reactivate_userReactivate a previously deactivated user, restoring their organization membership.
Reclaim reclamation candidate
Tool name:
reclaim_reclamation_candidateReclaim an in-review reclamation candidate: conclude its review as reclaimed and start deprovisioning the grant.
Reclassify ticket
Tool name:
reclassify_ticketReclassify a ticket in place between request and incident, recording the optional reason on the ticket's activity log.
Remove label from app instance
Tool name:
remove_label_from_app_instanceDEPRECATED: use RemoveTagFromSubject.
Remove tag from subject
Tool name:
remove_tag_from_subjectDetach a tag from a subject.
Remove ticket assignment group
Tool name:
remove_ticket_assignment_groupRemove a group from the team's configured assignment groups.
Remove ticket relevant asset
Tool name:
remove_ticket_relevant_assetRemove a relevant asset from a ticket.
Reorder assignment rules
Tool name:
reorder_assignment_rulesSet the order of a team's assignment rules.
Replay entity workflow
Tool name:
replay_entity_workflowRun an after-workflow rule's workflow again, with the change's captured values, for an execution that failed, was held, or was canceled.
Resolve scoped refs
Tool name:
resolve_scoped_refsResolve team-scoped ids (wf_/skill_/ent_/form_) to their resource UUID, display name, and kind within a team.
Reveal entity field value
Tool name:
reveal_entity_field_valueReveal the value of a sensitive field on one entity.
Revoke access request
Tool name:
revoke_access_requestRevokes an active access request, ending the user's access early.
Search access memberships
Tool name:
search_access_membershipsList a user’s recorded Access Management role memberships within one team, matching the role Users rosters.
Search access requests
Tool name:
search_access_requestsSearch access requests with filters.
Search app resource roles
Tool name:
search_app_resource_rolesSearch app resource roles by role or parent-resource text, optionally filtered by team, app instance, or resource IDs.
Search app resources
Tool name:
search_app_resourcesSearch app resources with filters in the request body.
Search approval requests
Tool name:
search_approval_requestsSearch approval requests with filters such as resource type, result status, and date range.
Search custom service endpoints
Tool name:
search_custom_service_endpointsFind endpoints in an OpenAPI spec the team uploaded for one of its custom HTTP apps.
Search entities
Tool name:
search_entitiesSearch entities with advanced filtering, sorting, and pagination.
Search entity types
Tool name:
search_entity_typesSearch for entity types by key or other filters.
Search groups
Tool name:
search_groupsFind groups by name.
Search knowledge
Tool name:
search_knowledgeSearch the team's knowledge corpus.
Search ticket messages
Tool name:
search_ticket_messagesSearch messages across tickets with filters for team, ticket, author, author role, and creation time range.
Search tickets
Tool name:
search_ticketsSearch tickets with filters.
Search users
Tool name:
search_usersSearch the organization's user directory with structured filters over built-in user fields AND user custom fields in one query — the same search that powers the Users database UI.
Search workflow runs
Tool name:
search_workflow_runsSearch workflow runs with filters.
Send help agent message
Tool name:
send_help_agent_messageSend a message to a team's help desk agent and wait for its reply.
Set assignment rules fallback
Tool name:
set_assignment_rules_fallbackReplace the fallback, shown in the app as All other tickets: who is assigned a ticket that no assignment rule matches.
Set connected channel mode
Tool name:
set_connected_channel_modeSet the mode of an existing channel connection.
Set folder item location
Tool name:
set_folder_item_locationSet the folder location for a folder item, or move it to the root by leaving folder_id unset.
Set ticket custom field values
Tool name:
set_ticket_custom_field_valuesSet custom field values on a ticket.
Set ticket model field hidden
Tool name:
set_ticket_model_field_hiddenSet a ticket model custom field's default-hidden state.
Set ticket model lifecycle
Tool name:
set_ticket_model_lifecycleSet a ticket model's lifecycle statuses.
Set ticket model transition
Tool name:
set_ticket_model_transitionSet a transition's auto-fire flag and/or its field-value preconditions.
Set ticket model transition precondition
Tool name:
set_ticket_model_transition_preconditionSet or clear a transition's precondition.
Set user phone login trust
Tool name:
set_user_phone_login_trustExplicitly grant or revoke magic-link login trust for the current phone assignment.
Start help agent simulation
Tool name:
start_help_agent_simulationRun a published simulation config.
Start help agent simulation suite
Tool name:
start_help_agent_simulation_suiteRun a published simulation suite.
Start workflow run
Tool name:
start_workflow_runStart a workflow asynchronously.
Submit help agent form
Tool name:
submit_help_agent_formSubmit values for a form the help-desk agent opened.
Submit ticket feedback
Tool name:
submit_ticket_feedbackSubmit a user's feedback (CSAT) on a ticket.
Sync entity ingestion config
Tool name:
sync_entity_ingestion_configTrigger a sync for an entity ingestion config.
Sync ticket to channel
Tool name:
sync_ticket_to_channelSync an existing Serval ticket to a channel by creating an external ticket in that channel and establishing ongoing bidirectional sync.
Trigger agent session
Tool name:
trigger_agent_sessionTrigger a manual run of an agent, outside its cron schedule.
Unarchive entity
Tool name:
unarchive_entityRestore an archived entity to active browse.
Unarchive ticket
Tool name:
unarchive_ticketRestore a ticket from cold storage.
Unpublish knowledge document
Tool name:
unpublish_knowledge_documentUnpublish a knowledge document so it is no longer agent-retrievable.
Update access policy
Tool name:
update_access_policyUpdate an existing access policy.
Update access policy approval procedure
Tool name:
update_access_policy_approval_procedureUpdate an existing approval procedure for an access policy.
Update access profile
Tool name:
update_access_profileUpdate an existing access profile.
Update access relationship
Tool name:
update_access_relationshipUpdate an access relationship.
Update agent
Tool name:
update_agentUpdate an agent.
Update app instance
Tool name:
update_app_instanceUpdate an existing app instance.
Update app instance label
Tool name:
update_app_instance_labelDEPRECATED: use the Tag API.
Update app relationship
Tool name:
update_app_relationshipDEPRECATED: use UpdateAccessRelationship.
Update app resource
Tool name:
update_app_resourceUpdate an existing app resource.
Update app resource role
Tool name:
update_app_resource_roleUpdate an existing app resource role.
Update approval delegation
Tool name:
update_approval_delegationUpdate an existing approval delegation rule.
Update approval procedure
Tool name:
update_approval_procedureReplace an approval procedure's name, description, timeout, and steps.
Update assignment rule
Tool name:
update_assignment_ruleReplace an assignment rule's conditions and actions.
Update category option
Tool name:
update_category_optionUpdate a category's name, description, or parent.
Update change blackout schedule
Tool name:
update_change_blackout_scheduleUpdate a one-off change-blackout schedule's description or window.
Update custom role
Tool name:
update_custom_roleUpdate a custom role's name, description, base role, and granted actions.
Update custom service
Tool name:
update_custom_serviceUpdate an existing custom service.
Update database rule
Tool name:
update_database_ruleUpdate a table rule.
Update entity
Tool name:
update_entityUpdate an existing entity.
Update entity field mapping
Tool name:
update_entity_field_mappingUpdate a field mapping's external field path and/or precedence.
Update entity ingestion config
Tool name:
update_entity_ingestion_configUpdate an entity ingestion config.
Update entity type
Tool name:
update_entity_typeUpdate an entity type's name, color, icon, or help-agent visibility.
Update entity type field
Tool name:
update_entity_type_fieldUpdate an entity type field: rename it (set name) and/or change its data type (set data_type, plus enum_options when the new type is ENUM/MULTI_SELECT).
Update folder
Tool name:
update_folderRename and/or move a folder.
Update form
Tool name:
update_formUpdate a form's draft.
Update group
Tool name:
update_groupUpdate an existing group.
Update guidance
Tool name:
update_guidanceUpdate an existing guidance.
Update help agent simulation config
Tool name:
update_help_agent_simulation_configUpdate a simulation config's name/description, or replace its scenario (which creates a new revision).
Update knowledge base
Tool name:
update_knowledge_baseUpdate a knowledge base.
Update knowledge document
Tool name:
update_knowledge_documentUpdate a knowledge document's title, content (Markdown), icon, or color.
Update label
Tool name:
update_labelUpdate a ticket label's name, description, color, or whether the help-desk agent may apply it.
Update priority
Tool name:
update_priorityUpdate a priority's display name, description, or AI selectability.
Update sla definition
Tool name:
update_sla_definitionUpdate an SLA definition.
Update status
Tool name:
update_statusUpdate a ticket status.
Update tag
Tool name:
update_tagUpdate an existing tag.
Update team
Tool name:
update_teamUpdate an existing team.
Update team assignment settings
Tool name:
update_team_assignment_settingsChange the team's assignment preferences.
Update team group
Tool name:
update_team_groupUpdate the role a group holds on a team.
Update team user
Tool name:
update_team_userUpdate a team user's role.
Update ticket
Tool name:
update_ticketUpdate an existing ticket.
Update ticket assignment group
Tool name:
update_ticket_assignment_groupSet an assignment group's work schedule or member assignment.
Update user
Tool name:
update_userUpdate an existing user.
Update workflow
Tool name:
update_workflowUpdate an existing workflow.
Update workflow approval procedure
Tool name:
update_workflow_approval_procedureUpdate an existing approval procedure for a workflow.
Upsert ticket model
Tool name:
upsert_ticket_modelCreate or update a ticket model.
Upsert ticket model status entry action
Tool name:
upsert_ticket_model_status_entry_actionWire a workflow to fire on status entry.
Wait for help agent messages
Tool name:
wait_for_help_agent_messagesFollow a conversation for whatever the help-desk agent says next.
Compatibility
Connect Serval to the clients your teams already use
27 AI clients can connect to Serval through Runlayer. Pick one for its setup steps and controls.
Why Runlayer
Why connect Serval through Runlayer?
One approved path
Approve Serval once and everyone gets it in the AI clients they already use. Runlayer holds the credentials, so nothing sits in client configuration.
Fine-grained policy
Control who can use each server, tool, and resource, and under which runtime conditions.
Runtime security
Scan tool inputs and outputs for prompt injection, credential exposure, PII, and data exfiltration, then alert, mask, or block.
Audit and observability
Trace every request across users, clients, tools, policies, scanner decisions, and downstream systems.