redmine_search_issues
Search and list Redmine issues using filters for subject, project, status, tracker, saved query, and custom fields, with sorting and pagination.
Instructions
Search/list issues with optional filters and pagination.
Args:
query: substring on issue subject (Redmine subject=~ filter).
Empty for unfiltered.
project: optional numeric id or identifier slug.
status: optional id, name, or one of Redmine's special tokens
("open", "closed", "*"). Lower-case tokens are
passed through; named statuses (e.g. "Closed") resolve
via the cache.
tracker: optional tracker id or name ("Bug"), or a comma-separated
list of either ("Bug,Feature"). Names resolve through the schema
cache and are emitted as Redmine's tracker_id. An unresolvable
name returns tracker_not_found rather than dropping the filter —
without this parameter a query for "Bug tickets" is inexpressible and
returns Features/NewApps/Prompts mixed in, with nothing in the
response saying so.
query_id: optional Redmine saved query id (numeric). 0 (default)
means no saved query. It does NOT merge with custom_fields —
the saved query's own filters win and yours are dropped silently —
so passing both returns query_id_conflicts_with_custom_fields
instead of a quietly unfiltered set.
custom_fields: optional mapping of custom field -> value to filter on,
sent as Redmine's cf_<id>=<value>. Keys may be numeric ids or
field names ({"Github Org": "wgtunnel"}); names resolve through
the schema cache. Accepts a dict or a JSON-encoded object. An
unresolvable key returns custom_field_not_found rather than
silently dropping the filter — Redmine ignores unknown filter
params, so a dropped one would return everything in scope and look
like a successful match.
sort: optional Redmine sort spec, forwarded verbatim. Accepts
field[:desc] and comma-separated lists, including custom fields
as cf_<id> (e.g. "cf_5:desc").
limit: page size (capped at 100).
offset: skip the first N results.
Returns {issues, total_count, limit, offset, query}. Each issue's
project object carries identifier (slug) when the project is
known to the cache, so consumers need not map name → slug.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | ||
| limit | No | ||
| query | No | ||
| offset | No | ||
| status | No | ||
| project | No | ||
| tracker | No | ||
| query_id | No | ||
| custom_fields | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |