issues

Link or unlink an incident to/from an issue

Changed on

Links an incident from one of the organization's connected incident systems (incident.io or Rootly). An issue can have several linked incidents, and linking one that is already linked has no effect. To unlink, set the operation field to "unlink".

Rate limit: 120 requests per minute

post/issues/{id}/external-incidents

Request

  • Base URL
    https://api.usepylon.com
  • URL
    https://api.usepylon.com/issues/{id}/external-incidents
  • Auth
    HTTP bearer

Path parameters

idstring required

The ID or number of the issue to link the incident to.

Request body

incident_idstring required

The incident's reference (such as INC-123 or ROOT-123) or its ID in the incident system.

operationstring

Operation to perform. Use "link" to link the incident (default) or "unlink" to unlink it.

source'incident_io' | 'rootly' required

The incident system the incident belongs to. It must be connected to the organization. Valid values: "incident_io", "rootly"

Example request

{
  "source": "incident_io"
}

Response

request_idstring required

The request ID for tracking.

Example response

{
  "data": {
    "business_hours_time_in_status_seconds": {
      "new": 120,
      "waiting_on_customer": 1800
    },
    "custom_fields": {
      "priority": {
        "value": "high"
      }
    },
    "state": "new",
    "time_in_status_seconds": {
      "new": 120,
      "waiting_on_customer": 3600
    },
    "workspace_phone_number": "+14155551234"
  }
}

Changes

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property / to the response with the status