Issues

Get a list of issues

get

Returns a paginated list of issues within a required time range (max 30 days).

Rate limit: 10 requests per minute

Authorizations

bearerAuth

AuthorizationstringRequired

Authorization: Bearer

Query parameters

start_timestringRequired

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.

end_timestringRequired

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.

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400Error

application/json

404Error

application/json

500Error

application/json

get

/issues

HTTPcURLJavaScriptPython

GET /issues?start_time=text&end_time=text HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "account": {
        "external_ids": [
          {
            "external_id": "text",
            "label": "text"
          }
        ],
        "id": "text"
      },
      "assignee": {
        "email": "text",
        "id": "text"
      },
      "attachment_urls": [
        "text"
      ],
      "author_unverified": true,
      "body_html": "text",
      "business_hours_first_response_seconds": 1,
      "business_hours_resolution_seconds": 1,
      "business_hours_time_in_status_seconds": {
        "ANY_ADDITIONAL_PROPERTY": 1
      },
      "chat_widget_info": {
        "page_url": "text"
      },
      "child_issues": [
        {
          "id": "text",
          "number": 1
        }
      ],
      "created_at": "text",
      "csat_responses": [
        {
          "comment": "text",
          "score": 1
        }
      ],
      "custom_fields": {
        "ANY_ADDITIONAL_PROPERTY": {
          "slug": "text",
          "value": "text",
          "values": [
            "text"
          ]
        }
      },
      "customer_portal_visible": true,
      "external_issues": [
        {
          "external_id": "text",
          "link": "text",
          "source": "text"
        }
      ],
      "first_response_seconds": 1,
      "first_response_time": "text",
      "id": "text",
      "latest_message_time": "text",
      "link": "text",
      "number": 1,
      "number_of_touches": 1,
      "parent_issue_group": {
        "id": "text",
        "number": 1
      },
      "requester": {
        "email": "text",
        "id": "text"
      },
      "resolution_breach_time": "text",
      "resolution_seconds": 1,
      "resolution_time": "text",
      "slack": {
        "channel_id": "text",
        "message_ts": "text",
        "workspace_id": "text"
      },
      "snoozed_until_time": "text",
      "source": "slack",
      "state": "text",
      "tags": [
        "text"
      ],
      "team": {
        "id": "text"
      },
      "time_in_status_seconds": {
        "ANY_ADDITIONAL_PROPERTY": 1
      },
      "title": "text",
      "type": "conversation",
      "updated_at": "text"
    }
  ],
  "request_id": "text"
}

Create a new issue

post

Creates a new issue with the specified title and body. Requires either an account_id or requester information.

Rate limit: 10 requests per minute

Authorizations

bearerAuth

AuthorizationstringRequired

Authorization: Bearer

Body

application/json

account_idstringOptional

The account that this issue belongs to.

assignee_idstringOptional

The user the issue should be assigned to.

attachment_urlsstring[]Optional

An array of attachment URLs to attach to this issue.

author_unverifiedbooleanOptional

Whether the requester's identity has NOT been verified. Defaults to false (verified).

body_htmlstringRequired

The HTML content of the body of the issue.

contact_idstringOptional

The contact to attribute the first message to. Makes the message appear as a customer message rather than an internal note. Only one of user_id or contact_id can be provided. Requires destination_metadata.

created_atstringOptional

Timestamp of when the issue was created. If not specified, the current time will be used. (RFC3339)

prioritystringOptional

The priority of the issue. Can be one of: urgent, high, medium, or low.

requester_avatar_urlstringOptional

The URL of an avatar of the requester.

requester_emailstringOptional

The email of the contact this issue is on behalf of. If no matching contact exists, one will be created. Include one of requester_id or requester_email.

requester_idstringOptional

The contact this issue is on behalf of. Sets the "Requester" shown in the issue sidebar. Include one of requester_id or requester_email.

requester_namestringOptional

The full name of the requester. Used when creating a new contact via requester_email.

tagsstring[]Optional

An array of strings to use as tags on this issue. If provided, the issue tags will be updated to the given tags.

team_idstringOptional

The ID of the team this issue should be assigned to.

titlestringRequired

