---
title: "Update organization invitation status"
method: PUT
path: "/api/organization-invitations/{id}/status"
tags: ["Organization invitations"]
---

# Update organization invitation status

`PUT /api/organization-invitations/{id}/status`

Update the status of an organization invitation by ID.

## Path parameters

- `id` string, required

## Request body

- object
  - `acceptedUserId` string, nullable — The ID of the user who accepted the organization invitation. Required if the status is "Accepted".
  - `status` 'Accepted' | 'Revoked', required — The status of the organization invitation.

## Response `200`

The organization invitation status was updated successfully.

- object
  - `tenantId` string, required
  - `id` string, required
  - `inviterId` string, nullable, required
  - `invitee` string, required
  - `acceptedUserId` string, nullable, required
  - `organizationId` string, required
  - `status` 'Pending' | 'Accepted' | 'Expired' | 'Revoked', required
  - `createdAt` number, required
  - `updatedAt` number, required
  - `expiresAt` number, required
  - `organizationRoles` object[], required
    - `id` string, required
    - `name` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — The organization invitation status could not be updated. This can happen if the current status is not "Pending" or if the status is "Accepted" and the accepted user ID is not provided.

---

[API](https://skmtc.net/logto/apis/logto-api-references.md) · [All operations](https://skmtc.net/logto/apis/logto-api-references/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/logto/logto-api-references/revisions/a163dc77d842/schema)