---
title: "Redeem owner invitation"
method: POST
path: "/owner/redeem"
tags: ["OwnerBootstrap"]
---

# Redeem owner invitation

`POST /owner/redeem`

Public entry point. Redeems a one-time owner invitation token, sets the
owner's credential, and activates the owner account. Both the token and
the credential are write-only.

## Request body

- RedeemOwnerInvitationRequest — Owner invitation redemption.
  - `token` string, required — One-time owner invitation token from the invitation link. Write-only.
  - `credential` string, required — Credential the owner sets on first login. Opaque to this API. Write-only.

## Response `200`

Owner invitation redeemed.

- RedeemOwnerInvitationResponse — Result of redeeming an owner invitation.
  - `ownerUserId` string, required — Identifier of the activated owner user.
  - `tenantId` string, required — Identifier of the tenant the owner now administers.

## Other responses

- `400` — The request failed validation. Body is the `{error}` envelope.
- `401` — Authentication is missing or invalid. Body is the `{error}` envelope.
- `404` — The requested entity was not found. Body is the `{error}` envelope.

---

[API](https://skmtc.dev/sphereon-opensource/apis/platform-admin-api.md) · [All operations](https://skmtc.dev/sphereon-opensource/apis/platform-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sphereon-opensource/platform-admin-api/revisions/72ca8b8ae76e/schema)