The title of the issue.

user_idstringOptional

The internal user to attribute the first message to. Only one of user_id or contact_id can be provided. If neither is set, the API token's user is used.

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400Error

application/json

404Error

application/json

500Error

application/json

post

/issues

HTTPcURLJavaScriptPython

POST /issues HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 680

{
  "account_id": "text",
  "assignee_id": "text",
  "attachment_urls": [
    "text"
  ],
  "author_unverified": true,
  "body_html": "text",
  "contact_id": "text",
  "created_at": "text",
  "custom_fields": [
    {
      "slug": "text",
      "value": "text",
      "values": [
        "text"
      ]
    }
  ],
  "destination_metadata": {
    "chat_widget_app_id": "text",
    "destination": "slack",
    "email": "text",
    "email_bccs": [
      "text"
    ],
    "email_ccs": [
      "text"
    ],
    "from_sms_phone_number_id": "text",
    "whatsapp_app_id": "text",
    "whatsapp_message_template_language": "text",
    "whatsapp_message_template_name": "text"
  },
  "priority": "text",
  "requester_avatar_url": "text",
  "requester_email": "text",
  "requester_id": "text",
  "requester_name": "text",
  "tags": [
    "text"
  ],
  "team_id": "text",
  "title": "text",
  "user_id": "text"
}

{
  "data": {
    "account": {
      "external_ids": [
        {
          "external_id": "text",
          "label": "text"
        }
      ],
      "id": "text"
    },
    "assignee": {
      "email": "text",
      "id": "text"
    },
    "attachment_urls": [
      "text"
    ],
    "author_unverified": true,
    "body_html": "text",
    "business_hours_first_response_seconds": 1,
    "business_hours_resolution_seconds": 1,
    "business_hours_time_in_status_seconds": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "chat_widget_info": {
      "page_url": "text"
    },
    "child_issues": [
      {
        "id": "text",
        "number": 1
      }
    ],
    "created_at": "text",
    "csat_responses": [
      {
        "comment": "text",
        "score": 1
      }
    ],
    "custom_fields": {
      "ANY_ADDITIONAL_PROPERTY": {
        "slug": "text",
        "value": "text",
        "values": [
          "text"
        ]
      }
    },
    "customer_portal_visible": true,
    "external_issues": [
      {
        "external_id": "text",
        "link": "text",
        "source": "text"
      }
    ],
    "first_response_seconds": 1,
    "first_response_time": "text",
    "id": "text",
    "latest_message_time": "text",
    "link": "text",
    "number": 1,
    "number_of_touches": 1,
    "parent_issue_group": {
      "id": "text",
      "number": 1
    },
    "requester": {
      "email": "text",
      "id": "text"
    },
    "resolution_breach_time": "text",
    "resolution_seconds": 1,
    "resolution_time": "text",
    "slack": {
      "channel_id": "text",
      "message_ts": "text",
      "workspace_id": "text"
    },
    "snoozed_until_time": "text",
    "source": "slack",
    "state": "text",
    "tags": [
      "text"
    ],
    "team": {
      "id": "text"
    },
    "time_in_status_seconds": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "title": "text",
    "type": "conversation",
    "updated_at": "text"
  },
  "request_id": "text"
}

Get an issue by its ID/number

get

Returns a single issue by ID or issue number.

Rate limit: 60 requests per minute

Authorizations

bearerAuth

AuthorizationstringRequired

Authorization: Bearer

Path parameters

idstringRequired

The ID or number of the issue to fetch.

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400Error

application/json

404Error

application/json

500Error

application/json

get

/issues/{id}

HTTPcURLJavaScriptPython

