pomodoro

Update a Pomodoro session.

Partial update — omitted fields are left untouched.

patch/pomodoro/{id}

Request

  • Base URL: https://restivity.ai/api/v1
  • URL: https://restivity.ai/api/v1/pomodoro/{id}
  • Auth: OAuth 2 (authorization code, authorization URL https://restivity.ai/oauth/authorize, token URL https://restivity.ai/api/oauth/token, scopes: pomodoro:write)

Path parameters

idstring uuid required

Unique Pomodoro session identifier.

Request body

end_timestring date-time
elapsed_timeinteger
status'active' | 'paused' | 'completed' | 'interrupted' | 'abandoned'
interruptionsinteger
notesstring
completion_notesstring

Response

The updated Pomodoro session.

idstring uuid required
user_idstring uuid required
task_idstring uuid nullable required
project_idstring uuid nullable required
start_timestring required
end_timestring required
durationinteger required

Planned duration in seconds.

elapsed_timeinteger required

Actual elapsed time in seconds.

type'work' | 'short-break' | 'long-break' required
status'active' | 'paused' | 'completed' | 'interrupted' | 'abandoned' required
notesstring required
completion_notesstring nullable
interruptionsinteger required
created_atstring required
deleted_atstring nullable required
time_remaininginteger nullable

Seconds remaining when paused / interrupted; null otherwise.

resumed_atstring nullable
subtask_idsstring[] nullable
firestore_idstring nullable
workspace_idstring uuid nullable

Changes

No recorded changes to this operation across all 1 revision of this API.