Search
Search across all tickets in your organization.
The search endpoint lets you find tickets across all boards you have access to. Results are ranked by relevance and filtered by your permissions.
Search Tickets
GET /api/v1/searchRate limit: 100 requests per 60 seconds.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | Search query (1-500 characters) |
| boardIds | string | No | Filter by board IDs (comma-separated) |
| statusIds | string | No | Filter by status IDs (comma-separated) |
| assigneeId | string | No | Filter by assignee ("me" for current user) |
| onlyBlocked | boolean | No | Only tickets with BLOCKED status |
| onlyApprovalRequired | boolean | No | Only tickets in PLANNING (backlog) status |
| cursor | string | No | Pagination cursor from previous response |
| limit | number | No | Results per page (default: 20, max: 50) |
Example Request
GET /api/v1/search?q=login+bug&assigneeId=me&limit=10Example Response
{
"results": [
{
"id": "tkt_abc123",
"displayId": "WEB-42",
"title": "Fix login page styling",
"description": "The login button is misaligned...",
"board": {
"id": "brd_abc123",
"name": "Website Redesign",
"prefix": "WEB"
},
"status": {
"id": "sts_def456",
"name": "In Progress"
},
"assignee": {
"id": "usr_abc123",
"name": "Alex Smith"
},
"priority": "HIGH"
}
],
"cursor": "eyJzY29yZSI6MC44...",
"hasMore": true
}Results only include tickets from boards the current user can access. Customer-role users don't see matches from secret comments.