GET /issues/{id} HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": {
    "account": {
      "external_ids": [
        {
          "external_id": "text",
          "label": "text"
        }
      ],
      "id": "text"
    },
    "assignee": {
      "email": "text",
      "id": "text"
    },
    "attachment_urls": [
      "text"
    ],
    "author_unverified": true,
    "body_html": "text",
    "business_hours_first_response_seconds": 1,
    "business_hours_resolution_seconds": 1,
    "business_hours_time_in_status_seconds": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "chat_widget_info": {
      "page_url": "text"
    },
    "child_issues": [
      {
        "id": "text",
        "number": 1
      }
    ],
    "created_at": "text",
    "csat_responses": [
      {
        "comment": "text",
        "score": 1
      }
    ],
    "custom_fields": {
      "ANY_ADDITIONAL_PROPERTY": {
        "slug": "text",
        "value": "text",
        "values": [
          "text"
        ]
      }
    },
    "customer_portal_visible": true,
    "external_issues": [
      {
        "external_id": "text",
        "link": "text",
        "source": "text"
      }
    ],
    "first_response_seconds": 1,
    "first_response_time": "text",
    "id": "text",
    "latest_message_time": "text",
    "link": "text",
    "number": 1,
    "number_of_touches": 1,
    "parent_issue_group": {
      "id": "text",
      "number": 1
    },
    "requester": {
      "email": "text",
      "id": "text"
    },
    "resolution_breach_time": "text",
    "resolution_seconds": 1,
    "resolution_time": "text",
    "slack": {
      "channel_id": "text",
      "message_ts": "text",
      "workspace_id": "text"
    },
    "snoozed_until_time": "text",
    "source": "slack",
    "state": "text",
    "tags": [
      "text"
    ],
    "team": {
      "id": "text"
    },
    "time_in_status_seconds": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "title": "text",
    "type": "conversation",
    "updated_at": "text"
  },
  "request_id": "text"
}

Update an existing issue

patch

Updates an existing issue. Only provided fields are modified.

Rate limit: 20 requests per minute

Authorizations

bearerAuth

AuthorizationstringRequired

Authorization: Bearer

Path parameters

idstringRequired

The ID of the issue to update.

Body

application/json

account_idstringOptional

The ID of the account that this issue belongs to.

assignee_idstringOptional

The ID of the user who should be assigned to this issue. If empty string is passed in, the issue assignee will be removed.

customer_portal_visiblebooleanOptional

Whether the issue should be visible in the customer portal.

requester_idstringOptional

The ID of the requester that this issue is on behalf of.

requestor_idstringOptional

Deprecated: Use requester_id instead.

statestringOptional

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.

tagsstring[]Optional

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.

team_idstringOptional

The ID of the team this issue should be assigned to. If empty string is passed in, any assigned team will be removed.

titlestringOptional

The title of the issue.

typestring · enumOptional

The type of the issue. Set to "ticket" to upgrade a conversation to a support ticket. Cannot be downgraded from "ticket" to "conversation".

conversation: A conversation.

ticket: A support ticket.

Possible values:

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400Error

application/json

404Error

application/json

500Error

application/json

patch

/issues/{id}

HTTPcURLJavaScriptPython

PATCH /issues/{id} HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 269

{
  "account_id": "text",
  "assignee_id": "text",
  "custom_fields": [
    {
      "slug": "text",
      "value": "text",
      "values": [
        "text"
      ]
    }
  ],
  "customer_portal_visible": true,
  "requester_id": "text",
  "requestor_id": "text",
  "state": "text",
  "tags": [
    "text"
  ],
  "team_id": "text",
  "title": "text",
  "type": "conversation"
}

{
  "data": {
    "account": {
      "external_ids": [
        {
          "external_id": "text",
          "label": "text"
        }
      ],
      "id": "text"
    },
    "assignee": {
      "email": "text",
      "id": "text"
    },
    "attachment_urls": [
      "text"
    ],
    "author_unverified": true,
    "body_html": "text",
    "business_hours_first_response_seconds": 1,
    "business_hours_resolution_seconds": 1,
    "business_hours_time_in_status_seconds": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "chat_widget_info": {
      "page_url": "text"
    },
    "child_issues": [
      {
        "id": "text",
        "number": 1
      }
    ],
    "created_at": "text",
    "csat_responses": [
      {
        "comment": "text",
        "score": 1
      }
    ],
    "custom_fields": {
      "ANY_ADDITIONAL_PROPERTY": {
        "slug": "text",
        "value": "text",
        "values": [
          "text"
        ]
      }
    },
    "customer_portal_visible": true,
    "external_issues": [
      {
        "external_id": "text",
        "link": "text",
        "source": "text"
      }
    ],
    "first_response_seconds": 1,
    "first_response_time": "text",
    "id": "text",
    "latest_message_time": "text",
    "link": "text",
    "number": 1,
    "number_of_touches": 1,
    "parent_issue_group": {
      "id": "text",
      "number": 1
    },
    "requester": {
      "email": "text",
      "id": "text"
    },
    "resolution_breach_time": "text",
    "resolution_seconds": 1,
    "resolution_time": "text",
    "slack": {
      "channel_id": "text",
      "message_ts": "text",
      "workspace_id": "text"
    },
    "snoozed_until_time": "text",
    "source": "slack",
    "state": "text",
    "tags": [
      "text"
    ],
    "team": {
      "id": "text"
    },
    "time_in_status_seconds": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "title": "text",
    "type": "conversation",
    "updated_at": "text"
  },
  "request_id": "text"
}

