Skip to main content
POST
Transfer project ownership
Hands a project to another team or department. The body is strict: id, ownerKind (team or department; a person or factory owner is refused) and ownerRefId. The change authorizes both sides inside the write. The project: 404 unless the caller holds projects:read at its home, 403 without projects:manage there. The new owner: an org unit that must exist (otherwise 404), where the caller also holds projects:manage (otherwise 403). The credential’s scopes must include projects:read as well as projects:manage, because the success returns the project; otherwise 403 naming projects:read, and nothing is written. The project’s home, which decides who can read it, does not move: only the owner changes. Success is 200 with the post-write Project. A same-key retry within 24 hours returns the recorded result only while the caller may still read and change the project at its home; otherwise 409 idempotency_result_unavailable.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Headers

Idempotency-Key
string

Optional logical intent key. A same-key retry within 24 hours returns the recorded result without writing again.

Required string length: 1 - 255

Path Parameters

projectId
string
required

The project ID, as GET /api/v2/projects/get returns it.

Minimum string length: 1

Body

application/json

Hand a project to another team or department. A person or factory owner is refused. Unknown fields are refused.

ownerKind
enum<string>
required

The kind of org unit that will own the project. A person never owns it.

Available options:
team,
department
ownerRefId
string
required

The new owning org unit. The caller needs projects:manage there; the project's home does not move.

Minimum string length: 1

Response

Success

data
object
required
meta
object
required