---
title: "Update workspace invite"
method: PATCH
path: "/api/v1/workspaces/invites/{inviteId}"
tags: ["workspace", "invites"]
---

# Update workspace invite

`PATCH /api/v1/workspaces/invites/{inviteId}`

Update the metadata of a specific workspace invite by its ID.

    You can update:
    - Email address (for email invites)
    - Role assigned to the invitee
    - Maximum uses or domain restrictions

    **Use cases:**
    - Correcting invite details
    - Changing invite permissions
    - Managing invite limits

## Path parameters

- `inviteId` string, required

## Request body

- object
  - `email` string
  - `role` 'member' | 'admin'
  - `restrictedDomains` string[]

## Response `200`

This response returns the updated data for the workspace invite.

- object — This response returns the updated data for the workspace invite.
  - `id` string, required
  - `created` string, required
  - `type` 'link' | 'email', required
  - `status` 'pending' | 'redeemed' | 'rejected', required
  - `email` string, required
  - `role` 'member' | 'admin', required
  - `resolvedAt` string, required
  - `redeemedBy` string, required
  - `uses` number
  - `restrictedDomains` string[]

## Other responses

- `400` — This response indicates that the request was malformed or contained invalid parameters.
- `401` — This response indicates that the client must authenticate to access the requested resource.
- `403` — This response indicates that the client does not have permission to access the requested resource.
- `404` — This response indicates that the requested resource could not be found.

---

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