Replace weekly hours
const url = 'https://api.keptslot.com/v1/staff/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/working-hours';const options = { method: 'PUT', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"working_hours":[{"weekday":1,"start_minute":540,"end_minute":1020},{"weekday":2,"start_minute":540,"end_minute":1020}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://api.keptslot.com/v1/staff/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/working-hours \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "working_hours": [ { "weekday": 1, "start_minute": 540, "end_minute": 1020 }, { "weekday": 2, "start_minute": 540, "end_minute": 1020 } ] }'This endpoint replaces the whole weekly schedule in one transaction. Send every block you want. A block you omit is erased.
Send an empty array to clear the schedule. The calendar then offers no slots.
The response echoes what you sent.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”The calendar id.
Request Body required
Section titled “ Request Body required ”object
object
The day of the week. 0 is Sunday.
Minutes after midnight, in the workspace timezone.
Minutes after midnight, in the workspace timezone.
Example
{ "working_hours": [ { "weekday": 1, "start_minute": 540, "end_minute": 1020 }, { "weekday": 2, "start_minute": 540, "end_minute": 1020 } ]}Responses
Section titled “ Responses ”The schedule is replaced.
object
object
The day of the week. 0 is Sunday.
Minutes after midnight, in the workspace timezone.
Minutes after midnight, in the workspace timezone.
Example generated
{ "working_hours": [ { "weekday": 1, "start_minute": 1, "end_minute": 1 } ]}The key is missing, malformed or revoked.
object
object
A stable machine-readable code. Match on this.
A sentence for a person. Do not match on this.
The field that caused the refusal, if one field did.
The plan limit that refused the request. It is present only on a 402, and only for a secret key or an account key. See the errors guide.
The current count for that dimension. It is present only on a 402, and only for an account key. It is absent when the refusal has no count to report. Absent and zero are different answers.
The cap for that dimension. It is present only on a 402, and only for an account key. A cap of zero is a real value.
Example generated
{ "error": { "type": "example", "message": "example", "param": "example", "dimension": "example", "used": 1, "limit": 1 }}There is no such resource in this workspace.
object
object
A stable machine-readable code. Match on this.
A sentence for a person. Do not match on this.
The field that caused the refusal, if one field did.
The plan limit that refused the request. It is present only on a 402, and only for a secret key or an account key. See the errors guide.
The current count for that dimension. It is present only on a 402, and only for an account key. It is absent when the refusal has no count to report. Absent and zero are different answers.
The cap for that dimension. It is present only on a 402, and only for an account key. A cap of zero is a real value.
Example generated
{ "error": { "type": "example", "message": "example", "param": "example", "dimension": "example", "used": 1, "limit": 1 }}The request body or the query is not valid.
object
object
A stable machine-readable code. Match on this.
A sentence for a person. Do not match on this.
The field that caused the refusal, if one field did.
The plan limit that refused the request. It is present only on a 402, and only for a secret key or an account key. See the errors guide.
The current count for that dimension. It is present only on a 402, and only for an account key. It is absent when the refusal has no count to report. Absent and zero are different answers.
The cap for that dimension. It is present only on a 402, and only for an account key. A cap of zero is a real value.
Example generated
{ "error": { "type": "example", "message": "example", "param": "example", "dimension": "example", "used": 1, "limit": 1 }}