Set a section's daily status
PATCH
/v1/daily-planSets the fill-status of one section of the credential user's board for a date (creating the section row if the date was never touched — the in-app board creates it on view).
Required scopes
tasks:write
Availability
All plans
Quota cost
1 API call
Idempotency
Not applicable
Request
Query parameters
| Field | Type | Description |
|---|---|---|
daterequired | string (date) | Board date as YYYY-MM-DD (UTC day).e.g. 2026-07-23 |
Request body
| Field | Type | Description |
|---|---|---|
sectionrequired | "TODO" | "PROGRESS" | Daily-board section: `TODO` = the plan list, `PROGRESS` = the in-progress list. |
statusrequired | "COMPLETED" | "PLANNED" | "NOT_FILLED" | "FILLING" | Fill-state of one daily-board section for one date. |
▸ ▾ Raw request schema
{
"type": "object",
"properties": {
"section": {
"$ref": "#/components/schemas/DailySection"
},
"status": {
"$ref": "#/components/schemas/DailyStatus"
}
},
"required": [
"section",
"status"
],
"description": "Which section, and its new status."
}Response 200
The updated section status.
Fields
| Field | Type | Description |
|---|---|---|
daterequired | string (date) | |
sectionrequired | "TODO" | "PROGRESS" | Daily-board section: `TODO` = the plan list, `PROGRESS` = the in-progress list. |
statusrequired | "COMPLETED" | "PLANNED" | "NOT_FILLED" | "FILLING" | Fill-state of one daily-board section for one date. |
▸ ▾ Raw response schema
{
"type": "object",
"properties": {
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\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])))$"
},
"section": {
"$ref": "#/components/schemas/DailySection"
},
"status": {
"$ref": "#/components/schemas/DailyStatus"
}
},
"required": [
"date",
"section",
"status"
],
"additionalProperties": false,
"description": "One section's fill-status for one date."
}Example request
curl
curl -X PATCH https://app.nowgetitdone.com/v1/daily-plan \
-H "Authorization: Bearer gid_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"section": "TODO",
"status": "COMPLETED"
}'Possible errors
- 400
validation_failedRequest validation failed - 401
missing_credentialsMissing credentials - 401
invalid_api_keyInvalid API key - 401
invalid_tokenInvalid access token - 403
insufficient_scopeInsufficient scope - 403
feature_not_enabledFeature not enabled on this plan - 429
rate_limitedRate limit exceeded - 429
quota_exhaustedPlan quota exhausted - 500
internal_errorInternal server error