---
title: "Transfer schedule ownership"
method: PUT
path: "/v1/schedules/{scheduleId}/transfer-ownership"
tags: ["Schedules"]
---

# Transfer schedule ownership

`PUT /v1/schedules/{scheduleId}/transfer-ownership`

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/schedules/{scheduleId}/transfer-ownership`
- Auth: HTTP bearer

Transfer ownership of a schedule from one user to another user in the same organization. New ownership will be immediate and can't be reversed using this endpoint.

## Path parameters

- `scheduleId` string, uuid, required

## Request body

- object
  - `userId` string, uuid, required: The ID of the user to transfer schedule ownership to. Use the [List users](/api/users/list-users) endpoint to retrieve user IDs. The new owner must: - Be a member of the same organization - Not be the current owner - Have permission to view and schedule the document the schedule delivers (dashboard or workbook)

## Response `200`

Ownership transferred successfully

- SuccessResponse
  - `success` boolean

## Other responses

- `400`: Bad Request Possible error messages: - `userId: Invalid uuid` - `userId is a required field` - `User already owns the schedule`
- `403`: Forbidden Possible error messages: - `New owner does not have permission to view the dashboard` (dashboard delivery) - `New owner does not have permission to view this workbook` (workbook delivery) - `New owner does not have permission to schedule this dashboard` (dashboard delivery) - `New owner does not have permission to schedule this workbook` (workbook delivery)
- `404`: Not Found Possible error messages: - `Scheduled task with id <scheduleId> does not exist` - `New owner is not a member of the organization`
- `405`: Method Not Allowed - Invalid HTTP method for this endpoint
- `429`: Too Many Requests - Rate limit exceeded (60 requests/minute)

## Changes

- **2026-11-03** `43290040f88f`: 1 breaking, 7 info
  - added required request body
  - the endpoint scheme security `bearerAuth` was added to the API
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`
  - …4 more

[Operation history](https://skmtc.dev/omni/apis/omni-api/changes/v1/schedules/:scheduleId/transfer-ownership/put.md)

---

[API](https://skmtc.dev/omni/apis/omni-api.md) - [All operations](https://skmtc.dev/omni/apis/omni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omni/apis/omni-api/revisions/43290040f88f?raw)