tasks

Skip the occurrence a reminder is on (reminder_only model).

For a recurring master whose recurrence_model is reminder_only (TIPO B): the master is always ON one occurrence — its due_date. This moves it to the next occurrence not before today WITHOUT recording a completion (no rewards); overdue occurrences in between are skipped and counted in skipped_count. When the rule has no further occurrence the master is completed and series_completed is true. To record the occurrence as DONE, PATCH the task with status: "completed" instead — that rolls it the same way, with the completion rewards. A non-recurring task, a materialized master or a child occurrence is refused with 400 invalid_request. As on the web, whoever may edit the task skips it — an editor of its project on a teammate's reminder included; a team viewer is 403 forbidden. MCP sibling: tasks_recurrence_skip.

post/tasks/{id}/recurrence/skip

Request

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

Path parameters

idstring uuid required

Unique Task identifier.

Response

Where the reminder was and where it is now, plus the updated task.

successboolean required
previous_datestring nullable required

The occurrence it was on (YYYY-MM-DD).

next_datestring nullable required

The occurrence it is on now (YYYY-MM-DD); null when the series ended.

skipped_countinteger required

Overdue occurrences between the two, skipped (never completed one by one).

series_completedboolean required

No further occurrence: the master was completed for real.

Changes

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