search_work_packages
Query work packages by free text, refined by project, status, assignee, priority, or dates. Tailor results with sorting, grouping, and field selection.
Instructions
Search work packages by free text, optionally scoped to a project.
Set status to restrict results to a specific OpenProject status. Set open_only=true to return only open work packages. Set assignee_me=true to return only work packages assigned to the current user.
assignee filters by any user (username, id, or "me"). assignee_me takes precedence.
priority filters by priority name or numeric ID (case-insensitive).
Date filters accept YYYY-MM-DD format:
created_on/updated_on/due_on: exact date match
created_between/updated_between/due_between: inclusive date range [start, end] Cannot specify both _on and _between for the same field.
sort_by accepts a list of sort criteria in format "field:direction" (e.g., ["status:desc", "priority:asc"]). Direction defaults to "asc" if omitted. Common sortable fields: id, subject, status, priority, type, assignee, author, created_at, updated_at, start_date, due_date.
group_by accepts a field name to group results by (e.g., "status", "assignee"). Common groupable fields: status, priority, type, assignee, author, version, category.
select restricts each result row to the given fields (e.g. ["id", "subject", "status"]); an invalid name returns the allowed set. Common fields: id, display_id, subject, type, status, priority, assignee, project, version, parent_id, start_date, due_date, estimated_time, spent_time, created_at, updated_at, author, category, description.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes | ||
| due_on | No | ||
| offset | No | ||
| select | No | ||
| status | No | ||
| project | No | ||
| sort_by | No | ||
| assignee | No | ||
| group_by | No | ||
| priority | No | ||
| open_only | No | ||
| created_on | No | ||
| updated_on | No | ||
| assignee_me | No | ||
| due_between | No | ||
| created_between | No | ||
| updated_between | No |