For example, if your customer emails your support address, this creates a ticket with the customer as both the requester and submitter. }}, {"subject": "Help! Rate limits in the API introduction. Possible values include ticket , user , organization , or group . This may be different than the requester if the attachments: If example: All of the ticket property keywords can be used in search statements alone, in combination exclusively for ticket data, you can use ticket property keywords. Errors are represented as JSON objects which have the following keys: Returns the number of items matching the query rather than the items. The response is similar to the response of GET /api/v2/search.json?, with a few changes: "https://{subdomain}.zendesk.com/api/v2/search.json", "https://example.zendesk.com/api/v2/groups/1835972.json", "Sorry, we could not complete your search query. searched by the user's ID, their name (partial or full), or their email address, as in these An audit object is generated and included in the response when you update a ticket. The type property returns records of the specified resource type. Properties such as created, updated, and solved can return records for a specific time, on or before a certain time, and on or after a certain time. The search string works the same as a regular search. The me keyword value allows you to search user properties in tickets where External ids don't have to be unique for each ticket. examples: Notice that none of these searches required the ID, or name, or email to be explicitly requesters. The response is always ordered by updated_at in descending order. Due date format uses, The ids of agents or end users currently CC'ed on the ticket. To find tickets that include either of two tags, use: This returns all the tickets that have a custom field with the I have multiple brands for my organization and I need to see a list of all tickets for one brand. Only applicable for channels framework ticket, Write only. All properties are optional. When creating a ticket, use the comment property to set the ticket description, which is also the first comment. a ticket deletion job and returns a payload with the jobs status. This endpoint returns a job_status JSON object and queues a background job to do the work. zendesk connectwise servicenow freshdesk customerthermometer Disclaimer: Zendesk provides this article for instructional purposes only. (text, multi-line text, numeric, decimal, regular expression) can be If the feature is not enabled, the default CC functionality is used. See Searching by date and time in Zendesk help. Please feel free to contact support if this isn't working for you. We can currently search the twitter username which shows as the requester but this is different than the handle that shows under end user information. However, it will be better if you just use the actual Zendesk UI to search for tickets associated with that user. Learn more about dates . Deleting tickets The state of the ticket. In both examples, whomever is the submitter becomes the first comment author. Instead, you simply Examples: Specify the name or ID of an organization. This works for all the user role properties in tickets: You need to use both of the keywords together in a search statement, as in this An array of the IDs of attribute values to be associated with the ticket, Enterprise only. Possible values include new, open, pending, hold, solved, or closed. "me", user name (full name or partial), email address, user ID, or phone number. Pagination for more information. For example, if you created a drop-down list, you can search the name of the ticket form includes multiple words, use quotation Accepts an array of up to 100 ticket objects, or a comma-separated list of up to 100 ticket ids. Datetime of last update received from API. Returns a maximum of 1000 records per page.

The tickets are ordered chronologically by created date, from oldest to newest. "created_at": "2013/01/08 23:24:49 -0800", "description": "Zendesk is the leading ", -v -u {email_address}:{password} -X DELETE, curl https://{subdomain}.zendesk.com/api/v2/tickets/destroy_many.json?ids=1,2,3 \, curl https://{subdomain}.zendesk.com/api/v2/deleted_tickets.json \, curl https://{subdomain}.zendesk.com/api/v2/deleted_tickets/{id}/restore.json, curl https://{subdomain}.zendesk.com/api/v2/deleted_tickets/restore_many?ids={ids}.json, curl https://{subdomain}.zendesk.com/api/v2/deleted_tickets/{id}.json \, -X DELETE -v -u {email_address}:{password}, curl https://{subdomain}.zendesk.com/api/v2/deleted_tickets/destroy_many.json?ids=1,2,3 \, curl https://{subdomain}.zendesk.com/api/v2/tickets/{ticket_id}/collaborators.json \, curl https://{subdomain}.zendesk.com/api/v2/tickets/{ticket_id}/followers.json \, curl https://{subdomain}.zendesk.com/api/v2/tickets/{ticket_id}/email_ccs.json \, curl https://{subdomain}.zendesk.com/api/v2/tickets/12345/incidents.json \. tickets with List of macro IDs to be recorded in the ticket audit, Write only. Returns a list of tickets where the custom

By default, tickets are sorted by id from smallest to largest. Can we set it as a custom search? Learn more about the operators. ticket attachments, Searching for You can specify the text parameter in the request body rather than the query string. Because a search string is sent in a HTTP request, the string must be url-encoded. This operation can't be undone.

described in the following table. Exception: If the ticket is created as a follow-up ticket (i.e., if the ticket is created using via_followup_source_id), then any submitter_id attribute is ignored. Double quotes, "" , are used for search phrases. This endpoint returns a job_status JSON object and queues a background job to do the work. zendesk beanstalk This value "12345.". include a tag to indicate that the user has clicked the checkbox. See the, POST requests only. The result set is ordered only by the created_at attribute. this: This works with all of the ticket user roles: submitter, The request takes a data object with the following properties: The comments are optional but strongly recommended. zendesk tab The urgency with which the ticket should be addressed. Topics covered: For the reference doc, see Ticketing - Search API . When I need this today, I noticed the wildcard syntax * doesn't work for date fields, nor the negation. You'll also need to download and install the following modules if you don't already have them: "https://{subdomain}.zendesk.com/api/v2/search.json?query=type%3Aticket+status%3Aopen", "https://{subdomain}.zendesk.com/api/v2/search.json", 'https://{subdomain}.zendesk.com/api/v2/search.json?

the quotation marks. for the tags assigned to each list box item. All tickets have a core set of properties. Other operators include < and > , the minus sign - , and the wildcard character * . Metadata for the audit. :), HeyO CJ Johnson - if you're seeing results that differ from our documentation, please contact Support to look into that further, About that "wildcard search on values for specific custom fields as documented today:" The article is still not correct here. ticket field with ID 1413 is used, and not

