The issues namespace provides endpoints to work with issue tracker integrations and their mapped projects. These endpoints are primarily intended to support creating and updating test cases with issue references via the Testmo API.
GET /issues/connections
Returns a list of issue tracker connections and their mapped projects. This endpoint is typically used to retrieve the required IDs when adding issue references to test cases via the POST /cases or PATCH /cases endpoints.
This method uses pagination so you might need to request additional pages to retrieve all results.
Request
page integer
Number of page to return (default: first page)
per_page integer
Maximum number of results to return (supported: 15, 25, 50, 100; default: 100)
integration_id integer
Filter by integration ID.
integration_type integer
Filter by integration type.
integration_name string
Comma-separated list of users to filter by.
connection_id integer
Filer by connection ID.
connection_name string
Filter by connection name.
connection_project_id integer
connection_project_id
connection_project_name string
Filter by connection project name.
is_active boolean
Filter by active or inactive connections
{
"page": {
"type": "integer",
"format": "int64",
"description": "Number of pages to return (default: first page)."
},
"per_page": {
"type": "integer",
"format": "int64",
"enum": [
15,
25,
50,
100
],
"description": "Maximum number of results to return (default: 100)."
},
"sort": {
"type": "string",
"enum": [
"connections:integration_name",
"connections:integration_id",
"connections:connection_id",
"connections:connection_name",
"connections:connection_project_id",
"connections:connection_project_name",
"connections:integration_type",
"connections:is_active",
"connections:created_at",
"connections:updated_at"
],
"default": "connections:integration_name",
"description": "Sort field for the list of connections."
},
"order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"default": "asc",
"description": "Sort order (ascending or descending)."
},
"integration_id": {
"type": "integer",
"description": "Comma-separated list of integration IDs to filter by."
},
"integration_name": {
"type": "string",
"description": "Filter by integration name (partial match)."
},
"connection_id": {
"type": "integer",
"description": "Comma-separated list of connection IDs to filter by."
},
"connection_name": {
"type": "string",
"description": "Filter by connection name (partial match)."
},
"connection_project_id": {
"type": "integer",
"description": "Comma-separated list of connection project IDs to filter by."
},
"connection_project_name": {
"type": "string",
"description": "Filter by connection project name (partial match)."
},
"integration_type": {
"type": "integer",
"description": "Comma-separated list of integration types to filter by."
},
"is_active": {
"type": "boolean",
"description": "Filter by active status (true for active connections, false for inactive)."
}
} Response
Returns a paginated list of issue connections.
{
"page": 1,
"prev_page": null,
"next_page": null,
"last_page": 1,
"per_page": 100,
"total": 2,
"result": [
{
"integration_id": 1010,
"integration_type": 4,
"integration_name": "Jira Integration - Server",
"connection_id": 1001,
"connection_name": "Jira Server",
"connection_project_id": 10002,
"connection_project_name": "Development Tasks",
"is_active": true,
"created_at": "2025-12-18T07:42:31.000Z",
"updated_at": null
}
]
}Examples
// Get active Jira connections
/api/v1/issues/connections?integration_name=Jira&is_active=trueStatus codes
200 401 422 (details)