Delete an existing issue

delete

Permanently deletes an issue by ID.

Rate limit: 20 requests per minute

Authorizations

bearerAuth

AuthorizationstringRequired

Authorization: Bearer

Path parameters

idstringRequired

The ID of the issue to delete.

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

delete

/issues/{id}

HTTPcURLJavaScriptPython

DELETE /issues/{id} HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

{
  "request_id": "text"
}

Search for issues by a given filter

post

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, is_set, is_unset

• ticket_form_id. Allowed operators: equals, in, not_in, is_set, is_unset

• requester_id. Allowed operators: equals, in, not_in, is_set, is_unset

• follower_user_id. Allowed operators: equals, in, not_in

• follower_contact_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

• assignee_id. Allowed operators: equals, in, not_in, is_set, is_unset

• team_id. Allowed operators: equals, in, not_in

• issue_type. Valid values are ["conversation", "ticket"]. Allowed operators: equals, in, not_in, is_set, is_unset

• resolved_at. Allowed operators: time_is_after, time_is_before, time_range

• latest_message_activity_at. Allowed operators: time_is_after, time_is_before, time_range

• updated_at (in RFC3339 format). Allowed operators: time_is_after, time_is_before, time_range

Rate limit: 20 requests per minute

Authorizations

bearerAuth

AuthorizationstringRequired

Authorization: Bearer

Body

application/json

cursorstringOptional

The cursor to use for pagination.

limitinteger · int64Optional

The number of issues to fetch. Defaults to 100. Must be greater than 0 and less than 1000.

search_textstringOptional

Fuzzy text search. Results are intersected with any provided filter.

Responses

200Success

application/json

request_idstringOptional

400Error

application/json

404Error

application/json

500Error

application/json

post

/issues/search

HTTPcURLJavaScriptPython

POST /issues/search HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 333

{
  "cursor": "text",
  "filter": {
    "field": "text",
    "operator": "equals",
    "subfilters": [
      {
        "field": "text",
        "operator": "equals",
        "subfilters": [
          {
            "field": "text",
            "operator": "equals",
            "subfilters": "[Circular Reference]",
            "value": "text",
            "values": [
              "text"
            ]
          }
        ],
        "value": "text",
        "values": [
          "text"
        ]
      }
    ],
    "value": "text",
    "values": [
      "text"
    ]
  },
  "limit": 1,
  "search_text": "text"
}