I could try all combinations for all field types (text, date, tagger, etc) and summarize it - but maybe someone from Zendesk could just look into this, then update the article with the correct answers with the nuances needed? Otherwise, the value is false. Please refer to the article below: https://support.zendesk.com/hc/en-us/articles/217385687-Using-Zendesk-Support-advanced-search#topic_v5y_pp3_y5. Is there a way to search for tickets created in a certain date range but only find tickets that were modified before or after certain times of day? You can combine these keyword search statements to narrow your results even ", "comment": { "body": "The smoke is very colorful." name or partial), email address, user ID, or phone number. This endpoint returns a job_status JSON object and queues a background job to do the work. "description": "The fire is very colorful.". example: Search for all tickets with or without attachments using. If new resources don't appear in your search results, wait a few minutes and try again. You can delete 400 tickets every 1 minute using this endpoint. Optional boolean. search for all tickets without The results includes all deleted (and not yet archived) tickets that For "message": "Completed at 2018-03-08 10:07:04 +0000", "url": "https://example.zendesk.com/api/v2/job_statuses/82de0b0467893ac9fe64f1a99.json", -d '{"ticket": {"status": "open", "comment": { "body": "The smoke is very colorful. Merges one or more tickets into the ticket with the specified id. Alternatively, if you only want incremental changes based on the most recent change, consider using one of the Incremental Export endpoints. The roles that can be used on searching tickets are only for the user roles in the actual ticket, ie, submitter, requester and assignee. Use the Show Job Status endpoint to check for the job's completion. Currently search operators only exist to match a specific text string to a text field entry and to search for the presence of a specific tag value from a custom field. See Soft delete When making requests beyond page 100, you can make 5 requests every 1 minute. Allowed values are "new", "open", "pending", "hold", "solved", or "closed". fieldvalue keyword. Users to add as cc's when creating a ticket. You can make 10 requests every 1 minute using this endpoint. in the Support Help Center for ticket merging rules. As a result, the request may return multiple tickets with the same external id. Possible values include ticket, user, organization, or group. In the, The organization of the requester. See, Write only.

