Skip to main content
TroopyDocs
Open Troopy
Troopy

API reference / Tasks and projects

Make a project of a task

Makes a project of a task. The title of the task is the name of the project, and its brief the description. Its sub-tasks become tasks of the project. Then the task itself goes, with its comments and files, for good. Not for an engineering ticket or a sub-task. Owners, admins and whoever created the task.

post/api/v1/tasks/{key}/convert-to-project

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.

Other ways to call it

CLItroopy tasks convert
MCP toolNone. Call it over REST or with the CLI.
Rate limit10 calls in 60 seconds, for each key

Path parameters

key*string

A task's key (VIR-12), its number (12) or its id

At least 1 characters · At most 40 characters

Response

201 · application/json
data*object
2 properties
project*object
19 properties
id*string

A 24-character id

name*string
summary*string
description*string
icon*string
status*enum<string>

plannedactivepauseddonecanceled

priority*enum<string>

noneurgenthighmediumlow

lead*object | null
3 properties
type*enum<string>

agentperson

id*string
name*string
startAt*string | null
targetAt*string | null
tasks*object

Its tasks, canceled ones left out

4 properties
total*integer
done*integer
open*integer
needsYou*integer
progress*integer

Percent of its tasks done

milestones*array<object>

Steps on the way, in order, each with its tasks (canceled ones left out)

5 properties
id*string

A 24-character id

name*string
targetAt*string | null
tasks*object
2 properties
total*integer
done*integer
progress*integer
health*enum<string> | null

How it's going, from its latest status update

on_trackat_riskoff_track

lastUpdateAt*string | null
createdBy*object

Who wrote it

3 properties
type*enum<string>

personagentapi

id*string
name*string
createdAt*string

ISO 8601 date and time

updatedAt*string

ISO 8601 date and time

version*integer
moved*integer

How many sub-tasks became tasks of the project

Errors

400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
404 not_foundCheck the path and any id in it. Every operation is listed in /api/v1/openapi.json.
429 rate_limitedWait the number of seconds in Retry-After, then retry.