{
  "data": [
    {
      "account": {
        "external_ids": [
          {
            "external_id": "text",
            "label": "text"
          }
        ],
        "id": "text"
      },
      "assignee": {
        "email": "text",
        "id": "text"
      },
      "attachment_urls": [
        "text"
      ],
      "author_unverified": true,
      "body_html": "text",
      "business_hours_first_response_seconds": 1,
      "business_hours_resolution_seconds": 1,
      "business_hours_time_in_status_seconds": {
        "ANY_ADDITIONAL_PROPERTY": 1
      },
      "chat_widget_info": {
        "page_url": "text"
      },
      "child_issues": [
        {
          "id": "text",
          "number": 1
        }
      ],
      "created_at": "text",
      "csat_responses": [
        {
          "comment": "text",
          "score": 1
        }
      ],
      "custom_fields": {
        "ANY_ADDITIONAL_PROPERTY": {
          "slug": "text",
          "value": "text",
          "values": [
            "text"
          ]
        }
      },
      "customer_portal_visible": true,
      "external_issues": [
        {
          "external_id": "text",
          "link": "text",
          "source": "text"
        }
      ],
      "first_response_seconds": 1,
      "first_response_time": "text",
      "id": "text",
      "latest_message_time": "text",
      "link": "text",
      "number": 1,
      "number_of_touches": 1,
      "parent_issue_group": {
        "id": "text",
        "number": 1
      },
      "requester": {
        "email": "text",
        "id": "text"
      },
      "resolution_breach_time": "text",
      "resolution_seconds": 1,
      "resolution_time": "text",
      "slack": {
        "channel_id": "text",
        "message_ts": "text",
        "workspace_id": "text"
      },
      "snoozed_until_time": "text",
      "source": "slack",
      "state": "text",
      "tags": [
        "text"
      ],
      "team": {
        "id": "text"
      },
      "time_in_status_seconds": {
        "ANY_ADDITIONAL_PROPERTY": 1
      },
      "title": "text",
      "type": "conversation",
      "updated_at": "text"
    }
  ],
  "pagination": {
    "cursor": "text",
    "has_next_page": true
  },
  "request_id": "text"
}

Snooze an issue

post

Snoozes an issue until the specified date and time.

Rate limit: 20 requests per minute

Authorizations

bearerAuth

AuthorizationstringRequired

Authorization: Bearer

Path parameters

idstringRequired

The ID or number of the issue to snooze.

Body

application/json

snooze_untilstringRequired

The date and time to snooze the issue until. (RFC3339)

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400Error

application/json

404Error

application/json

500Error

application/json

post

/issues/{id}/snooze

HTTPcURLJavaScriptPython

POST /issues/{id}/snooze HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "snooze_until": "text"
}

{
  "data": {
    "account": {
      "external_ids": [
        {
          "external_id": "text",
          "label": "text"
        }
      ],
      "id": "text"
    },
    "assignee": {
      "email": "text",
      "id": "text"
    },
    "attachment_urls": [
      "text"
    ],
    "author_unverified": true,
    "body_html": "text",
    "business_hours_first_response_seconds": 1,
    "business_hours_resolution_seconds": 1,
    "business_hours_time_in_status_seconds": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "chat_widget_info": {
      "page_url": "text"
    },
    "child_issues": [
      {
        "id": "text",
        "number": 1
      }
    ],
    "created_at": "text",
    "csat_responses": [
      {
        "comment": "text",
        "score": 1
      }
    ],
    "custom_fields": {
      "ANY_ADDITIONAL_PROPERTY": {
        "slug": "text",
        "value": "text",
        "values": [
          "text"
        ]
      }
    },
    "customer_portal_visible": true,
    "external_issues": [
      {
        "external_id": "text",
        "link": "text",
        "source": "text"
      }
    ],
    "first_response_seconds": 1,
    "first_response_time": "text",
    "id": "text",
    "latest_message_time": "text",
    "link": "text",
    "number": 1,
    "number_of_touches": 1,
    "parent_issue_group": {
      "id": "text",
      "number": 1
    },
    "requester": {
      "email": "text",
      "id": "text"
    },
    "resolution_breach_time": "text",
    "resolution_seconds": 1,
    "resolution_time": "text",
    "slack": {
      "channel_id": "text",
      "message_ts": "text",
      "workspace_id": "text"
    },
    "snoozed_until_time": "text",
    "source": "slack",
    "state": "text",
    "tags": [
      "text"
    ],
    "team": {
      "id": "text"
    },
    "time_in_status_seconds": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "title": "text",
    "type": "conversation",
    "updated_at": "text"
  },
  "request_id": "text"
}

Get followers of an issue

get

Returns the list of followers for the specified issue.

Rate limit: 60 requests per minute

Authorizations

bearerAuth

AuthorizationstringRequired

Authorization: Bearer

Path parameters

idstringRequired

The ID or number of the issue to get followers for.

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400Error

application/json

404Error

application/json

500Error

application/json

get

