Appearance

List Attachments ​

Endpoint ​

http
GET /unified/ticketing/attachments
Integrations supported
  • Accelo
  • Asana
  • Azure DevOps
  • Bitbucket
  • Freshdesk
  • Gorgias
  • Help Scout
  • Helpshift
  • Hive
  • HubSpot
  • Intercom
  • Jira
  • Linear
  • LiveChat
  • Microsoft Planner
  • Monday.com
  • Pivotal Tracker
  • Quickbase for Project Management
  • Salesforce
  • Shortcut
  • Teamwork Project Management
  • Todoist
  • Trello
  • Wrike
  • YouTrack
  • Zendesk
  • Zoho Desk
  • Zoho Projects
Partial response integrations

For partial response integrations, you will need to fetch the individual resource using the "get" endpoint to get the full response object.

  • HubSpot
  • Microsoft Planner
  • Salesforce

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 will return the response with unified mappings applied.
  • raw will return the raw response from the remote API.
  • normalized will apply the unified mappings and return the data in a normalized format.

Defaults to unified.

All possible enum values:
  • unified
  • raw
  • normalized
Example: unified
truto_key_by
string

By default the result attribute is an array of objects. This parameter allows you to specify a field in each result objects to use as key, which transforms the result array into an object with the array items keyed by the field. This is useful for when you want to use the result as a lookup table.

Example: id
truto_ignore_limit
boolean

Ignores the limit query parameter.

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
ticket
object
Integration specific notes
  • Help ScoutTicket associated with the attachments
  • BitbucketThe unique identifier for a ticket
  • Pivotal TrackerSet either ticket or collections.
  • TodoistEither ticket or collections is required.
Required in
  • Asana
  • Azure DevOps
  • Bitbucket
  • Freshdesk
  • Gorgias
  • Help Scout
  • Helpshift
  • Hive
  • HubSpot
  • Intercom
  • Jira
  • Linear
  • LiveChat
  • Microsoft Planner
  • Monday.com
  • Salesforce
  • Teamwork Project Management
  • Trello
  • Wrike
  • YouTrack
  • Zendesk
  • Zoho Desk
  • Zoho Projects
Supported in
  • Pivotal Tracker
  • Todoist
id
string
REQUIRED · 
workspace
object

The unique identifier for a workspace

Required in
  • Azure DevOps
  • Bitbucket
  • Zoho Projects
collections
array
Integration specific notes
  • BitbucketThe unique identifier for a ticket
  • Pivotal TrackerCollection with type epic is required.
  • TodoistEither ticket or collections is required.
Required in
  • Bitbucket
Supported in
  • Pivotal Tracker
  • Todoist
id
string

The unique identifier for a collection.

comment
Supported in
  • Accelo
organization
object
Supported in
  • Zoho Projects
id
string

The unique identifier for a organization.

ticket_type
All possible enum values:
  • issue
  • task
Required in
  • Zoho Projects
conversations
Required in
  • HubSpot

Response Body ​

result
object[]

List of Attachments

id
string

The unique identifier for the attachment

Supported in
  • Accelo
  • Asana
  • Azure DevOps
  • Bitbucket
  • Freshdesk
  • Gorgias
  • Help Scout
  • Helpshift
  • Hive
  • HubSpot
  • Intercom
  • Jira
  • Linear
  • LiveChat
  • Microsoft Planner
  • Monday.com
  • Pivotal Tracker
  • Quickbase for Project Management
  • Salesforce
  • Shortcut
  • Teamwork Project Management
  • Todoist
  • Trello
  • Wrike
  • YouTrack
  • Zendesk
  • Zoho Desk
  • Zoho Projects
file_name
string

The attachment's name.

Supported in
  • Accelo
  • Asana
  • Azure DevOps
  • Bitbucket
  • Freshdesk
  • Gorgias
  • Help Scout
  • Helpshift
  • Hive
  • Intercom
  • Jira
  • Linear
  • LiveChat
  • Microsoft Planner
  • Monday.com
  • Pivotal Tracker
  • Shortcut
  • Teamwork Project Management
  • Todoist
  • Trello
  • Wrike
  • YouTrack
  • Zendesk
  • Zoho Desk
  • Zoho Projects
ticket_id
string

The ticket id to which the attachment belongs

Supported in
  • Asana
  • Azure DevOps
  • Bitbucket
  • Freshdesk
  • Gorgias
  • Helpshift
  • Hive
  • Intercom
  • Jira
  • Linear
  • LiveChat
  • Monday.com
  • Salesforce
  • Shortcut
  • Teamwork Project Management
  • Todoist
  • Trello
  • Wrike
  • YouTrack
  • Zendesk
  • Zoho Desk
  • Zoho Projects
size
number

The file size in bytes

Supported in
  • Accelo
  • Asana
  • Azure DevOps
  • Freshdesk
  • Gorgias
  • Help Scout
  • Helpshift
  • Intercom
  • Jira
  • LiveChat
  • Monday.com
  • Pivotal Tracker
  • Todoist
  • Trello
  • Wrike
  • Zoho Desk
  • Zoho Projects
file_url
string

The URL to download the attachment

Supported in
  • Accelo
  • Asana
  • Azure DevOps
  • Bitbucket
  • Freshdesk
  • Gorgias
  • Help Scout
  • Helpshift
  • Hive
  • Intercom
  • Jira
  • Linear
  • LiveChat
  • Monday.com
  • Pivotal Tracker
  • Shortcut
  • Teamwork Project Management
  • Todoist
  • Trello
  • Wrike
  • YouTrack
  • Zendesk
  • Zoho Desk
  • Zoho Projects
content_type
string

The content type of the attachment

Supported in
  • Accelo
  • Asana
  • Azure DevOps
  • Freshdesk
  • Gorgias
  • Help Scout
  • Helpshift
  • Hive
  • Intercom
  • Jira
  • Linear
  • LiveChat
  • Microsoft Planner
  • Monday.com
  • Pivotal Tracker
  • Shortcut
  • Teamwork Project Management
  • Todoist
  • Trello
  • Wrike
  • YouTrack
  • Zendesk
  • Zoho Desk
  • Zoho Projects
uploaded_by
string

The user who uploaded the attachment

Supported in
  • Accelo
  • Hive
  • Jira
  • LiveChat
  • Monday.com
  • Pivotal Tracker
  • Shortcut
  • Wrike
  • YouTrack
  • Zoho Desk
  • Zoho Projects
uploaded_by_type
string

The type of the user who uploaded the attachment

Supported in
  • Shortcut
created_at
string · date-time

The time when the attachment was created

Supported in
  • Accelo
  • Asana
  • Azure DevOps
  • Freshdesk
  • Hive
  • Jira
  • LiveChat
  • Monday.com
  • Pivotal Tracker
  • Shortcut
  • Trello
  • Wrike
  • YouTrack
  • Zoho Desk
  • Zoho Projects
updated_at
string · date-time

The time when the attachment was updated

Supported in
  • Azure DevOps
  • Freshdesk
  • Hive
  • Shortcut
  • YouTrack
  • Zoho Projects
etag
string

The unique identifier for the specific version of the resource.

remote_data
object

Raw data returned from the remote API call.

next_cursor
string

The cursor to use for the next page of results. Pass this value as next_cursor in the query parameter in the next request to get the next page of results.