curl --request POST \
--url https://api.select.dev/v2/ticket-links \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"kind": "ticket",
"srn": "[srn|monitor|orgId:acme:monitorId:4f1c2d8e-9b3a-4c7e-8f21-6d5a0b9e3c47]",
"integration_id": "6b9d1f3a-2c8e-4a5b-9d7f-0e1c2b3a4d5e",
"ticket_id": "ENG-123"
}
'{
"kind": "ticket",
"id": "<string>",
"etag": "<string>",
"srn": "<string>",
"provider": "jira",
"integration_id": "<string>",
"ticket_id": "<string>",
"ticket_url": "<string>",
"create_time": "<string>",
"ticket_key": "<string>",
"ticket_title": "<string>",
"ticket_status": "<string>",
"ticket_assignee": "<string>",
"is_disconnected": false,
"sync_time": "<string>"
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}Link a ticket or URL to a resource
Links either an existing issue in a connected ticketing system (kind: "ticket", the default) or a web address (kind: "url") to a resource. A web address needs no ticketing integration.
curl --request POST \
--url https://api.select.dev/v2/ticket-links \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-tenant-id: <x-tenant-id>' \
--data '
{
"kind": "ticket",
"srn": "[srn|monitor|orgId:acme:monitorId:4f1c2d8e-9b3a-4c7e-8f21-6d5a0b9e3c47]",
"integration_id": "6b9d1f3a-2c8e-4a5b-9d7f-0e1c2b3a4d5e",
"ticket_id": "ENG-123"
}
'{
"kind": "ticket",
"id": "<string>",
"etag": "<string>",
"srn": "<string>",
"provider": "jira",
"integration_id": "<string>",
"ticket_id": "<string>",
"ticket_url": "<string>",
"create_time": "<string>",
"ticket_key": "<string>",
"ticket_title": "<string>",
"ticket_status": "<string>",
"ticket_assignee": "<string>",
"is_disconnected": false,
"sync_time": "<string>"
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}{
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "validation_failed",
"retryable": true,
"type": "about:blank",
"details": [
{}
]
}Authorizations
Organization API key (sl_…).
Headers
The organization ID the request is scoped to.
Body
- TicketLinkCreateTicket
- TicketLinkCreateUrl
Link an issue that already exists in the ticketing system to a resource.
The canonical SELECT Resource Name (SRN) of the resource the issue is linked to. Resolve one from a resource's identifying details with POST /v2/srn/actions/resolve.
1 - 2048Identifier of the ticketing integration the issue belongs to.
The issue to link, given either as its key (ENG-123) or as its identifier in the ticketing system.
Links an existing issue. Defaults to ticket when omitted.
"ticket"Response
Successful Response
- TicketLinkTicket
- TicketLinkUrl
An issue in an external ticketing system, linked to a SELECT resource.
Identifies this link as an issue in a ticketing system.
"ticket"The unique identifier of the link.
Opaque strong ETag for this link. Matches the ETag response header, and changes whenever the mirrored title, status or assignee is refreshed.
The canonical SELECT Resource Name (SRN) of the resource the issue is linked to. Resolve one from a resource's identifying details with POST /v2/srn/actions/resolve.
The ticketing system the issue lives in.
"jira"Identifier of the ticketing integration the issue belongs to.
The issue's identifier in the ticketing system.
Link to the issue in the ticketing system.
When the link was created, as an RFC 3339 UTC timestamp.
The issue's human-readable key, such as ENG-123.
The issue's summary line.
The issue's status in the ticketing system, such as In Progress.
Display name of the person the issue is assigned to.
Whether the issue no longer exists in the ticketing system. A disconnected link stays listed so the loss is visible, and its title, status and assignee stay as they were at the last successful read.
When the issue's title, status and assignee were last read from the ticketing system, as an RFC 3339 UTC timestamp. Those fields reflect the issue as of this time, not necessarily its current state.