/issues/{id}/followers

HTTPcURLJavaScriptPython

GET /issues/{id}/followers HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "text",
      "type": "user"
    }
  ],
  "request_id": "text"
}

Add or remove followers to/from an issue

post

By default, adds followers. To remove followers, set the operation field to "remove".

Rate limit: 20 requests per minute

Authorizations

bearerAuth

AuthorizationstringRequired

Authorization: Bearer

Path parameters

idstringRequired

The ID or number of the issue to add followers to.

Body

application/json

contact_idsstring[]Optional

The IDs of contacts to add as followers.

operationstringOptional

Operation to perform. Use "add" to add followers (default) or "remove" to remove followers.

user_idsstring[]Optional

The IDs of users to add as followers.

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400Error

application/json

404Error

application/json

500Error

application/json

post

/issues/{id}/followers

HTTPcURLJavaScriptPython

POST /issues/{id}/followers HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "contact_ids": [
    "text"
  ],
  "operation": "text",
  "user_ids": [
    "text"
  ]
}

{
  "data": [
    {
      "id": "text",
      "type": "user"
    }
  ],
  "request_id": "text"
}

Link or unlink external issues to/from an issue

post

By default, links external issues. To unlink issues, set the operation field to "unlink".

Rate limit: 20 requests per minute

Authorizations

bearerAuth

AuthorizationstringRequired

Authorization: Bearer

Path parameters

idstringRequired

The ID or number of the issue to link external issues to.

Body

application/json

external_issue_idstringRequired

The ID of the external issue in the source system.

operationstringOptional

Operation to perform. Use "link" to link issues (default) or "unlink" to unlink issues.

sourcestringRequired

The source system of the external issue (e.g., "linear", "asana", "jira", "github", "shortcut").

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400Error

application/json

404Error

application/json

500Error

application/json

post

/issues/{id}/external-issues

HTTPcURLJavaScriptPython

POST /issues/{id}/external-issues HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "external_issue_id": "text",
  "operation": "text",
  "source": "text"
}

{
  "data": {
    "account": {
      "external_ids": [
        {
          "external_id": "text",
          "label": "text"
        }
      ],
      "id": "text"
    },
    "assignee": {
      "email": "text",
      "id": "text"
    },
    "attachment_urls": [
      "text"
    ],
    "author_unverified": true,
    "body_html": "text",
    "business_hours_first_response_seconds": 1,
    "business_hours_resolution_seconds": 1,
    "business_hours_time_in_status_seconds": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "chat_widget_info": {
      "page_url": "text"
    },
    "child_issues": [
      {
        "id": "text",
        "number": 1
      }
    ],
    "created_at": "text",
    "csat_responses": [
      {
        "comment": "text",
        "score": 1
      }
    ],
    "custom_fields": {
      "ANY_ADDITIONAL_PROPERTY": {
        "slug": "text",
        "value": "text",
        "values": [
          "text"
        ]
      }
    },
    "customer_portal_visible": true,
    "external_issues": [
      {
        "external_id": "text",
        "link": "text",
        "source": "text"
      }
    ],
    "first_response_seconds": 1,
    "first_response_time": "text",
    "id": "text",
    "latest_message_time": "text",
    "link": "text",
    "number": 1,
    "number_of_touches": 1,
    "parent_issue_group": {
      "id": "text",
      "number": 1
    },
    "requester": {
      "email": "text",
      "id": "text"
    },
    "resolution_breach_time": "text",
    "resolution_seconds": 1,
    "resolution_time": "text",
    "slack": {
      "channel_id": "text",
      "message_ts": "text",
      "workspace_id": "text"
    },
    "snoozed_until_time": "text",
    "source": "slack",
    "state": "text",
    "tags": [
      "text"
    ],
    "team": {
      "id": "text"
    },
    "time_in_status_seconds": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "title": "text",
    "type": "conversation",
    "updated_at": "text"
  },
  "request_id": "text"
}

Note: utilizing external issues endpoint will update the ticket status to whatever is set in the apps directory page. Please see screenshot below.

Note: utilizing external issues endpoint will update the ticket status to whatever is set in the apps directory page. Please see screenshot below.