Skip to main content

Freshservice

Integração com a API do Freshservice, plataforma de ITSM da Freshworks.

Freshservice Logo

Authentication​

This connector uses Token-based authentication.

info

Set up your connection in the Abstra Console before using it in your workflows.

How to use​

Using the Smart Chat​

Execute the action "CHOOSE_ONE_ACTION_BELOW" from my connector "YOUR_CONNECTOR_NAME" using the params "PARAMS_HERE".

Using the Web Editor​

from abstra.connectors import run_connection_action

result = run_connection_action(
connection_name="your_connection_name",
action_name="your_action_name",
params={
"param1": "value1",
"param2": "value2"
})

Available Actions​

This connector provides 483 actions:

ActionPurposeParameters
agent_groups/post_groupsCreate a new agent groupdata: {
. name (string)
. description (string)
. escalate_to (integer)
. unassigned_for (string)
. business_hours_id (integer)
. members (array)
. observers (array)
. leaders (array)
. restricted (boolean)
. approval_required (boolean)
. ocs_schedule_id (integer)
. workspace_id (integer)
. agent_ids (array)
} (object) required
agent_groups/get_groupsList all agent groupspage (integer)
per_page (integer)
workspace_id (integer)
agent_groups/get_groups_by_idView an agent group by idid (integer) required
agent_groups/put_groups_by_idUpdate an agent groupid (integer) required
data: {
. name (string)
. description (string)
. escalate_to (integer)
. unassigned_for (string)
. business_hours_id (integer)
. members (array)
. observers (array)
. leaders (array)
. restricted (boolean)
. approval_required (boolean)
. ocs_schedule_id (integer)
. workspace_id (integer)
. agent_ids (array)
} (object) required
agent_groups/delete_groups_by_idDelete an agent groupid (integer) required
agent_roles/get_rolesList all agent rolespage (integer)
per_page (integer)
workspace_id (integer)
agent_roles/get_roles_by_idView a role by idid (integer) required
agents/post_agentsCreate a new agentdata: {
. first_name (string)
. last_name (string)
. occasional (boolean)
. email (string)
. job_title (string)
. work_phone_number (string)
. mobile_phone_number (string)
. department_ids (array)
. can_see_all_tickets_from_associated_departments (boolean)
. reporting_manager_id (integer)
. address (string)
. time_zone (string)
. time_format (string)
. language (string)
. location_id (integer)
. background_information (string)
. scoreboard_level_id (integer)
. roles (array)
. member_of (array)
. observer_of (array)
. signature (string)
. workspace_ids (array)
. external_id (string)
. custom_fields (object)
} (object) required
agents/get_agentsList or filter agentsemail (string)
mobile (string)
phone (string)
state (string)
active (boolean)
include (string)
query (string)
page (integer)
per_page (integer)
agents/get_agents_by_idView an agent by idid (integer) required
include (string)
agents/put_agents_by_idUpdate an agentid (integer) required
data: {
. first_name (string)
. last_name (string)
. occasional (boolean)
. email (string)
. job_title (string)
. work_phone_number (string)
. mobile_phone_number (string)
. department_ids (array)
. can_see_all_tickets_from_associated_departments (boolean)
. reporting_manager_id (integer)
. address (string)
. time_zone (string)
. time_format (string)
. language (string)
. location_id (integer)
. background_information (string)
. scoreboard_level_id (integer)
. roles (array)
. member_of (array)
. observer_of (array)
. signature (string)
. workspace_ids (array)
. external_id (string)
. custom_fields (object)
} (object) required
agents/delete_agents_by_idDeactivate an agentid (integer) required
agents/delete_agents_by_id_forgetPermanently delete an agent GDPR forgetid (integer) required
agents/put_agents_by_id_reactivateReactivate a deactivated agentid (integer) required
agents/put_agents_by_id_convert_to_requesterConvert an agent into a requester contactid (integer) required
agents/get_agents_fieldsList all agent fieldspage (integer)
per_page (integer)
alerts/get_alertsView multiple alerts using filterspage (integer)
per_page (integer)
query (string)
state (string)
severity (string)
alerts/get_alerts_by_idView a single alertid (string) required
alerts/delete_alerts_by_idDelete an alertid (string) required
alerts/get_alerts_by_id_logsView all alert logs for a given alertid (string) required
page (integer)
per_page (integer)
alerts/put_alerts_by_id_acknowledgeAcknowledge an alertid (string) required
data: {
. note (string)
} (object) required
alerts/put_alerts_by_id_resolveResolve an alertid (string) required
data: {
. note (string)
} (object) required
alerts/put_alerts_by_id_suppressSuppress an alertid (string) required
data: {
. note (string)
. suppress_until (string)
} (object) required
alerts/put_alerts_by_id_unsuppressUnsuppress an alertid (string) required
alerts/get_alerts_by_id_notesList all notes for an alertid (string) required
alerts/post_alerts_by_id_notesCreate a note on an alertid (string) required
data: {
. body (string)
} (object) required
alerts/get_alerts_by_id_notes_by_note_idView a note on an alertid (string) required
note_id (integer) required
alerts/put_alerts_by_id_notes_by_note_idUpdate a note on an alertid (string) required
note_id (integer) required
data: {
. body (string)
} (object) required
alerts/delete_alerts_by_id_notes_by_note_idDelete a note on an alertid (string) required
note_id (integer) required
announcements/post_announcementsCreate an announcementdata: {
. title (string)
. body (string)
. visible_from (string)
. visible_till (string)
. additional_emails (array)
. visibility (string)
} (object) required
announcements/get_announcementsList all announcementspage (integer)
per_page (integer)
announcements/get_announcements_by_idView an announcementid (integer) required
announcements/put_announcements_by_idEdit an announcementid (integer) required
data: {
. title (string)
. body (string)
. visible_from (string)
. visible_till (string)
} (object) required
announcements/delete_announcements_by_idDelete an announcementid (integer) required
approvals/get_approvalsList all approvalspage (integer)
per_page (integer)
workspace_id (integer)
approvals/get_tickets_by_ticket_id_approvalsList all approvals for a ticketticket_id (integer) required
page (integer)
per_page (integer)
approvals/post_tickets_by_ticket_id_approvalsRequest an approval for a service request ticketticket_id (integer) required
data: {
. approver_id (integer)
. approval_type (integer)
. email (string)
} (object) required
approvals/get_tickets_by_ticket_id_approvals_by_approval_idView an approval for a ticketticket_id (integer) required
approval_id (integer) required
approvals/delete_tickets_by_ticket_id_approvals_by_approval_idCancel an approval on a ticketticket_id (integer) required
approval_id (integer) required
approvals/post_tickets_by_ticket_id_approvals_by_approval_id_remindSend a reminder for a ticket approvalticket_id (integer) required
approval_id (integer) required
approvals/get_tickets_by_ticket_id_approval_groupsList all approval groups on a ticketticket_id (integer) required
page (integer)
per_page (integer)
approvals/post_tickets_by_ticket_id_approval_groupsCreate an approval group on a ticketticket_id (integer) required
data: {
. approvers (array)
. approval_type (integer)
. approval_percentage (integer)
} (object) required
approvals/put_tickets_by_ticket_id_approval_groups_by_group_idUpdate an approval group on a ticketticket_id (integer) required
group_id (integer) required
data: {
. approvers (array)
. approval_type (integer)
. approval_percentage (integer)
} (object) required
approvals/delete_tickets_by_ticket_id_approval_groups_by_group_idCancel an approval group on a ticketticket_id (integer) required
group_id (integer) required
approvals/put_tickets_by_ticket_id_approval_chain_rulesUpdate the approval chain rule for a ticketticket_id (integer) required
data: {
. chain_type (integer)
. chain_rule (string)
. parallel (boolean)
} (object) required
approvals/get_changes_by_change_id_approvalsList all approvals for a changechange_id (integer) required
page (integer)
per_page (integer)
approvals/get_changes_by_change_id_approvals_by_approval_idView an approval for a changechange_id (integer) required
approval_id (integer) required
approvals/delete_changes_by_change_id_approvals_by_approval_idCancel an approval on a changechange_id (integer) required
approval_id (integer) required
approvals/post_changes_by_change_id_approvals_by_approval_id_send_reminderSend a reminder for a change approvalchange_id (integer) required
approval_id (integer) required
approvals/get_changes_by_change_id_approval_groupsList all approval groups on a changechange_id (integer) required
page (integer)
per_page (integer)
approvals/post_changes_by_change_id_approval_groupsCreate an approval group on a changechange_id (integer) required
data: {
. approvers (array)
. approval_type (integer)
. approval_percentage (integer)
} (object) required
approvals/put_changes_by_change_id_approval_groups_by_group_idUpdate an approval group on a changechange_id (integer) required
group_id (integer) required
data: {
. approvers (array)
. approval_type (integer)
. approval_percentage (integer)
} (object) required
approvals/delete_changes_by_change_id_approval_groups_by_group_idCancel an approval group on a changechange_id (integer) required
group_id (integer) required
approvals/put_changes_by_change_id_approval_chain_ruleUpdate the approval chain rule for a changechange_id (integer) required
data: {
. chain_type (integer)
. chain_rule (string)
. parallel (boolean)
} (object) required
asset_types/get_asset_typesList all asset typespage (integer)
per_page (integer)
asset_types/post_asset_typesCreate an asset typedata: {
. name (string)
. description (string)
. parent_asset_type_id (integer)
. workspace_id (integer)
} (object) required
asset_types/get_asset_types_by_idView a single asset typeid (integer) required
asset_types/put_asset_types_by_idUpdate an asset typeid (integer) required
data: {
. name (string)
. description (string)
. parent_asset_type_id (integer)
} (object) required
asset_types/delete_asset_types_by_idDelete an asset typeid (integer) required
asset_types/get_asset_types_by_id_fieldsList all fields for a given asset typeid (integer) required
assets/get_assetsList all assetspage (integer)
per_page (integer)
include (string)
workspace_id (integer)
filter (string)
assets/post_assetsCreate a new assetdata: {
. name (string)
. description (string)
. asset_type_id (integer)
. asset_tag (string)
. impact (string)
. usage_type (string)
. user_id (integer)
. department_id (integer)
. location_id (integer)
. agent_id (integer)
. group_id (integer)
. assigned_on (string)
. workspace_id (integer)
. type_fields (object)
} (object) required
assets/get_assets_by_idView a single assetid (integer) required
include (string)
assets/put_assets_by_idUpdate an assetid (integer) required
data: {
. name (string)
. description (string)
. asset_type_id (integer)
. asset_tag (string)
. impact (string)
. usage_type (string)
. user_id (integer)
. department_id (integer)
. location_id (integer)
. agent_id (integer)
. group_id (integer)
. assigned_on (string)
. type_fields (object)
} (object) required
assets/delete_assets_by_idDelete an asset move to trashid (integer) required
assets/put_assets_by_id_restoreRestore an asset from trashid (integer) required
assets/delete_assets_by_id_delete_foreverPermanently delete an assetid (integer) required
assets/put_assets_by_id_move_workspaceMove an asset to another workspaceid (integer) required
data: {
. workspace_id (integer)
} (object) required
assets/get_assets_by_id_componentsList all components of an assetid (integer) required
assets/post_assets_by_id_componentsCreate a component for an assetid (integer) required
data: {
. component_type (string)
. component_data (object)
} (object) required
assets/put_assets_by_id_components_by_component_idUpdate a component of an assetid (integer) required
component_id (integer) required
data: {
. component_type (string)
. component_data (object)
} (object) required
assets/get_assets_by_id_contractsList all associated contracts of an assetid (integer) required
assets/get_assets_by_id_requestsList all associated tickets/requests for an assetid (integer) required
assets/get_assets_by_id_relationshipsList all relationships for a specific assetid (integer) required
page (integer)
per_page (integer)
assets/get_assets_relationshipsList all relationships across all assetspage (integer)
per_page (integer)
assets/post_assets_relationshipsCreate asset relationships in bulkdata: {
. relationships (array)
} (object) required
assets/delete_assets_relationshipsDelete asset relationships in bulkdata: {
. relationship_ids (array)
} (object) required
assets/get_assets_relationships_by_idView a relationshipid (integer) required
assets/get_assets_relationship_typesList all relationship typesNo parameters
assets_itam/get_assetsList all ITAM assetspage (integer)
per_page (integer)
workspace_id (integer)
assets_itam/get_assets_by_asset_idView a single ITAM assetasset_id (integer) required
assets_itam/put_assets_by_asset_idUpdate an ITAM assetasset_id (integer) required
data: {
. name (string)
. description (string)
. asset_type_id (integer)
. asset_tag (string)
. impact (string)
. usage_type (string)
. user_id (integer)
. department_id (integer)
. location_id (integer)
. agent_id (integer)
. group_id (integer)
. custom_fields (object)
} (object) required
assets_itam/delete_assets_by_asset_idDelete an ITAM assetasset_id (integer) required
assets_itam/put_assets_by_asset_id_custom_fieldsUpdate custom fields for an ITAM assetasset_id (integer) required
data: {
. custom_fields (object)
} (object) required
attachments/get_attachments_by_attachment_idRetrieve / Download an Attachmentattachment_id (integer) required
attachments/get_attachments_downloadDownload Purchase Order and Contracts Attachmentid (integer) required
type (string)
attachments/post_ticketsCreate a ticket including attachments. Total attachment size must not exceed 40 MB. Content-Type must be multipart/form-data; non-file fields must also be sent as form-data.data: {
. subject (string)
. description (string)
. email (string)
. priority (integer)
. status (integer)
. attachments (array)
} (object) required
attachments/put_tickets_by_idUpdate a ticket including new attachments. Total size limit 40 MB. Must use multipart/form-data.id (integer) required
data: {
. subject (string)
. description (string)
. email (string)
. priority (integer)
. status (integer)
. attachments (array)
} (object) required
attachments/post_tickets_by_id_conversationsAdd a reply/conversation to a ticket with attachments. Total attachment size max 40 MB. Must use multipart/form-data.id (integer) required
data: {
. body (string)
. from_email (string)
. user_id (integer)
. cc_emails (array)
. bcc_emails (array)
. attachments (array)
} (object) required
audit_logs/get_audit_logsView Audit Logstype (array)
requester_id (integer)
page (integer)
per_page (integer)
audit_logs/post_audit_logs_exportAudit Log Exportdata: {
. type (array)
. requester_id (integer)
. start_date (string)
. end_date (string)
} (object) required
business_hours/get_business_hoursList all business hours configurationspage (integer)
per_page (integer)
workspace_id (integer)
business_hours/get_business_hours_by_idView a business hours configurationid (integer) required
cabs/post_cabsCreate a CABdata: {
. name (string)
. description (string)
. workspace_id (integer)
. approval_type (integer)
. approval_percentage (integer)
. members (array)
} (object) required
cabs/get_cabsList all CABspage (integer)
per_page (integer)
workspace_id (integer)
cabs/get_cabs_by_idView a CABid (integer) required
cabs/put_cabs_by_idUpdate a CABid (integer) required
data: {
. name (string)
. description (string)
. approval_type (integer)
. approval_percentage (integer)
} (object) required
cabs/delete_cabs_by_idDelete a CABid (integer) required
cabs/get_cabs_by_cab_id_membersList all members of a CABcab_id (integer) required
page (integer)
per_page (integer)
cabs/post_cabs_by_cab_id_membersAdd members to a CABcab_id (integer) required
data: {
. members (array)
} (object) required
cabs/delete_cabs_by_cab_id_members_by_member_idRemove a member from a CABcab_id (integer) required
member_id (integer) required
canned_responses/get_canned_response_foldersList all Canned Response Folderspage (integer)
per_page (integer)
canned_responses/get_canned_response_folders_by_folder_idShow a Canned Response Folderfolder_id (integer) required
canned_responses/get_canned_response_folders_by_folder_id_responsesList all Canned Responses In a Folderfolder_id (integer) required
page (integer)
per_page (integer)
canned_responses/get_canned_responsesView List of Canned Responsespage (integer)
per_page (integer)
canned_responses/get_canned_responses_by_response_idShow a Canned Responseresponse_id (integer) required
changes/post_changesCreate a changedata: {
. subject (string)
. description (string)
. requester_id (integer)
. email (string)
. agent_id (integer)
. group_id (integer)
. department_id (integer)
. workspace_id (integer)
. priority (integer)
. impact (integer)
. risk (integer)
. change_type (integer)
. status (integer)
. approval_status (integer)
. release_id (integer)
. category (string)
. sub_category (string)
. item_category (string)
. planned_start_date (string)
. planned_end_date (string)
. planning_fields (object)
. custom_fields (object)
. assets (array)
. impacted_services (array)
. attachments (array)
} (object) required
changes/get_changesList all changes supports filter querypage (integer)
per_page (integer)
query (string)
view (string)
sort_by (string)
order_type (string)
workspace_id (integer)
updated_since (string)
changes/get_changes_by_idView a changeid (integer) required
include (string)
changes/put_changes_by_idUpdate a changeid (integer) required
data: {
. subject (string)
. description (string)
. agent_id (integer)
. group_id (integer)
. department_id (integer)
. priority (integer)
. impact (integer)
. risk (integer)
. change_type (integer)
. status (integer)
. approval_status (integer)
. planned_start_date (string)
. planned_end_date (string)
. planning_fields (object)
. custom_fields (object)
} (object) required
changes/delete_changes_by_idDelete a changeid (integer) required
changes/post_changes_by_id_moveMove a change to another workspaceid (integer) required
data: {
. workspace_id (integer)
} (object) required
changes/get_change_fieldsList all change fieldsNo parameters
changes/post_changes_by_change_id_notesCreate a note on a changechange_id (integer) required
data: {
. body (string)
. body_html (string)
} (object) required
changes/get_changes_by_change_id_notesList all notes for a changechange_id (integer) required
page (integer)
per_page (integer)
changes/get_changes_by_change_id_notes_by_note_idView a change notechange_id (integer) required
note_id (integer) required
changes/put_changes_by_change_id_notes_by_note_idUpdate a change notechange_id (integer) required
note_id (integer) required
data: {
. body (string)
. body_html (string)
} (object) required
changes/delete_changes_by_change_id_notes_by_note_idDelete a change notechange_id (integer) required
note_id (integer) required
changes/post_changes_by_change_id_time_entriesCreate a time entry on a changechange_id (integer) required
data: {
. time_spent (string)
. executed_at (string)
. timer_running (boolean)
. billable (boolean)
. note (string)
. agent_id (integer)
} (object) required
changes/get_changes_by_change_id_time_entriesList all time entries for a changechange_id (integer) required
page (integer)
per_page (integer)
changes/get_changes_by_change_id_time_entries_by_time_entry_idView a specific change time entrychange_id (integer) required
time_entry_id (integer) required
changes/put_changes_by_change_id_time_entries_by_time_entry_idUpdate a change time entrychange_id (integer) required
time_entry_id (integer) required
data: {
. time_spent (string)
. executed_at (string)
. timer_running (boolean)
. billable (boolean)
. note (string)
. agent_id (integer)
} (object) required
changes/delete_changes_by_change_id_time_entries_by_time_entry_idDelete a change time entrychange_id (integer) required
time_entry_id (integer) required
changes/post_changes_by_change_id_tasksCreate a task on a changechange_id (integer) required
data: {
. title (string)
. description (string)
. status (integer)
. due_date (string)
. notify_before (integer)
. group_id (integer)
. agent_id (integer)
} (object) required
changes/get_changes_by_change_id_tasksList all tasks for a changechange_id (integer) required
page (integer)
per_page (integer)
changes/get_changes_by_change_id_tasks_by_task_idView a change taskchange_id (integer) required
task_id (integer) required
changes/put_changes_by_change_id_tasks_by_task_idUpdate a change taskchange_id (integer) required
task_id (integer) required
data: {
. title (string)
. description (string)
. status (integer)
. due_date (string)
. notify_before (integer)
. group_id (integer)
. agent_id (integer)
} (object) required
changes/delete_changes_by_change_id_tasks_by_task_idDelete a change taskchange_id (integer) required
task_id (integer) required
cloud_infrastructure/get_cloud_infrastructureView cloud infrastructure detailsNo parameters
cloud_infrastructure/put_cloud_infrastructureUpdate cloud infrastructure detailsdata: {
. name (string)
. description (string)
. provider (string)
. account_id (string)
. workspace_id (integer)
. custom_fields (object)
} (object) required
cloud_infrastructure/delete_cloud_infrastructureDelete cloud infrastructure detailsNo parameters
cloud_infrastructure/put_cloud_infrastructure_custom_fieldsCreate or update a cloud infrastructure custom fielddata: {
. name (string)
. label (string)
. field_type (string)
. required (boolean)
. default (boolean)
} (object) required
collaborate/post_tickets_by_ticket_id_collaborations_emailsTrigger Email for a Major Incident with optional attachmentsticket_id (integer) required
data: {
. recipients (array)
. subject (string)
. body (string)
} (object) required
collaborate/get_tickets_by_ticket_id_collaborations_emailsRetrieve Emails Related to a Ticketticket_id (integer) required
page (integer)
per_page (integer)
collaborate/get_tickets_by_ticket_id_collaborations_emails_by_email_idRetrieve Specific Email using IDticket_id (integer) required
email_id (integer) required
collaborate/post_tickets_by_ticket_id_collaborations_zoom_meetingsTrigger a New Zoom Meetingticket_id (integer) required
data: {
. topic (string)
. agenda (string)
. start_time (string)
. duration (integer)
. timezone (string)
. password (string)
} (object) required
collaborate/get_tickets_by_ticket_id_collaborations_zoom_meetingsRetrieve Zoom Meetings Related to a Ticketticket_id (integer) required
page (integer)
per_page (integer)
collaborate/get_tickets_by_ticket_id_collaborations_zoom_meetings_by_meeting_idRetrieve Specific Zoom Meeting by IDticket_id (integer) required
meeting_id (integer) required
contracts/get_contractsList all contractspage (integer)
per_page (integer)
workspace_id (integer)
include (string)
contracts/post_contractsCreate a contractdata: {
. contract_number (string)
. name (string)
. description (string)
. vendor_id (integer)
. auto_renew (boolean)
. notify_expiry (boolean)
. notify_before (integer)
. approver_id (integer)
. start_date (string)
. end_date (string)
. cost (number)
. status (string)
. contract_type_id (integer)
. visible_to_id (integer)
. notify_to (array)
. software_id (integer)
. item_cost_details (array)
. assets (array)
. license_type (string)
. license_key (string)
. billing_cycle (string)
. custom_fields (object)
. workspace_id (integer)
} (object) required
contracts/get_contracts_by_contract_idView a contractcontract_id (integer) required
include (string)
contracts/put_contracts_by_contract_idUpdate a contractcontract_id (integer) required
data: {
. contract_number (string)
. name (string)
. description (string)
. vendor_id (integer)
. auto_renew (boolean)
. notify_expiry (boolean)
. notify_before (integer)
. approver_id (integer)
. start_date (string)
. end_date (string)
. cost (number)
. status (string)
. contract_type_id (integer)
. visible_to_id (integer)
. notify_to (array)
. item_cost_details (array)
. assets (array)
. custom_fields (object)
} (object) required
contracts/delete_contracts_by_contract_idDelete a contractcontract_id (integer) required
contracts/put_contracts_by_contract_id_moveMove a contract to another workspacecontract_id (integer) required
data: {
. workspace_id (integer)
} (object) required
contracts/post_contracts_by_contract_id_approvalSubmit a contract for approvalcontract_id (integer) required
contracts/put_contracts_by_contract_id_approvalApprove or reject a contractcontract_id (integer) required
data: {
. approval_status (string)
. reason (string)
} (object) required
contracts/get_contracts_by_contract_id_assetsList all associated assets of a contractcontract_id (integer) required
contracts/get_contracts_by_contract_id_attachmentsList all attachments of a contractcontract_id (integer) required
contracts/get_contracts_contract_typesList all contract typesNo parameters
contracts/get_contracts_contract_types_by_contract_type_id_fieldsList all fields for a contract typecontract_type_id (integer) required
conversations/get_tickets_by_ticket_id_conversationsList all conversations of a ticketticket_id (integer) required
page (integer)
per_page (integer)
conversations/post_tickets_by_ticket_id_conversationsSet 'note' to true to create a private/public note. Otherwise creates a reply.ticket_id (integer) required
data: {
. body (string)
. private (boolean)
. incoming (boolean)
. note (boolean)
. from_email (string)
. user_id (integer)
. cc_emails (array)
. bcc_emails (array)
. attachments (array)
} (object) required
conversations/post_tickets_by_ticket_id_replyCreate a reply on a ticketticket_id (integer) required
data: {
. body (string)
. from_email (string)
. user_id (integer)
. cc_emails (array)
. bcc_emails (array)
. attachments (array)
} (object) required
conversations/post_tickets_by_ticket_id_notesCreate a note on a ticketticket_id (integer) required
data: {
. body (string)
. private (boolean)
. notify_emails (array)
. attachments (array)
} (object) required
conversations/put_tickets_by_ticket_id_conversations_by_idUpdate a conversationticket_id (integer) required
id (integer) required
data: {
. body (string)
. attachments (array)
} (object) required
conversations/delete_tickets_by_ticket_id_conversations_by_idDelete a conversationticket_id (integer) required
id (integer) required
conversations/delete_tickets_by_ticket_id_conversations_by_conversation_id_attachments_by_attachment_idDelete a conversation attachmentticket_id (integer) required
conversation_id (integer) required
attachment_id (integer) required
custom_objects/get_custom_objectsView List of Custom Objectspage (integer)
per_page (integer)
custom_objects/get_custom_objects_by_custom_object_idShow a Custom Objectcustom_object_id (integer) required
custom_objects/post_custom_objects_by_custom_object_id_recordsCreate new Custom Object Recordcustom_object_id (integer) required
data: {
. data (object)
} (object) required
custom_objects/get_custom_objects_by_custom_object_id_recordsList all records of a Custom Objectcustom_object_id (integer) required
page (integer)
per_page (integer)
custom_objects/put_custom_objects_by_custom_object_id_records_by_record_idUpdate Custom Object Recordcustom_object_id (integer) required
record_id (integer) required
data: {
. data (object)
} (object) required
custom_objects/delete_custom_objects_by_custom_object_id_records_by_record_idDelete Custom Object Recordcustom_object_id (integer) required
record_id (integer) required
delegation/post_delegateeCreate a new delegation delegatee for the current agentdata: {
. delegatee_id (integer)
. start_date (string)
. end_date (string)
. module (string)
} (object) required
delegation/get_delegateeList all delegations for the current agentpage (integer)
per_page (integer)
status (string)
delegation/get_delegatee_by_idView a delegation by idid (integer) required
delegation/put_delegatee_by_idUpdate a delegationid (integer) required
data: {
. delegatee_id (integer)
. start_date (string)
. end_date (string)
. module (string)
} (object) required
delegation/delete_delegatee_by_idDelete a delegationid (integer) required
departments/post_departmentsCreate a new departmentdata: {
. name (string)
. description (string)
. head_user_id (integer)
. prime_user_id (integer)
. domains (array)
. workspace_id (integer)
. custom_fields (object)
} (object) required
departments/get_departmentsList or filter departmentspage (integer)
per_page (integer)
query (string)
workspace_id (integer)
departments/get_departments_by_idView a department by idid (integer) required
departments/put_departments_by_idUpdate a departmentid (integer) required
data: {
. name (string)
. description (string)
. head_user_id (integer)
. prime_user_id (integer)
. domains (array)
. workspace_id (integer)
. custom_fields (object)
} (object) required
departments/delete_departments_by_idDelete a departmentid (integer) required
departments/get_department_fieldsList all department fieldspage (integer)
per_page (integer)
devices/get_devicesList all devicespage (integer)
per_page (integer)
workspace_id (integer)
devices/post_devicesCreate a devicedata: {
. name (string)
. description (string)
. asset_type_id (integer)
. asset_tag (string)
. product_id (integer)
. vendor (string)
. hostname (string)
. device_type (string)
. mac_address (string)
. serial_number (string)
. warranty_expiry_date (string)
. workspace_id (integer)
. custom_fields (object)
} (object) required
devices/put_devicesCreate or update a device custom fielddata: {
. name (string)
. label (string)
. field_type (string)
. required (boolean)
. default (boolean)
} (object) required
devices/get_devices_by_device_idView a devicedevice_id (integer) required
devices/put_devices_by_device_idUpdate a devicedevice_id (integer) required
data: {
. name (string)
. description (string)
. asset_type_id (integer)
. asset_tag (string)
. product_id (integer)
. vendor (string)
. hostname (string)
. device_type (string)
. mac_address (string)
. serial_number (string)
. warranty_expiry_date (string)
. workspace_id (integer)
. custom_fields (object)
} (object) required
devices/delete_devices_by_device_idDelete a devicedevice_id (integer) required
employee_offboarding/get_offboarding_formView Offboarding Form FieldsNo parameters
employee_offboarding/post_offboarding_requestsCreate an Offboarding Requestdata: {
. initiator_id (integer)
. fields (object)
} (object) required
employee_offboarding/get_offboarding_requestsView all Offboarding Requestspage (integer)
per_page (integer)
employee_offboarding/get_offboarding_requests_by_idView an Offboarding Requestid (integer) required
employee_offboarding/get_offboarding_requests_by_id_ticketsView Offboarding Ticketsid (integer) required
employee_onboarding/get_onboarding_formView Onboarding Form FieldsNo parameters
employee_onboarding/post_onboarding_requestsCreate an Onboarding Requestdata: {
. initiator_id (integer)
. fields (object)
} (object) required
employee_onboarding/get_onboarding_requestsView all Onboarding Requestspage (integer)
per_page (integer)
employee_onboarding/get_onboarding_requests_by_idView an Onboarding Requestid (integer) required
employee_onboarding/get_onboarding_requests_by_id_ticketsView Onboarding Ticketsid (integer) required
journeys/get_journeysView List of Published Journeys Configspage (integer)
per_page (integer)
journeys/get_journeys_by_journey_id_initiator_config_formView Journey Initiator Config Form Fieldsjourney_id (integer) required
journeys/post_journey_requestsCreate a Journey Requestdata: {
. journey_id (integer)
. initiator_id (integer)
. fields (object)
} (object) required
journeys/get_journey_requestsView List / Filter Journey Requestsquery (string)
page (integer)
per_page (integer)
journeys/get_journey_requests_by_idView a Journey Requestid (integer) required
journeys/put_journey_requests_by_idUpdate a Journey Requestid (integer) required
data: {
. fields (object)
} (object) required
journeys/delete_journey_requests_by_idDelete a Journey Requestid (integer) required
journeys/put_journey_requests_by_id_cancelCancel a Journey Requestid (integer) required
journeys/get_journey_requests_by_id_activitiesView Journey Request Activitiesid (integer) required
activity_type (string)
page (integer)
per_page (integer)
lifecycle_events/get_lifecycle_eventsList all lifecycle eventspage (integer)
per_page (integer)
lifecycle_events/post_lifecycle_eventsCreate or update a lifecycle eventdata: {
. name (string)
. description (string)
. event_type (string)
. resource_id (integer)
. resource_type (string)
. workspace_id (integer)
. occurred_at (string)
. custom_fields (object)
} (object) required
lifecycle_events/get_lifecycle_events_by_idView a lifecycle eventid (integer) required
lifecycle_events/delete_lifecycle_events_by_idDelete a lifecycle eventid (integer) required
locations/post_locationsCreate a new locationdata: {
. name (string)
. parent_location_id (integer)
. primary_contact_id (integer)
. address (object)
. contact_name (string)
. phone (string)
. email (string)
. workspace_id (integer)
} (object) required
locations/get_locationsList all locationspage (integer)
per_page (integer)
workspace_id (integer)
locations/get_locations_by_idView a location by idid (integer) required
locations/put_locations_by_idUpdate a locationid (integer) required
data: {
. name (string)
. parent_location_id (integer)
. primary_contact_id (integer)
. address (object)
. contact_name (string)
. phone (string)
. email (string)
. workspace_id (integer)
} (object) required
locations/delete_locations_by_idDelete a locationid (integer) required
oncall_management/post_schedulesCreate a Scheduledata: {
. name (string)
. description (string)
. time_zone (string)
. group_id (integer)
} (object) required
oncall_management/get_schedulesView All / Filter Schedulespage (integer)
per_page (integer)
query (string)
oncall_management/get_schedules_by_idView a Scheduleid (integer) required
oncall_management/put_schedules_by_idUpdate a Scheduleid (integer) required
data: {
. name (string)
. description (string)
. time_zone (string)
. group_id (integer)
} (object) required
oncall_management/delete_schedules_by_idDelete a Scheduleid (integer) required
oncall_management/post_shiftsCreate a Shiftdata: {
. name (string)
. schedule_id (integer)
. start_time (string)
. end_time (string)
. users (array)
. rotation (string)
} (object) required
oncall_management/get_shiftsView All Shiftspage (integer)
per_page (integer)
oncall_management/get_shifts_by_idView a Shiftid (integer) required
oncall_management/put_shifts_by_idUpdate a Shiftid (integer) required
data: {
. name (string)
. start_time (string)
. end_time (string)
. users (array)
. rotation (string)
} (object) required
oncall_management/delete_shifts_by_idDelete a Shiftid (integer) required
oncall_management/post_overridesCreate an Overridedata: {
. schedule_id (integer)
. user_id (integer)
. start_time (string)
. end_time (string)
} (object) required
oncall_management/put_overrides_by_idUpdate an Overrideid (integer) required
data: {
. user_id (integer)
. start_time (string)
. end_time (string)
} (object) required
oncall_management/delete_overrides_by_idDelete an Overrideid (integer) required
oncall_management/get_users_by_user_id_oncall_calendar_eventsView Oncall Calendar Events for a Useruser_id (integer) required
start_time (string)
end_time (string)
oncall_management/get_schedules_by_schedule_id_oncall_calendar_eventsView Oncall Calendar Events for a Scheduleschedule_id (integer) required
start_time (string)
end_time (string)
oncall_management/get_shifts_by_shift_id_oncall_calendar_eventsView Oncall Calendar Events for a Shiftshift_id (integer) required
start_time (string)
end_time (string)
oncall_management/get_oncall_who_is_oncallView Who is Oncallschedule_id (integer)
escalation_policy_id (integer)
oncall_management/post_escalation_policiesCreate an Escalation Policydata: {
. name (string)
. description (string)
. rules (array)
} (object) required
oncall_management/get_escalation_policiesView All Escalation Policiespage (integer)
per_page (integer)
oncall_management/get_escalation_policies_by_idView an Escalation Policyid (integer) required
oncall_management/put_escalation_policies_by_idUpdate an Escalation Policyid (integer) required
data: {
. name (string)
. description (string)
. rules (array)
} (object) required
oncall_management/delete_escalation_policies_by_idDelete an Escalation Policyid (integer) required
oncall_management/put_escalation_policies_by_id_reorderReorder an Escalation Policyid (integer) required
data: {
. position (integer)
} (object) required
physical_subtypes/get_physical_subtypesList physical subtypespage (integer)
per_page (integer)
physical_subtypes/post_physical_subtypesCreate or update a physical subtypedata: {
. name (string)
. description (string)
. asset_type_id (integer)
. custom_fields (object)
} (object) required
physical_subtypes/get_physical_subtypes_by_idView a physical subtypeid (integer) required
physical_subtypes/delete_physical_subtypes_by_idDelete a physical subtypeid (integer) required
post_incident_reports/post_post_incident_report_templatesCreate a post-incident report templatedata: {
. name (string)
. description (string)
. workspace_id (integer)
. is_primary (boolean)
. enabled (boolean)
. sections (array)
} (object) required
post_incident_reports/get_post_incident_report_templatesList all post-incident report templatespage (integer)
per_page (integer)
workspace_id (integer)
post_incident_reports/get_post_incident_report_templates_by_idView a post-incident report templateid (integer) required
post_incident_reports/delete_post_incident_report_templates_by_idDelete a post-incident report templateid (integer) required
post_incident_reports/put_post_incident_report_templates_by_id_enableEnable a post-incident report templateid (integer) required
post_incident_reports/put_post_incident_report_templates_by_id_mark_primarySet a post-incident report template as the primaryid (integer) required
post_incident_reports/get_post_incident_report_templates_by_id_exportExport a post-incident report templateid (integer) required
problems/post_problemsCreate a problemdata: {
. subject (string)
. description (string)
. description_html (string)
. requester_id (integer)
. email (string)
. agent_id (integer)
. group_id (integer)
. department_id (integer)
. workspace_id (integer)
. priority (integer)
. impact (integer)
. status (integer)
. known_error (boolean)
. due_by (string)
. category (string)
. sub_category (string)
. item_category (string)
. associated_change (integer)
. assets (array)
. problem_cause (string)
. problem_symptom (string)
. problem_impact (string)
. custom_fields (object)
. attachments (array)
} (object) required
problems/get_problemsList all problemspage (integer)
per_page (integer)
workspace_id (integer)
updated_since (string)
problems/get_problems_by_idView a problemid (integer) required
include (string)
problems/put_problems_by_idUpdate a problemid (integer) required
data: {
. subject (string)
. description (string)
. description_html (string)
. agent_id (integer)
. group_id (integer)
. department_id (integer)
. priority (integer)
. impact (integer)
. status (integer)
. known_error (boolean)
. due_by (string)
. problem_cause (string)
. problem_symptom (string)
. problem_impact (string)
. custom_fields (object)
} (object) required
problems/delete_problems_by_idDelete a problemid (integer) required
problems/put_problems_by_id_restoreRestore a soft-deleted problemid (integer) required
problems/get_problem_fieldsList all problem fieldsNo parameters
problems/post_problems_by_problem_id_notesCreate a note on a problemproblem_id (integer) required
data: {
. body (string)
. notify_emails (array)
} (object) required
problems/get_problems_by_problem_id_notesList all notes for a problemproblem_id (integer) required
page (integer)
per_page (integer)
problems/get_problems_by_problem_id_notes_by_note_idView a specific problem noteproblem_id (integer) required
note_id (integer) required
problems/put_problems_by_problem_id_notes_by_note_idUpdate a problem noteproblem_id (integer) required
note_id (integer) required
data: {
. body (string)
. notify_emails (array)
} (object) required
problems/delete_problems_by_problem_id_notes_by_note_idDelete a problem noteproblem_id (integer) required
note_id (integer) required
problems/post_problems_by_problem_id_time_entriesCreate a time entry on a problemproblem_id (integer) required
data: {
. time_spent (string)
. executed_at (string)
. timer_running (boolean)
. billable (boolean)
. note (string)
. agent_id (integer)
} (object) required
problems/get_problems_by_problem_id_time_entriesList all time entries for a problemproblem_id (integer) required
page (integer)
per_page (integer)
problems/get_problems_by_problem_id_time_entries_by_time_entry_idView a specific problem time entryproblem_id (integer) required
time_entry_id (integer) required
problems/put_problems_by_problem_id_time_entries_by_time_entry_idUpdate a problem time entryproblem_id (integer) required
time_entry_id (integer) required
data: {
. time_spent (string)
. executed_at (string)
. timer_running (boolean)
. billable (boolean)
. note (string)
. agent_id (integer)
} (object) required
problems/delete_problems_by_problem_id_time_entries_by_time_entry_idDelete a problem time entryproblem_id (integer) required
time_entry_id (integer) required
problems/post_problems_by_problem_id_tasksCreate a task on a problemproblem_id (integer) required
data: {
. title (string)
. description (string)
. status (integer)
. due_date (string)
. notify_before (integer)
. group_id (integer)
. agent_id (integer)
} (object) required
problems/get_problems_by_problem_id_tasksList all tasks for a problemproblem_id (integer) required
page (integer)
per_page (integer)
problems/get_problems_by_problem_id_tasks_by_task_idView a specific problem taskproblem_id (integer) required
task_id (integer) required
problems/put_problems_by_problem_id_tasks_by_task_idUpdate a problem taskproblem_id (integer) required
task_id (integer) required
data: {
. title (string)
. description (string)
. status (integer)
. due_date (string)
. notify_before (integer)
. group_id (integer)
. agent_id (integer)
} (object) required
problems/delete_problems_by_problem_id_tasks_by_task_idDelete a problem taskproblem_id (integer) required
task_id (integer) required
products/get_productsList all productspage (integer)
per_page (integer)
workspace_id (integer)
products/post_productsCreate a new productdata: {
. name (string)
. asset_type_id (integer)
. manufacturer (string)
. status (string)
. mode_of_procurement (string)
. depreciation_type_id (integer)
. description (string)
. workspace_id (integer)
} (object) required
products/get_products_by_idView a productid (integer) required
products/put_products_by_idUpdate a productid (integer) required
data: {
. name (string)
. asset_type_id (integer)
. manufacturer (string)
. status (string)
. mode_of_procurement (string)
. depreciation_type_id (integer)
. description (string)
} (object) required
products/delete_products_by_idDelete a productid (integer) required
project_tasks/post_projects_by_project_id_tasksCreate a project taskproject_id (integer) required
data: {
. title (string)
. description (string)
. assignee_id (integer)
. due_date (string)
. priority (integer)
. status (integer)
} (object) required
project_tasks/get_projects_by_project_id_tasksView all project tasksproject_id (integer) required
page (integer)
per_page (integer)
project_tasks/get_projects_by_project_id_tasks_by_task_idView a project taskproject_id (integer) required
task_id (integer) required
project_tasks/put_projects_by_project_id_tasks_by_task_idUpdate a project taskproject_id (integer) required
task_id (integer) required
data: {
. title (string)
. description (string)
. assignee_id (integer)
. due_date (string)
. priority (integer)
. status (integer)
} (object) required
project_tasks/delete_projects_by_project_id_tasks_by_task_idDelete a project taskproject_id (integer) required
task_id (integer) required
project_tasks_new_gen/post_project_tasksCreate a NewGen project taskdata: {
. project_id (integer)
. title (string)
. description (string)
. assignee_id (integer)
. due_date (string)
. priority (integer)
. status (integer)
. type_id (integer)
} (object) required
project_tasks_new_gen/get_project_tasksList all NewGen project tasks optionally filteredpage (integer)
per_page (integer)
filter (string)
project_tasks_new_gen/get_project_tasks_by_task_idView a NewGen project tasktask_id (integer) required
project_tasks_new_gen/put_project_tasks_by_task_idUpdate a NewGen project tasktask_id (integer) required
data: {
. title (string)
. description (string)
. assignee_id (integer)
. due_date (string)
. priority (integer)
. status (integer)
. type_id (integer)
} (object) required
project_tasks_new_gen/delete_project_tasks_by_task_idDelete a NewGen project tasktask_id (integer) required
project_tasks_new_gen/get_project_tasks_type_fieldsView project task type fieldsNo parameters
project_tasks_new_gen/get_project_task_typesView project task typesNo parameters
project_tasks_new_gen/get_project_task_prioritiesView project task prioritiesNo parameters
project_tasks_new_gen/get_project_task_statusesView project task statusesNo parameters
project_tasks_new_gen/post_project_tasks_by_task_id_associationsCreate task associationtask_id (integer) required
data: {
. associated_entity_type (string)
. associated_entity_id (integer)
} (object) required
project_tasks_new_gen/get_project_tasks_by_task_id_associationsView task associationstask_id (integer) required
project_tasks_new_gen/delete_project_tasks_by_task_id_associations_by_association_idDelete task associationtask_id (integer) required
association_id (integer) required
project_tasks_new_gen/post_project_tasks_by_task_id_notesCreate task notetask_id (integer) required
data: {
. body (string)
. attachments (array)
} (object) required
project_tasks_new_gen/get_project_tasks_by_task_id_notesView task notestask_id (integer) required
project_tasks_new_gen/put_project_tasks_by_task_id_notes_by_note_idUpdate task notetask_id (integer) required
note_id (integer) required
data: {
. body (string)
. attachments (array)
} (object) required
project_tasks_new_gen/delete_project_tasks_by_task_id_notes_by_note_idDelete task notetask_id (integer) required
note_id (integer) required
project_tasks_new_gen/delete_project_tasks_by_task_id_attachments_by_attachment_idDelete attachment of a project tasktask_id (integer) required
attachment_id (integer) required
project_tasks_new_gen/delete_project_tasks_by_task_id_notes_by_note_id_attachments_by_attachment_idDelete attachment of a task notetask_id (integer) required
note_id (integer) required
attachment_id (integer) required
projects/post_projectsCreate a new projectdata: {
. name (string)
. description (string)
. key (string)
. start_date (string)
. end_date (string)
. status (integer)
. priority (integer)
. owner_id (integer)
. visibility (string)
} (object) required
projects/get_projectsView all projectspage (integer)
per_page (integer)
projects/get_projects_by_idView a projectid (integer) required
projects/put_projects_by_idUpdate a projectid (integer) required
data: {
. name (string)
. description (string)
. status (integer)
. priority (integer)
. owner_id (integer)
. end_date (string)
} (object) required
projects/delete_projects_by_idDelete a projectid (integer) required
projects/put_projects_by_id_archiveArchive a projectid (integer) required
projects/put_projects_by_id_restoreRestore an archived projectid (integer) required
projects_new_gen/post_projectsCreate a new NewGen projectdata: {
. name (string)
. key (string)
. description (string)
. status (string)
. template_id (integer)
} (object) required
projects_new_gen/get_projectsView all NewGen projectspage (integer)
per_page (integer)
projects_new_gen/get_projects_by_idView a NewGen projectid (integer) required
projects_new_gen/put_projects_by_idUpdate a NewGen projectid (integer) required
data: {
. name (string)
. description (string)
. status (string)
} (object) required
projects_new_gen/delete_projects_by_idDelete a NewGen projectid (integer) required
projects_new_gen/put_projects_by_id_archiveArchive a NewGen projectid (integer) required
projects_new_gen/put_projects_by_id_restoreRestore a NewGen projectid (integer) required
projects_new_gen/get_projects_fieldsView NewGen project fieldsNo parameters
projects_new_gen/get_project_templatesView NewGen project templatesNo parameters
projects_new_gen/post_projects_by_id_membersAdd members to a NewGen projectid (integer) required
data: {
. members (array)
} (object) required
projects_new_gen/post_projects_by_id_associationsCreate a project associationid (integer) required
data: {
. associated_entity_type (string)
. associated_entity_id (integer)
} (object) required
projects_new_gen/get_projects_by_id_associationsView project associationsid (integer) required
projects_new_gen/delete_projects_by_id_associations_by_association_idDelete a project associationid (integer) required
association_id (integer) required
projects_new_gen/delete_projects_by_id_attachments_by_attachment_idDelete attachment of a projectid (integer) required
attachment_id (integer) required
purchase_orders/get_purchase_ordersList all purchase orderspage (integer)
per_page (integer)
workspace_id (integer)
include (string)
purchase_orders/post_purchase_ordersCreate a new purchase orderdata: {
. name (string)
. po_number (string)
. vendor_id (integer)
. expected_delivery_date (string)
. shipping_address (object)
. billing_same_as_shipping (boolean)
. billing_address
. currency_code (string)
. conversion_rate (number)
. department_id (integer)
. discount_percentage (number)
. shipping_cost (number)
. tax_percentage (number)
. purchase_items (array)
. custom_fields (object)
. workspace_id (integer)
} (object) required
purchase_orders/get_purchase_orders_by_idView a purchase orderid (integer) required
include (string)
purchase_orders/put_purchase_orders_by_idUpdate a purchase orderid (integer) required
data: {
. name (string)
. po_number (string)
. vendor_id (integer)
. expected_delivery_date (string)
. shipping_address (object)
. billing_same_as_shipping (boolean)
. billing_address
. currency_code (string)
. conversion_rate (number)
. department_id (integer)
. discount_percentage (number)
. shipping_cost (number)
. tax_percentage (number)
. purchase_items (array)
. custom_fields (object)
} (object) required
purchase_orders/delete_purchase_orders_by_idDelete a purchase orderid (integer) required
purchase_orders/put_purchase_orders_by_id_send_for_approvalSend a purchase order for approvalid (integer) required
data: {
. approver_ids (array)
} (object) required
purchase_orders/put_purchase_orders_by_id_mark_items_as_receivedMark items of a purchase order as receivedid (integer) required
data: {
. purchase_items (array)
} (object) required
purchase_orders/put_purchase_orders_by_id_move_workspaceMove a purchase order to another workspaceid (integer) required
data: {
. workspace_id (integer)
} (object) required
releases/post_releasesCreate a releasedata: {
. subject (string)
. description (string)
. workspace_id (integer)
. agent_id (integer)
. group_id (integer)
. department_id (integer)
. priority (integer)
. status (integer)
. release_type (integer)
. planned_start_date (string)
. planned_end_date (string)
. category (string)
. sub_category (string)
. item_category (string)
. associated_change_ids (array)
. planning_fields (object)
. custom_fields (object)
. attachments (array)
} (object) required
releases/get_releasesList all releasespage (integer)
per_page (integer)
workspace_id (integer)
updated_since (string)
releases/get_releases_by_idView a releaseid (integer) required
include (string)
releases/put_releases_by_idUpdate a releaseid (integer) required
data: {
. subject (string)
. description (string)
. agent_id (integer)
. group_id (integer)
. department_id (integer)
. priority (integer)
. status (integer)
. release_type (integer)
. planned_start_date (string)
. planned_end_date (string)
. planning_fields (object)
. custom_fields (object)
} (object) required
releases/delete_releases_by_idDelete a releaseid (integer) required
releases/put_releases_by_id_moveMove a release to another workspaceid (integer) required
data: {
. workspace_id (integer)
} (object) required
releases/post_releases_by_release_id_notesCreate a note on a releaserelease_id (integer) required
data: {
. body (string)
. body_html (string)
} (object) required
releases/get_releases_by_release_id_notesList all notes for a releaserelease_id (integer) required
page (integer)
per_page (integer)
releases/get_releases_by_release_id_notes_by_note_idView a release noterelease_id (integer) required
note_id (integer) required
releases/put_releases_by_release_id_notes_by_note_idUpdate a release noterelease_id (integer) required
note_id (integer) required
data: {
. body (string)
. body_html (string)
} (object) required
releases/delete_releases_by_release_id_notes_by_note_idDelete a release noterelease_id (integer) required
note_id (integer) required
releases/post_releases_by_release_id_tasksCreate a task on a releaserelease_id (integer) required
data: {
. title (string)
. description (string)
. status (integer)
. due_date (string)
. notify_before (integer)
. group_id (integer)
. agent_id (integer)
. stage (integer)
} (object) required
releases/get_releases_by_release_id_tasksList all tasks for a releaserelease_id (integer) required
page (integer)
per_page (integer)
releases/get_releases_by_release_id_tasks_by_task_idView a release taskrelease_id (integer) required
task_id (integer) required
releases/put_releases_by_release_id_tasks_by_task_idUpdate a release taskrelease_id (integer) required
task_id (integer) required
data: {
. title (string)
. description (string)
. status (integer)
. due_date (string)
. notify_before (integer)
. group_id (integer)
. agent_id (integer)
. stage (integer)
} (object) required
releases/delete_releases_by_release_id_tasks_by_task_idDelete a release taskrelease_id (integer) required
task_id (integer) required
releases/post_releases_by_release_id_time_entriesCreate a time entry on a releaserelease_id (integer) required
data: {
. time_spent (string)
. executed_at (string)
. timer_running (boolean)
. billable (boolean)
. note (string)
. agent_id (integer)
} (object) required
releases/get_releases_by_release_id_time_entriesList all time entries for a releaserelease_id (integer) required
page (integer)
per_page (integer)
releases/get_releases_by_release_id_time_entries_by_time_entry_idView a release time entryrelease_id (integer) required
time_entry_id (integer) required
releases/put_releases_by_release_id_time_entries_by_time_entry_idUpdate a release time entryrelease_id (integer) required
time_entry_id (integer) required
data: {
. time_spent (string)
. executed_at (string)
. timer_running (boolean)
. billable (boolean)
. note (string)
. agent_id (integer)
} (object) required
releases/delete_releases_by_release_id_time_entries_by_time_entry_idDelete a release time entryrelease_id (integer) required
time_entry_id (integer) required
requester_groups/post_requester_groupsCreate a new requester groupdata: {
. name (string)
. description (string)
. type (string)
} (object) required
requester_groups/get_requester_groupsList all requester groupspage (integer)
per_page (integer)
requester_groups/get_requester_groups_by_idView a requester group by idid (integer) required
requester_groups/put_requester_groups_by_idUpdate a requester groupid (integer) required
data: {
. name (string)
. description (string)
} (object) required
requester_groups/delete_requester_groups_by_idDelete a requester groupid (integer) required
requester_groups/get_requester_groups_by_id_membersList members of a requester groupid (integer) required
page (integer)
per_page (integer)
requester_groups/post_requester_groups_by_id_members_by_user_idAdd a requester to a requester groupid (integer) required
user_id (integer) required
requester_groups/delete_requester_groups_by_id_members_by_user_idRemove a requester from a requester groupid (integer) required
user_id (integer) required
requesters/post_requestersCreate a new requester contactdata: {
. first_name (string)
. last_name (string)
. job_title (string)
. primary_email (string)
. secondary_emails (array)
. work_phone_number (string)
. mobile_phone_number (string)
. department_ids (array)
. can_see_all_tickets_from_associated_departments (boolean)
. reporting_manager_id (integer)
. address (string)
. time_zone (string)
. time_format (string)
. language (string)
. location_id (integer)
. background_information (string)
. workspace_ids (array)
. external_id (string)
. custom_fields (object)
} (object) required
requesters/get_requestersList all requesters or filter with queryemail (string)
mobile (string)
phone (string)
department_id (integer)
include_agents (boolean)
query (string)
page (integer)
per_page (integer)
requesters/get_requesters_by_idView a requester by idid (integer) required
requesters/put_requesters_by_idUpdate a requesterid (integer) required
data: {
. first_name (string)
. last_name (string)
. job_title (string)
. primary_email (string)
. secondary_emails (array)
. work_phone_number (string)
. mobile_phone_number (string)
. department_ids (array)
. can_see_all_tickets_from_associated_departments (boolean)
. reporting_manager_id (integer)
. address (string)
. time_zone (string)
. time_format (string)
. language (string)
. location_id (integer)
. background_information (string)
. workspace_ids (array)
. external_id (string)
. custom_fields (object)
} (object) required
requesters/delete_requesters_by_idDeactivate a requesterid (integer) required
requesters/delete_requesters_by_id_forgetPermanently delete a requester and their tickets GDPR forgetid (integer) required
requesters/put_requesters_by_id_convert_to_agentConvert a requester into a full-time or occasional agentid (integer) required
requesters/put_requesters_by_id_reactivateReactivate a deactivated requesterid (integer) required
requesters/post_requesters_by_primary_id_mergeMerge secondary requesters into a primary requesterprimary_id (integer) required
secondary_requesters (string) required
requesters/get_requesters_by_id_user_assignment_historyGet the assignment history of a requesterid (integer) required
requesters/get_requester_fieldsList all requester contact fieldsNo parameters
resource_relationships/get_resource_relationshipsList all cloud resource relationshipspage (integer)
per_page (integer)
resource_id (integer)
resource_relationships/delete_resource_relationships_by_idDelete a cloud resource relationshipid (integer) required
resources/get_resourcesList all cloud resourcespage (integer)
per_page (integer)
resources/get_resources_by_resource_idView a cloud resourceresource_id (integer) required
resources/put_resources_by_resource_idUpdate a cloud resourceresource_id (integer) required
data: {
. name (string)
. description (string)
. workspace_id (integer)
. custom_fields (object)
} (object) required
resources/delete_resources_by_resource_idDelete a cloud resourceresource_id (integer) required
resources/post_resources_by_resource_id_custom_fieldsCreate a resource custom fieldresource_id (integer) required
data: {
. custom_fields (object)
} (object) required
resources/put_resources_by_resource_id_custom_fieldsUpdate a resource custom fieldresource_id (integer) required
data: {
. custom_fields (object)
} (object) required
service_catalog/get_service_itemsList all service itemspage (integer)
per_page (integer)
service_catalog/post_service_itemsCreate a service catalog itemdata: {
. name (string)
. description (string)
. short_description (string)
. category_id (integer)
. agent_group_visibilities (array)
. shared_fields (array)
} (object) required
service_catalog/get_service_items_by_idView a service itemid (integer) required
service_catalog/put_service_items_by_idUpdate a service itemid (integer) required
data: {
. name (string)
. description (string)
. short_description (string)
. category_id (integer)
} (object) required
service_catalog/delete_service_items_by_idDelete a service itemid (integer) required
service_catalog/get_service_items_searchSearch service itemsquery (string) required
service_catalog/get_service_categoriesList all service categoriespage (integer)
per_page (integer)
service_catalog/get_shared_fieldsList shared fields based on searchquery (string)
service_catalog/post_shared_fieldsCreate a shared fielddata: {
. name (string)
. type (string)
. visibility (string)
} (object) required
service_catalog/put_shared_fields_by_idUpdate a shared fieldid (integer) required
data: {
. name (string)
. type (string)
. visibility (string)
} (object) required
service_catalog/delete_shared_fields_by_idDelete a shared fieldid (integer) required
service_catalog/get_shared_fields_by_id_dataRetrieve shared field dataid (integer) required
service_catalog/put_shared_fields_by_id_archiveArchive a shared fieldid (integer) required
service_catalog/put_shared_fields_by_id_unarchiveUnarchive a shared fieldid (integer) required
sla_policies/get_sla_policiesList all SLA policiespage (integer)
per_page (integer)
workspace_id (integer)
software/get_applicationsList all software applicationspage (integer)
per_page (integer)
workspace_id (integer)
software/post_applicationsCreate a new softwaredata: {
. name (string)
. description (string)
. application_type (string)
. status (string)
. publisher_id (integer)
. managed_by_id (integer)
. notes (string)
. category (string)
. workspace_id (integer)
} (object) required
software/delete_applicationsDelete multiple software in bulkdata: {
. ids (array)
} (object) required
software/get_applications_by_idView a softwareid (integer) required
software/put_applications_by_idUpdate a softwareid (integer) required
data: {
. name (string)
. description (string)
. application_type (string)
. status (string)
. publisher_id (integer)
. managed_by_id (integer)
. notes (string)
. category (string)
} (object) required
software/delete_applications_by_idDelete a softwareid (integer) required
software/get_applications_by_id_licensesList all licenses of a softwareid (integer) required
software/put_applications_by_id_move_workspaceMove a software to another workspaceid (integer) required
data: {
. workspace_id (integer)
} (object) required
software/get_applications_by_id_usersList all users of a softwareid (integer) required
page (integer)
per_page (integer)
software/post_applications_by_id_usersAdd users to a software in bulkid (integer) required
data: {
. application_users (array)
} (object) required
software/put_applications_by_id_usersUpdate users of a software in bulkid (integer) required
data: {
. application_users (array)
} (object) required
software/delete_applications_by_id_usersRemove users from a software in bulkid (integer) required
data: {
. user_ids (array)
} (object) required
software/get_applications_by_id_users_by_user_idView a specific user of a softwareid (integer) required
user_id (integer) required
software/get_applications_by_id_installationsList all installations of a softwareid (integer) required
page (integer)
per_page (integer)
software/post_applications_by_id_installationsAdd a device installation to a softwareid (integer) required
data: {
. installations (array)
} (object) required
software/delete_applications_by_id_installationsRemove device installations from a software in bulkid (integer) required
data: {
. installation_ids (array)
} (object) required
software/get_applications_by_id_relationshipsList all relationships for a softwareid (integer) required
solution_articles/post_solution_articlesCreate a solution articledata: {
. title (string)
. description (string)
. folder_id (integer)
. status (integer)
. source_url (string)
. attachments (array)
} (object) required
solution_articles/get_solution_articlesList solution articlesfolder_id (integer)
page (integer)
per_page (integer)
filter (string)
solution_articles/get_solution_articles_searchSearch solution articlesquery (string) required
folder_id (integer)
page (integer)
per_page (integer)
solution_articles/put_solution_articles_restoreBulk restore solution articlesdata: {
. article_ids (array)
} (object) required
solution_articles/get_solution_articles_by_idView a solution articleid (integer) required
include (string)
solution_articles/put_solution_articles_by_idUpdate a solution articleid (integer) required
data: {
. title (string)
. description (string)
. status (integer)
. folder_id (integer)
} (object) required
solution_articles/delete_solution_articles_by_idDelete a solution article move to trashid (integer) required
solution_articles/post_solution_articles_by_id_translationsCreate a secondary language translation of an articleid (integer) required
data: {
. language (string)
. title (string)
. description (string)
} (object) required
solution_articles/post_solution_articles_by_id_approvalSend an article for approvalid (integer) required
data: {
. approver_ids (array)
} (object) required
solution_articles/put_solution_articles_by_id_publishPublish a solution articleid (integer) required
data: {
. publish_date (string)
} (object) required
solution_articles/put_solution_articles_by_id_restoreRestore a deleted solution articleid (integer) required
solution_articles/delete_solution_articles_by_id_foreverPermanently delete a solution articleid (integer) required
solution_categories/post_solution_categoriesCreate a solution categorydata: {
. name (string)
. description (string)
. parent_id (integer)
} (object) required
solution_categories/get_solution_categoriesList solution categoriespage (integer)
per_page (integer)
filter (string)
solution_categories/get_solution_categories_by_idView a solution categoryid (integer) required
solution_categories/put_solution_categories_by_idUpdate a solution categoryid (integer) required
data: {
. name (string)
. description (string)
. parent_id (integer)
} (object) required
solution_categories/delete_solution_categories_by_idDelete a solution category move to trashid (integer) required
solution_categories/put_solution_categories_by_id_restoreRestore a deleted solution categoryid (integer) required
solution_categories/delete_solution_categories_by_id_permanently_deletePermanently delete a solution categoryid (integer) required
solution_folders/post_solution_foldersCreate a solution folderdata: {
. name (string)
. description (string)
. category_id (integer)
. parent_folder_id (integer)
. require_approval (boolean)
} (object) required
solution_folders/get_solution_foldersList solution folderscategory_id (integer) required
page (integer)
per_page (integer)
solution_folders/get_solution_folders_by_idView a solution folderid (integer) required
include (string)
solution_folders/put_solution_folders_by_idUpdate a solution folderid (integer) required
data: {
. name (string)
. description (string)
. parent_folder_id (integer)
} (object) required
solution_folders/delete_solution_folders_by_idDelete a solution folder soft deleteid (integer) required
solution_folders/get_solution_folders_by_id_sub_foldersView sub folders of a solution folderid (integer) required
page (integer)
per_page (integer)
solution_folders/put_solution_folders_by_id_restoreRestore a deleted solution folderid (integer) required
solution_folders/delete_solution_folders_by_id_permanently_deletePermanently delete a solution folderid (integer) required
status_page/get_status_pages_incidentsList all status page incidentspage (integer)
per_page (integer)
status_page/post_status_pages_incidentsCreate a status page incidentdata: {
. title (string)
. description (string)
. status (string)
. impact (string)
} (object) required
status_page/get_status_pages_incidents_by_incident_idView a status page incidentincident_id (integer) required
status_page/put_status_pages_incidents_by_incident_idUpdate a status page incidentincident_id (integer) required
data: {
. title (string)
. description (string)
. status (string)
} (object) required
status_page/delete_status_pages_incidents_by_incident_idDelete a status page incidentincident_id (integer) required
status_page/get_status_pages_incidents_by_incident_id_updatesList all updates for a status page incidentincident_id (integer) required
status_page/post_status_pages_incidents_by_incident_id_updatesCreate a status page incident updateincident_id (integer) required
data: {
. body (string)
. status (string)
} (object) required
status_page/put_status_pages_incidents_by_incident_id_updates_by_update_idEdit a status page incident updateincident_id (integer) required
update_id (integer) required
data: {
. body (string)
. status (string)
} (object) required
status_page/delete_status_pages_incidents_by_incident_id_updates_by_update_idDelete a status page incident updateincident_id (integer) required
update_id (integer) required
status_page/get_status_pages_maintenancesList all status page maintenancespage (integer)
per_page (integer)
status_page/post_status_pages_maintenances_from_changeCreate a status page maintenance from a changedata: {
. change_id (integer)
. title (string)
. description (string)
. start_time (string)
. end_time (string)
. status (string)
} (object) required
status_page/put_status_pages_maintenances_by_maintenance_id_from_changeUpdate a status page maintenance from a changemaintenance_id (integer) required
data: {
. change_id (integer)
. title (string)
. description (string)
. start_time (string)
. end_time (string)
. status (string)
} (object) required
status_page/get_status_pages_maintenance_statusesList all maintenance statusesNo parameters
status_page/get_status_pages_servicesList all status page service componentsNo parameters
status_page/get_status_pages_services_by_service_idView a status page service componentservice_id (integer) required
status_page/get_status_pages_subscribersList all status page subscribersNo parameters
status_page/post_status_pages_subscribersCreate a status page subscriberdata: {
. email (string)
. phone (string)
} (object) required
status_page/get_status_pages_subscribers_by_subscriber_idView a status page subscribersubscriber_id (integer) required
status_page/put_status_pages_subscribers_by_subscriber_idUpdate a status page subscribersubscriber_id (integer) required
data: {
. email (string)
. phone (string)
} (object) required
status_page/delete_status_pages_subscribers_by_subscriber_idDelete a status page subscribersubscriber_id (integer) required
tickets/post_ticketsCreate a new ticketdata: {
. subject (string)
. description (string)
. email (string)
. requester_id (integer)
. phone (string)
. name (string)
. priority (integer)
. status (integer)
. source (integer)
. cc_emails (array)
. group_id (integer)
. responder_id (integer)
. tags (array)
. department_id (integer)
. workspace_id (integer)
. category (string)
. sub_category (string)
. item_category (string)
. urgency (integer)
. impact (integer)
. due_by (string)
. fr_due_by (string)
. custom_fields (object)
. attachments (array)
. assets (array)
. problem (object)
. change_initiating_ticket (object)
. change_initiated_by_ticket (object)
} (object) required
tickets/get_ticketsList all tickets supports filteringpage (integer)
per_page (integer)
filter (string)
query (string)
include (string)
workspace_id (integer)
requester_id (integer)
email (string)
updated_since (string)
order_type (string)
tickets/get_tickets_by_idView a ticket by idid (integer) required
include (string)
tickets/put_tickets_by_idUpdate a ticket also used to restore or move workspaceid (integer) required
data: {
. subject (string)
. description (string)
. priority (integer)
. status (integer)
. source (integer)
. requester_id (integer)
. email (string)
. group_id (integer)
. responder_id (integer)
. tags (array)
. cc_emails (array)
. department_id (integer)
. workspace_id (integer)
. urgency (integer)
. impact (integer)
. due_by (string)
. custom_fields (object)
. deleted (boolean)
} (object) required
tickets/delete_tickets_by_idDelete a ticketid (integer) required
tickets/put_tickets_by_id_restoreRestore a soft-deleted ticketid (integer) required
tickets/post_tickets_by_parent_id_child_ticketsCreate a child ticket for a parent ticketparent_id (integer) required
data: {
. subject (string)
. description (string)
. email (string)
. requester_id (integer)
. phone (string)
. name (string)
. priority (integer)
. status (integer)
. source (integer)
. cc_emails (array)
. group_id (integer)
. responder_id (integer)
. tags (array)
. department_id (integer)
. workspace_id (integer)
. category (string)
. sub_category (string)
. item_category (string)
. urgency (integer)
. impact (integer)
. due_by (string)
. fr_due_by (string)
. custom_fields (object)
. attachments (array)
. assets (array)
. problem (object)
. change_initiating_ticket (object)
. change_initiated_by_ticket (object)
} (object) required
tickets/delete_tickets_by_id_attachments_by_attachment_idDelete a ticket attachmentid (integer) required
attachment_id (integer) required
tickets/get_tickets_by_id_activitiesGet activity log for a ticketid (integer) required
page (integer)
per_page (integer)
tickets/post_tickets_by_ticket_id_time_entriesCreate a time entry on a ticketticket_id (integer) required
data: {
. time_spent (string)
. executed_at (string)
. timer_running (boolean)
. billable (boolean)
. note (string)
. agent_id (integer)
. start_time (string)
} (object) required
tickets/get_tickets_by_ticket_id_time_entriesList all time entries for a ticketticket_id (integer) required
page (integer)
per_page (integer)
tickets/get_tickets_by_ticket_id_time_entries_by_idView a specific time entryticket_id (integer) required
id (integer) required
tickets/put_tickets_by_ticket_id_time_entries_by_idUpdate a time entryticket_id (integer) required
id (integer) required
data: {
. time_spent (string)
. executed_at (string)
. timer_running (boolean)
. billable (boolean)
. note (string)
. agent_id (integer)
. start_time (string)
} (object) required
tickets/delete_tickets_by_ticket_id_time_entries_by_idDelete a time entryticket_id (integer) required
id (integer) required
tickets/post_tickets_by_ticket_id_tasksCreate a task on a ticketticket_id (integer) required
data: {
. title (string)
. description (string)
. status (integer)
. due_date (string)
. notify_before (integer)
. group_id (integer)
. agent_id (integer)
} (object) required
tickets/get_tickets_by_ticket_id_tasksList all tasks for a ticketticket_id (integer) required
page (integer)
per_page (integer)
tickets/get_tickets_by_ticket_id_tasks_by_idView a specific taskticket_id (integer) required
id (integer) required
tickets/put_tickets_by_ticket_id_tasks_by_idUpdate a taskticket_id (integer) required
id (integer) required
data: {
. title (string)
. description (string)
. status (integer)
. due_date (string)
. notify_before (integer)
. group_id (integer)
. agent_id (integer)
} (object) required
tickets/delete_tickets_by_ticket_id_tasks_by_idDelete a taskticket_id (integer) required
id (integer) required
tickets/get_ticket_fieldsList all ticket fieldsNo parameters
tickets/get_tickets_by_ticket_id_csat_responseView CSAT response for a ticketticket_id (integer) required
tickets/put_tickets_by_id_promote_to_major_incidentPromote an incident to a major incidentid (integer) required
tickets/put_tickets_by_id_demote_from_major_incidentDemote an incident from being a major incidentid (integer) required
vendors/get_vendorsList all vendorspage (integer)
per_page (integer)
workspace_id (integer)
vendors/post_vendorsCreate a new vendordata: {
. name (string)
. description (string)
. contact_name (string)
. email (string)
. mobile (string)
. phone (string)
. primary_contact_id (integer)
. address (object)
. custom_fields (object)
. workspace_id (integer)
} (object) required
vendors/get_vendors_by_idView a vendorid (integer) required
vendors/put_vendors_by_idUpdate a vendorid (integer) required
data: {
. name (string)
. description (string)
. contact_name (string)
. email (string)
. mobile (string)
. phone (string)
. primary_contact_id (integer)
. address (object)
. custom_fields (object)
} (object) required
vendors/delete_vendors_by_idDelete a vendorid (integer) required
workspaces/get_workspacesList all workspaces/clientspage (integer)
per_page (integer)
query (string)
workspaces/post_workspacesCreate a workspace/clientdata: {
. name (string)
. description (string)
. custom_fields (object)
} (object) required
workspaces/get_workspaces_by_idView a workspace/clientid (integer) required
workspaces/put_workspaces_by_idUpdate a workspace/clientid (integer) required
data: {
. name (string)
. description (string)
. custom_fields (object)
} (object) required
workspaces/delete_workspaces_by_idDelete a workspace/clientid (integer) required
workspaces/get_workspaces_fieldsList all workspace/client fieldsNo parameters
customCall any endpoint of the connected service while reusing the connection auth. Pass the full URL as _url. Other reserved keys: _method, _query, _body, _headers. Remaining params flow naturally — empty → GET, non-empty → POST JSON body._url (string) required
_method (string)
_query (object)
_body
_headers (object)