Solutions
worksection
beta
help
Searching tasks through API: search_tasks
Sample search_tasks request
?action=search_tasks&id_project=PROJECT_ID&filter=(name has 'Report' or name has 'Approval') and (dateend>'25.05.2021' and dateend<'31.05.2021')
Returns tasks that meet search query
Conditional parameters:
*at least one of them required
*at least one of them required
- id_project — project ID
- id_task — task ID
- email_user_from — task author email
- email_user_to — task executive email
- filter — search query (see description below)
Optional parameters:
- status — task state, possible values: active/done — incomplete/completed
- extra — additional task info (can be specified with commas, for example extra=text,files):
text or html — description in text or html format
files — attached files info (in task description)
Integer fields:
- id=TASK_ID — returns particular task
- project=PROJECT_ID — returns tasks of a particular project
- parent=TASK_ID — returns subtasks of a particular parent task
Equality and range operators for integer fields: =, in
project=2456
id in (1234, 1240)
String fields:
- name — task name
Full or partial match for string fields: =, has
name='Task Report'
name has 'Report'
Date fields:
- dateadd — task creation date in 'DD.MM.YYYY' format
- datestart — task start date in 'DD.MM.YYYY' format
- dateend — task due date or end date in 'DD.MM.YYYY' format
- dateclose — task closing date in 'DD.MM.YYYY' format
Relational operators for
date fields: >, <, >=, <=, ! =, =
dateadd='01.05.2021'
Query conditions can be combined with parentheses () and logical operations and, or (only in lowercase)
Sample filter query
&filter=(name has 'Report' or name has 'Approval') and (dateend>'25.05.2021' and dateend<'31.05.2021')
Leave your review
Did this article help you?
Glad we could help! What was helpful?
Sorry this didn't help. What went wrong?
