GetItDoneGetItDone Docs
API ReferenceProjects

Get a project

GET
/v1/projects/{project_id}

Fetches a single project by id, scoped to the credential's organization. A project id from another organization (or an unknown id) answers 404 resource_not_found — no cross-org existence oracle.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A gid_ API key (Profile → API Keys) or an OAuth 2.1 access token.

Path Parameters

project_id*string

Response Body

The project.

application/json
  1. response

A project — a named grouping of tasks within an organization.

id*string

Stable opaque project id.

name*string

Display name, unique within the organization.

description*|

Free-text description, or null when unset.

created_at*string

Creation time, ISO-8601 UTC.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
updated_at*string

Last-modified time, ISO-8601 UTC.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
Example Request
curl -X GET 'https://app.nowgetitdone.com/v1/projects/string'
Example Response
{  "id": "string",  "name": "Website redesign",  "description": "string",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}

Create a project POST

Creates a project in the credential's organization. Supports the optional Idempotency-Key header for safe retries; a project name that already exists in this…

Get a task's dependencies GET

Both directions of the task's blocker graph one hop out: blocked_by (must finish first) and blocking (waiting on this task), plus the derived is_blocked. A…