OpenProject is the leading open source project management software.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
openproject/docs/api/apiv3/paths/project_queries_default.yml

210 lines
8.3 KiB

# /api/v3/projects/{id}/queries/default
---
get:
parameters:
- description: Id of the project the default query is requested for
example: '1'
in: path
name: id
required: true
schema:
type: integer
- description: |-
JSON specifying filter conditions.
The filters provided as parameters are not applied to the query but are instead used to override the query's persisted filters.
All filters also accepted by the work packages endpoint are accepted. If no filter is to be applied, the client should send an empty array (`[]`).
example: '[{ "assignee": { "operator": "=", "values": ["1", "5"] }" }]'
in: query
name: filters
required: false
schema:
default: '[{ "status_id": { "operator": "o", "values": null }}]'
type: string
- description: Page number inside the queries' result collection of work packages.
example: '25'
in: query
name: offset
required: false
schema:
default: 1
type: integer
- description: Number of elements to display per page for the queries' result collection
of work packages.
example: '25'
in: query
name: pageSize
required: false
schema:
type: integer
- description: JSON specifying sort criteria. The sort criteria is applied to the
query's result collection of work packages overriding the query's persisted
sort criteria.
example: '[["status", "asc"]]'
in: query
name: sortBy
required: false
schema:
default: '["id", "asc"]'
type: string
- description: The column to group by. The grouping criteria is applied to the to
the query's result collection of work packages overriding the query's persisted
group criteria.
example: status
in: query
name: groupBy
required: false
schema:
type: string
- description: Indicates whether properties should be summed up if they support
it. The showSums parameter is applied to the to the query's result collection
of work packages overriding the query's persisted sums property.
example: 'true'
in: query
name: showSums
required: false
schema:
default: 'false'
type: boolean
- description: Indicates whether the timeline should be shown.
example: 'true'
in: query
name: timelineVisible
required: false
schema:
default: 'false'
type: boolean
- description: Indicates whether the hierarchy mode should be enabled.
example: 'true'
in: query
name: showHierarchies
required: false
schema:
default: 'true'
type: boolean
responses:
'200':
content:
application/hal+json:
examples:
response:
value:
_embedded:
results:
_embedded:
elements:
- "<--- shortened for brevity --->"
_links:
changeSize:
href: "/api/v3/projects/42/work_packages?filters=%5B%7B%22status%22%3A%7B%22operator%22%3A%22o%22%2C%22values%22%3A%5B%5D%7D%7D%2C%7B%22dueDate%22%3A%7B%22operator%22%3A%22%3Ct%2B%22%2C%22values%22%3A%5B%221%22%5D%7D%7D%5D&offset=1&pageSize=%7Bsize%7D&sortBy=%5B%5B%22parent%22%2C%22desc%22%5D%5D"
templated: true
createWorkPackage:
href: "/api/v3/work_packages/form"
method: post
createWorkPackageImmediate:
href: "/api/v3/work_packages"
method: post
jumpTo:
href: "/api/v3/projects/42/work_packages?filters=%5B%7B%22status%22%3A%7B%22operator%22%3A%22o%22%2C%22values%22%3A%5B%5D%7D%7D%2C%7B%22dueDate%22%3A%7B%22operator%22%3A%22%3Ct%2B%22%2C%22values%22%3A%5B%221%22%5D%7D%7D%5D&offset=%7Boffset%7D&pageSize=2&sortBy=%5B%5B%22parent%22%2C%22desc%22%5D%5D"
templated: true
self:
href: "/api/v3/projects/42/work_packages?filters=%5B%7B%22status%22%3A%7B%22operator%22%3A%22o%22%2C%22values%22%3A%5B%5D%7D%7D%2C%7B%22dueDate%22%3A%7B%22operator%22%3A%22%3Ct%2B%22%2C%22values%22%3A%5B%221%22%5D%7D%7D%5D&offset=1&pageSize=2&sortBy=%5B%5B%22parent%22%2C%22desc%22%5D%5D"
_type: WorkPackageCollection
count: 30
offset: 1
pageSize: 2
total: 234
_links:
columns:
- href: "/api/v3/queries/columns/id"
title: ID
- href: "/api/v3/queries/columns/subject"
title: Subject
- href: "/api/v3/queries/columns/type"
title: Type
- href: "/api/v3/queries/columns/status"
title: Status
- href: "/api/v3/queries/columns/priority"
title: Priority
- href: "/api/v3/queries/columns/assignee"
title: Assignee
- href: "/api/v3/queries/columns/updated_at"
title: Updated on
groupBy:
href:
title:
project:
href: "/api/v3/projects/42"
title: Lorem ipsum project
results:
href: "/api/v3/projects/42/work_packages?filters=%5B%7B%22status%22%3A%7B%22operator%22%3A%22o%22%2C%22values%22%3A%5B%5D%7D%7D%2C%7B%22dueDate%22%3A%7B%22operator%22%3A%22%3Ct%2B%22%2C%22values%22%3A%5B%221%22%5D%7D%7D%5D&offset=1&pageSize=2&sortBy=%5B%5B%22parent%22%2C%22desc%22%5D%5D"
self:
href: "/api/v3/projects/42/queries/default"
title: Default
sortBy:
- href: "/api/v3/queries/sort_bys/parent-desc"
title: Parent (Descending)
user:
href: "/api/v3/users/1"
title: OpenProject Admin
_type: Query
filters:
- _links:
filter:
href: "/api/v3/queries/filters/status"
title: Status
operator:
href: "/api/v3/queries/operators/o"
title: open
schema:
href: "/api/v3/queries/filter_instance_schemas/status"
values: []
_type: StatusQueryFilter
name: Status
name: default
public: false
showHierarchies: true
starred: false
sums: false
timelineVisible: false
timelineZoomLevel: days
schema:
"$ref": "../components/schemas/default_query_for_project_model.yml"
description: OK
headers: {}
'403':
content:
application/hal+json:
examples:
response:
value:
_type: Error
errorIdentifier: urn:openproject-org:api:v3:errors:MissingPermission
message: You are not authorized to access this resource.
description: |-
Returned if the client does not have sufficient permissions to see the default query.
**Required permission:** view work packages in the project
headers: {}
'404':
content:
application/hal+json:
examples:
response:
value:
_type: Error
errorIdentifier: urn:openproject-org:api:v3:errors:NotFound
message: The requested resource could not be found.
description: |-
Returned if the client does not have sufficient permissions to see the project.
**Required permission:** any permission in the project
headers: {}
tags:
- Queries
description: Same as [viewing an existing, persisted Query](#queries-query-get)
in its response, this resource returns an unpersisted query and by that allows
to get the default query configuration. The client may also provide additional
parameters which will modify the default query. The query will already be scoped
for the project.
operationId: View_default_query_for_project
summary: View default query for project