Submit or recall my time day

Submits a validated day into the canonical approval lifecycle or recalls it while policy permits. Submit requires an Idempotency-Key header; both commands require confirmation.

POST/api/v1/time-days/:date/:action

Authorization

time:submit_selfapi key scoperequired

Required scope when calling with an API key.

Path parameters

datestringrequired

YYYY-MM-DD or today

Example: today

actionstringrequired

Lifecycle command

Example: submit

Request body

confirmbooleanrequired

Must be true after review

Example request

{
  "confirm": true
}

Request

POST /api/v1/time-days/:date/:action

curl -X POST "https://www.digitalstack360.com/api/v1/time-days/today/submit" \
  -H "Authorization: Bearer $DS_API_KEY" \
  -H "Idempotency-Key: submit-2026-07-14" \
  -H "Content-Type: application/json" \
  -d '{"confirm":true}'

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": {
    "id": "submission_01k2...",
    "work_date": "2026-07-14",
    "state": "submitted",
    "total_minutes": 480,
    "session_count": 6,
    "replayed": false
  },
  "meta": {
    "self_scoped": true
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

400

bad_request

Missing or invalid request fields

403

scope_insufficient

Key lacks the required write scope

409

validation_failed

The day has unresolved policy or attribution errors

423

submission_locked

An approved submission cannot be recalled