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

# Get workspace invite

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

Retrieve details for a specific workspace invite by its ID.

    This endpoint returns all metadata for the invite, including status and restrictions.

    **Use cases:**
    - Displaying invite details in UI
    - Validating invite status before accepting
    - Auditing invite usage

## Path parameters

- `inviteId` string, required

## Response `200`

This response returns the data for the requested workspace invite.

- object — This response returns the data for the requested 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

- `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)