Please help! There isn't a property keyword for the ticket ID. Edit: The culprit this time turned out to be that the ticket fields page, adds a space to the id when you copy it, even though it doesn't look like it when you highlight the number. You can search for a ticket form and get results for all tickets where that ticket form is People who have been CC'd on tickets. See, Write only. @we've been working on a Zendesk search app lately and we're planning to add filters for tickets that have multiple-responses soon.The app is available on Zendesk's apps marketplace and you can give it a free try here. with other ticket property keywords, or with the type keyword (see Using See Setting metadata. You can use the following keywords when searching for ticket attachments. As Abraham K. from Zendesk said. Please try again in a moment. Lists tickets by external id. If you want to sort the results too, add the extra parameters to the hash: Define the search URL as a new URI object: Use the object's query_form() method to url-encode the parameters and add them to the URL as a query string: Finally, create a user agent and make the request: Below is an example script. The syntax gives you a lot of flexibility. You specify search queries in a URL parameter named query: /api/v2/search.json?query={search_string}. To do so, include the additional_tags or remove_tags property in the ticket object. The text in the ticket's description and comments. twitter_fav), twitter (from any Twitter method including direct message and If the count exceeds 100,000, it is updated every 24 hours. Returns a number of ticket properties though not the ticket comments. tags keyword. For more information on cursor-based pagination, see the following articles: This API endpoint is rate-limited to 100 requests per minute per account. You can use brand as a search criteria (look for "Nordstrom" in the article above), but creating Views for each brand will probably save you time in the long run. You can define filters to narrow your search results according to resource type, dates, and object properties, such as ticket requester or tag. You can specify "none", "me", user name (full ccd lists tickets that the specified user is cc'd on. Your best bet in that case would be taking advantage of the Advanced Search feature which allows you to get more granular I.E. See Creating custom roles and assigning agents (Enterprise) For That would be great! Hi Team, is there a way to search for tickets that have multiple responses?

If the job succeeds, the ticket is permanently deleted. Export Search Results endpoint, which To use the API with Python or Perl, see Searching with the Zendesk API. I'm going bananas trying to exclude tickets where a custom field is blank, nothing seems to work. See, An id you can use to link Zendesk Support tickets to local records, The ids of agents currently following the ticket. search for the ticket by its ID number in the following format: The date, or date and time, the ticket was created. To learn how, see Paginating through lists . support request form to collect demographic information such as age, To search for The value is null for plan types that don't support CSAT, The ids of the sharing agreements used for this ticket. See. "12345.". This works fine if you don't include a space. Use the Tickets API described in the rest of this document to let agents and admins manage tickets. The value of the subject field for this ticket, The user who submitted the ticket. Zendesk recommends that you obey the Retry-After header values. You can also use the Export Search Results endpoint. The syntax gives you a lot of flexibility. For examples, see Searching with the Zendesk API. Example: Important: Do not use the description property to set the first comment. requester, and assignee. Is true if a ticket is a problem type and has one or more incidents linked to it. 2. sort by requester names so I could at least have a chance of counting through when same names are shows in clusters. Any of the sources or target tickets are private, Any of the sources or target tickets were created through Twitter, Facebook or the Channel framework. This endpoint enqueues a ticket deletion job and returns a payload with the jobs status. Learn more about types . Search for a specific brand on a ticket using the brand name or the See, Write only. Agents in the Enterprise account must have merge permissions. Look for Ticket:Brand in the list of criteria when creating your View for more information, see Creating views to manage ticket workflow. tickets by telephone number, Searching for Additionally when you make a search you can filter by Subject so if the requester is making several tickets with repetitive messages it would be an easy way to isolate the tickets you wish to see. A ticket must have an assignee in order to be solved. The data is appended to the URL with a '?' To soft delete tickets, use the Bulk Delete Tickets endpoint. Is there a way to sort by requester? Ids of tickets to merge into the target ticket, Private comment to add to the target ticket, Private comment to add to the source ticket, Whether comment in target ticket is public or private, Whether comment in source tickets are public or private, Related topic in the Web portal (deprecated feature), Is true if the current ticket is archived, Twitter information associated with the ticket.

Sitemap 52