Issues
Get a list of issues
The start time (RFC3339) of the time range to get issues for. The duration between start_time and end_time must be less than or equal to 30 days.
The end time (RFC3339) of the time range to get issues for. The duration between start_time and end_time must be less than or equal to 30 days.
Create a new issue
The account that this issue belongs to.
The user the issue should be assigned to.
An array of attachment URLs to attach to this issue.
The HTML content of the body of the issue.
Timestamp of when the issue was created. If not specified, the current time will be used. (RFC3339)
The priority of the issue. Can be one of: urgent, high, medium, or low.
The URL of an avatar of the requester.
The email of the user that this issue is on behalf of. Include one of requester_id or requester_email to create an issue with a requester.
The requester that this issue is on behalf of. Include one of requester_id or requester_email to create an issue with a requester.
The full name of the user that this issue is on behalf of.
An array of strings to use as tags on this issue. If provided, the issue tags will be updated to the given tags.
The ID of the team this issue should be assigned to.
The title of the issue.
Get an issue by its ID/number
The ID or number of the issue to fetch.
Update an existing issue
The ID of the issue to update.
The ID of the user who should be assigned to this issue. If empty string is passed in, the issue assignee will be removed.
Whether the issue should be visible in the customer portal.
The ID of the requester that this issue is on behalf of.
Deprecated: Use requester_id instead.
The state this issue should be moved to. Can be one of new, waiting_on_you, waiting_on_customer, on_hold, closed, or a custom status.
An array of strings to use as tags on this issue. If provided, the issue tags will be updated to be exactly the given tags.
The ID of the team this issue should be assigned to. If empty string is passed in, any assigned team will be removed.
Delete an existing issue
The ID of the issue to delete.
Currently, the following fields are filterable for issues:
-
created_at (in RFC3339 format). Allowed operators:
time_is_after
,time_is_before
,time_range
-
account_id. Allowed operators:
equals
,in
,not_in
-
ticket_form_id. Allowed operators:
equals
,in
,not_in
-
requester_id. Allowed operators:
equals
,in
,not_in
-
state. Valid values are
["new", "waiting_on_you", "waiting_on_customer", "on_hold", "closed"] or a custom status slug. Allowed operators:
equals,
in,
not_in` -
custom fields (pass in the slug of the custom field)
-
tags (pass in the tag name). Allowed operators:
contains
,does_not_contain
,in
,not_in
-
title. Allowed operators:
string_contains
,string_does_not_contain
-
body_html. Allowed operators:
string_contains
,string_does_not_contain
The cursor to use for pagination.
The number of issues to fetch. Defaults to 100. Must be greater than 0 and less than 1000.
Snooze an issue
The ID or number of the issue to snooze.
The date and time to snooze the issue until. (RFC3339)
Last updated
Was this helpful?