Reference/Projects
Projects
A project holds a team's cards and its own steps; it has one owner, admins and members.
Read
GETList projectsThe projects the key's person is in, as their project list shows them./projects GETGet a projectOne project, as the key's person's project list shows it./projects/{projectId} GETGet a project's photoThe project's photo, as a JPEG./projects/{projectId}/photo GETList a project's stepsThe project's steps in order, each with how many cards are on it./projects/{projectId}/steps GETList account changesWhat changed in the key's person's projects since a cursor: their people, their list, their Pulse, their plan./account/changes GETList a project's settingsThe project's settings, each with its value and whether the caller may change it./projects/{projectId}/settings GETList a project setting's historyThe changes of one of the project's settings or of its name, steps or photo, newest first./projects/{projectId}/settings/{key}/history GETPreview a project's deletionWhat deleting the project would remove, and whether the key's person may delete it./projects/{projectId}/delete GETList projects being deletedThe projects the key's person owns that wait to be deleted and can still be restored./deleting-projects GETList project deletion noticesThe notices of the last 30 days that a project of the key's person was set to be deleted, restored or deleted./account/project-notices
Create
Change
PATCHRename a projectRenames the project./projects/{projectId} PUTChange a project's photoSets the project's photo, from a JPEG sent as the body or from an upload made first with POST /assets./projects/{projectId}/photo DELETERemove a project's photoTakes the project's photo off./projects/{projectId}/photo PUTChange a project's stepsReplaces the project's steps with a new list./projects/{projectId}/steps POSTArchive a projectArchives the project: it leaves the project list and takes no changes until it is brought back./projects/{projectId}/archive POSTUnarchive a projectBrings an archived project back into use./projects/{projectId}/unarchive POSTJoin with an invitation codeJoins the key's person to a project with an invitation code someone in it gave them./invitations/redeem POSTChange a project's settingChanges one of the project's settings./projects/{projectId}/settings POSTDelete a projectSets the project to be deleted after its grace days; until then its owner can restore it./projects/{projectId}/delete POSTRestore a projectBrings back a project waiting to be deleted, before its grace days end./projects/{projectId}/restore