users

Replace a user's planning for a specific day

Changed on

Replaces a user's availability planning for a single day of the week. This is a more targeted alternative to PUT /users/{userId}/plannings — use it when you only need to modify one day without replacing the entire week. Planning must be enabled in the user's settings (is_planning = true). If planning is disabled, the request returns 406.

Permission: Users Write required.

Monitoring: Required. Modifying another user's planning is a supervisory operation. Returns 401 Unauthorized if Monitoring is OFF on your API key.

put/users/{userId}/plannings/{day}

Request

  • Base URL
    https://public-api.ringover.com/v2
  • URL
    https://public-api.ringover.com/v2/users/{userId}/plannings/{day}
  • Auth
    API key in header Authorization

Path parameters

userIdinteger required

The identifier of the user

day'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday' required

The day of planning

Request body

startinteger

Start time in minutes (0 => 0:00)

endinteger

End time in minutes (1440 => 24:00)

Example request

[
  {
    "end": 1440
  }
]

Response

Successful operation

Changes