GetItDoneGetItDone Docs

Create a note

Creates a workspace note in the credential's organization. A title that already exists answers 400 `validation_failed`.

POST
/v1/notes

Creates a workspace note in the credential's organization. A title that already exists answers 400 validation_failed.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A gid_ API key (Settings → API keys) or an OAuth 2.1 access token.

Header Parameters

Idempotency-Key?string

Optional client-generated key (1-255 visible ASCII characters; a UUID works) making this POST safely retryable. Retrying with the SAME key and byte-identical body within 24h replays the stored first response (marked Idempotency-Replayed: true, never re-executed, never charged against quota). The same key with a different body answers 422 idempotency_key_reused; a retry racing the first execution answers 409 idempotency_in_progress. Omitting the header executes normally with no idempotency guarantee.

Length1 <= length <= 255

Request Body

application/json
  1. body

Fields for creating a workspace note.

title*string

Note title (1-200 characters after trimming).

Length1 <= length <= 200
body?string

Note body, plain text or Markdown (max 100000 characters). Defaults to empty.

Lengthlength <= 100000
Default""
project_id?string

Optional project to attach the note to. Must be a project in the same organization.

Response Body

The created note.

application/json
  1. response

A workspace shared note.

id*string

Stable opaque note id.

title*string

Note title, unique within the organization.

body*string

Full note body (plain text or Markdown). Only returned by the get-one endpoint; list returns a preview.

project_id*|

Project the note belongs to, or null when workspace-wide.

project_name*|

Project display name, or null.

archived*boolean

True when the note is archived.

length*integer

Character count of the full body.

Range-9007199254740991 <= value <= 9007199254740991
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
updated_by_name*|

Display name of the last person or agent who wrote to this note.

Example Request
curl -X POST 'https://app.nowgetitdone.com/v1/notes' \  -H 'Content-Type: application/json' \  -d '{  "title": "string"}'
Example Response
{  "id": "string",  "title": "string",  "body": "string",  "project_id": "string",  "project_name": "string",  "archived": true,  "length": -9007199254740991,  "updated_at": "2019-08-24T14:15:22Z",  "updated_by_name": "string"}