API reference / Tasks and projects
Save a view
Saves a set of Tasks filters under a name, for you or (shared) for the whole workspace. At most 30 each. For an API key, it is saved for the person who made it.
/api/v1/viewsOther ways to call it
troopy views createtroopy_create_saved_viewIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Body
application/jsonname*stringAt least 1 characters · At most 60 characters
sharedbooleanfilters*object12 properties
qstringWords in the key or title
At most 200 characters
assigneearray<string>Teammate handles, person ids, none, people (any person) or agents (any teammate)
At most 20 items
priorityarray<enum<string>>noneurgenthighmediumlow
At most 5 items
projectarray<string>Project ids, or none
At most 20 items
milestonearray<string>Milestone ids, or none
At most 20 items
areaarray<enum<string>>Any of these areas
engineeringmarketingoperations
At most 3 items
labelarray<string>At most 20 items
statusarray<enum<string>>backlogtodoin_progressneeds_youin_reviewdonecanceled
At most 7 items
creatorarray<string>Who made the tasks: teammate handles, person ids, or me
At most 20 items
duearray<enum<string>>overdue: past due and open. week: due in the next 7 days. none: no due date
overdueweeknone
At most 3 items
minebooleanOnly tasks you asked for, created or were given
subbooleantrue shows sub-tasks. Without it, the board hides them
layoutenum<string>boardlist
displayobject5 properties
group*enum<string>The groups of the list
statusassigneepriorityprojectnone
order*enum<string>The order in a group or a column. manual: the order that people give by drag
manualprioritycreatedupdateddue
recent*booleanDone and canceled tasks come last, the newest first
empty*booleanThe list shows the groups that have no task
props*array<enum<string>>The parts of a row or a card that show. The title always shows
idprioritystatusassigneelabelsprojectduecreatedprsubtasks
At most 10 items
Response
201 · application/jsondata*object11 properties
id*stringA 24-character id
name*stringshared*booleanEveryone in the workspace sees it
mine*booleanWhether it is yours: only its owner changes it
owner*object2 properties
id*stringA 24-character id
name*stringfilters*object12 properties
qstringWords in the key or title
At most 200 characters
assigneearray<string>Teammate handles, person ids, none, people (any person) or agents (any teammate)
At most 20 items
priorityarray<enum<string>>noneurgenthighmediumlow
At most 5 items
projectarray<string>Project ids, or none
At most 20 items
milestonearray<string>Milestone ids, or none
At most 20 items
areaarray<enum<string>>Any of these areas
engineeringmarketingoperations
At most 3 items
labelarray<string>At most 20 items
statusarray<enum<string>>backlogtodoin_progressneeds_youin_reviewdonecanceled
At most 7 items
creatorarray<string>Who made the tasks: teammate handles, person ids, or me
At most 20 items
duearray<enum<string>>overdue: past due and open. week: due in the next 7 days. none: no due date
overdueweeknone
At most 3 items
minebooleanOnly tasks you asked for, created or were given
subbooleantrue shows sub-tasks. Without it, the board hides them
layout*enum<string>boardlist
display*object | nullHow it shows the tasks. Null: as the browser of each person shows them
5 properties
group*enum<string>The groups of the list
statusassigneepriorityprojectnone
order*enum<string>The order in a group or a column. manual: the order that people give by drag
manualprioritycreatedupdateddue
recent*booleanDone and canceled tasks come last, the newest first
empty*booleanThe list shows the groups that have no task
props*array<enum<string>>The parts of a row or a card that show. The title always shows
idprioritystatusassigneelabelsprojectduecreatedprsubtasks
At most 10 items
path*stringThe Tasks page showing it, like /tasks?assignee=writer
createdAt*stringISO 8601 date and time
updatedAt*stringISO 8601 date and time