GET /api/v2/autocomplete/tags
Returns an array of registered and recent tag names that start with the characters specified in the name query parameter. This includes tags where any word within the tag (separated by underscores, hyphens, spaces, or other punctuation) starts with the specified characters. You must specify at least 2 characters.
How tag matching works
When tags contain delimiters like underscores, hyphens, or spaces, each word is indexed separately. A tag matches if the tag itself or any word within it starts with your search term.
For example, searching for trig will match the tag set_by_this_trigger because one of its words ("trigger") starts with "trig". However, searching for rigger won't match this tag because neither the full tag nor any of its individual words ("set", "by", "this", "trigger") start with "rigger".
Autocomplete limitations
Autocomplete returns up to 15 suggestions from the most commonly used ticket tags in the last 60 days. Tags that match the prefix but aren't in that top set won't appear in the results.
Pagination
- Offset pagination only
See Using Offset Pagination.
Allowed For
- Agents
Servers
- https://{subdomain}.{domain}.com
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
name |
String | No |
A substring of a tag to search for |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.