Get Collections

Endpoint

http

GET /unified/ticketing/collections/{id}

Integrations supported

Asana
Basecamp
Bitbucket
Dixa
Front
Hive
HubSpot
Jira
Jira Service Management
Linear
Microsoft 365
Microsoft Planner
Monday.com
Pivotal Tracker
Planhat
Productboard
Quickbase for Project Management
Re:amaze
ServiceNow
Shortcut
SolarWinds Service Desk
Teamwork Project Management
Todoist
Trello
Wrike
Zoho Projects

Path parameters

string

REQUIRED ·

The ID of the resource.

Example: 23423523

Query parameters

Refer Specifying query parameters in Truto APIs

integrated_account_id

string · uuid

REQUIRED ·

The ID of the integrated account to use for the request.

Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d

truto_response_format

string

The format of the response.

unified returns the response with unified mappings applied.
raw returns the unprocessed, raw response from the remote API.
normalized applies the unified mappings and returns the data in a normalized format.
stream returns the response as a stream, which is ideal for transmitting large datasets, files, or binary data. Using streaming mode helps to efficiently handle large payloads or real-time data flows without requiring the entire data to be buffered in memory.
debug returns the final unified result alongside raw remote fetch information. The response is an envelope containing result (identical to unified mode output) and debug (with requestUrl, requestOptions, data, responseHeaders, and for list operations: nextCursor, isLooping, isEmptyResult, resultCount). debug is null for static responses or when truto_skip_api_call=true.

Defaults to unified.

All possible enum values:

unified
raw
normalized
stream
debug

Example: unified

truto_ignore_remote_data

boolean

Excludes the remote_data attribute from the response.

truto_exclude_fields

array

Array of fields to exclude from the response.

Example: truto_exclude_fields[]=id&truto_exclude_fields[]=name

remote_query

object

Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.

Example: remote_query[foo]=bar

workspace

string

Integration specific notes

BasecampWorkspace associated with the ticket.
BitbucketThe unique identifier for the workspace

Required in

Basecamp
Bitbucket
Jira Service Management
Zoho Projects

string

The unique identifier for the workspace

name

string

The name of the workspace

type

string

The type of the collection

All possible enum values:

Todoset
component
epic
iteration
kanban_board
milestone
product
project
section
tasklist
version
workflow

Enum support by integration

Basecamp
- Todoset
- kanban_board
Jira
- project
- version
Pivotal Tracker
- project
- epic
Productboard
- component
- product
Shortcut
- project
- epic
- iteration
- workflow
Todoist
- project
- section
Zoho Projects
- tasklist
- milestone

Required in

Basecamp
Jira
Pivotal Tracker
Productboard
Shortcut
Todoist
Zoho Projects

organization

object

Supported in

Zoho Projects

string

The unique identifier for a organization.

Response Body

string

REQUIRED ·

The unique identifier for a collection

Supported in

Asana
Basecamp
Bitbucket
Dixa
Front
Hive
HubSpot
Jira
Jira Service Management
Linear
Microsoft 365
Microsoft Planner
Monday.com
Pivotal Tracker
Planhat
Productboard
Quickbase for Project Management
Re:amaze
ServiceNow
Shortcut
SolarWinds Service Desk
Teamwork Project Management
Todoist
Trello
Wrike
Zoho Projects

name

string

The name of the collection

Supported in

Asana
Basecamp
Bitbucket
Dixa
Front
Hive
HubSpot
Jira
Jira Service Management
Linear
Microsoft 365
Microsoft Planner
Monday.com
Pivotal Tracker
Planhat
Productboard
Re:amaze
ServiceNow
Shortcut
SolarWinds Service Desk
Teamwork Project Management
Todoist
Trello
Wrike
Zoho Projects

description

string

The description of the collection

Supported in

Asana
Basecamp
Bitbucket
Hive
Jira
Linear
Monday.com
Pivotal Tracker
Productboard
ServiceNow
Shortcut
Teamwork Project Management
Wrike

type

string

The type of the collection

Supported in

Asana
Basecamp
Bitbucket
Dixa
Front
HubSpot
Jira
Jira Service Management
Linear
Monday.com
Pivotal Tracker
Re:amaze
ServiceNow
Shortcut
SolarWinds Service Desk
Todoist
Trello
Zoho Projects

parent_collection_id

string

The parent collection id

References: Collections → id

Supported in

Basecamp
Jira
Pivotal Tracker
Productboard
SolarWinds Service Desk
Todoist
Zoho Projects

urls

object[]

The URLs of the collection

Supported in

Basecamp
Bitbucket
Jira
Jira Service Management
Monday.com
Productboard
Re:amaze
SolarWinds Service Desk
Todoist
Wrike
Zoho Projects

url

string

The URL of the collection

workspace

object

References: Workspaces → id

Supported in

Bitbucket
Hive
Microsoft 365
Microsoft Planner
Teamwork Project Management
Zoho Projects

string

The unique identifier for a workspace

name

string

The name of the workspace

created_at

string · date-time

The date and time when the collection was created

Supported in

Basecamp
Bitbucket
Hive
Linear
Pivotal Tracker
Planhat
Productboard
Re:amaze
ServiceNow
Shortcut
Teamwork Project Management
Wrike
Zoho Projects

updated_at

string · date-time

The date and time when the collection was updated

Supported in

Basecamp
Bitbucket
Hive
Linear
Monday.com
Pivotal Tracker
Productboard
Re:amaze
ServiceNow
Shortcut
Teamwork Project Management
Wrike
Zoho Projects

etag

string

The unique identifier for the specific version of the resource.

Supported in

Microsoft 365
Microsoft Planner

entity_type

string

The type of entity that belongs to this collection

All possible enum values:

contact
ticket

Supported in

Dixa
ServiceNow

remote_data

object

Raw data returned from the remote API call.