---
title: "Transfer a dashboard to a new owner (org admin only)."
method: PUT
path: "/v1/dashboards/{id}/owner"
tags: ["dashboards"]
---

# Transfer a dashboard to a new owner (org admin only).

`PUT /v1/dashboards/{id}/owner`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/v1/dashboards/{id}/owner`
- Auth: one of:
  - API key in cookie `dvt_session`
  - HTTP bearer

Reassigns the dashboard's `ownerId`. Requires `share:manage` (org admin or owner);
the current owner cannot transfer a dashboard away unless they are also an admin
(403). The new owner must be an active member of the same org: a user in another
org, a suspended or deleted user, and an unknown id all return 422 with problem
type `https://docs.dvt.dev/errors/invalid-owner`. Audit-logged as
`dashboard.transfer` with `owner_id_before` / `owner_id_after` and the acting
admin, and it appears in the org activity feed.

## Request body

- object
  - `userId` string, uuid, required: The new owner's user id (see the org members list).

## Response `204`

Transferred.

## Other responses

- `400`: Malformed request.
- `401`: Missing, invalid, or expired session.
- `403`: The caller's role does not permit this action.
- `404`: Resource does not exist.
- `422`: The target user is not an active member of this org.

---

[API](https://skmtc.dev/dvt/apis/dvt-rest-api.md) · [All operations](https://skmtc.dev/dvt/apis/dvt-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dvt/apis/dvt-rest-api/revisions/00016f504165?raw)