> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nekt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Workspace Invitations

> The pending invitees waiting in your current workspace.

Returns the organization's outstanding invitations whose invitee already has a place in the API key's workspace, each with the role waiting for them there. Use it to see who is pending in a workspace without needing organization-level rights.

## Response

An array of [workspace invitation objects](https://docs.nekt.com/platform-api/invitations/workspace/invitation.md), newest first. This endpoint is not paginated.

```json theme={null}
[
  {
    "id": "c1f0a9d4-5b62-4e18-9a73-2d8e4f6b0c51",
    "email": "analyst@example.com",
    "first_name": "",
    "last_name": "",
    "organization_role": "member",
    "workspace_role": "member",
    "shared": false,
    "created_by": 12,
    "user": 48,
    "sent_at": "2026-11-16T10:14:02Z",
    "expires_at": "2026-11-23T10:14:02Z",
    "accepted_at": null,
    "revoked_at": null,
    "created_at": "2026-11-16T10:14:02Z"
  }
]
```

| Field | Description |
| - | - |
| `organization_role` | The role in the organization the invitation grants. |
| `workspace_role` | The role waiting for the invitee in this workspace. |
| `shared` | `true` when the invitation reaches beyond this workspace: it was issued elsewhere (by the organization or another workspace), or the invitee is in another workspace too. A shared invitation can only be revoked from the [organization's invitations](https://docs.nekt.com/platform-api/invitations/organization/revoke.md). |

`created_by` and `user` are ids; pass `expand[]=created_by` or `expand[]=user` to get the objects.

Unlike the organization's list, there is no `workspace` field: the workspace that issued the invitation may be one you cannot see.

## Example

```bash theme={null}
curl --request GET \
  --url "https://api.nekt.ai/api/v1/workspace/invitations/?expand[]=user" \
  --header "x-api-key: YOUR_API_KEY"
```

## Authentication

This endpoint requires an [API key](https://docs.nekt.com/platform-api/introduction.md#create-an-api-key) created by a **workspace admin** of the key's workspace. Organization owners and admins are admins of every workspace.

## Related

* [Invite to Workspace](https://docs.nekt.com/platform-api/invitations/workspace/invite.md): add someone to this workspace.
* [Revoke a Workspace Invitation](https://docs.nekt.com/platform-api/invitations/workspace/revoke.md): cancel one that stays inside this workspace.
* [List Invitations](https://docs.nekt.com/platform-api/invitations/organization/list.md): every outstanding invitation in the organization.


## OpenAPI

````yaml GET /api/v1/workspace/invitations/
openapi: 3.0.3
info:
  title: Nekt API
  version: v1
  description: Nekt API Documentation
  contact:
    email: support@nekt.ai
servers:
  - url: https://api.nekt.ai
security: []
paths:
  /api/v1/workspace/invitations/:
    get:
      tags:
        - v1
      description: >-
        The invitations waiting in your current workspace: the people invited to
        the organization who

        already have a place here, each with the role waiting for them in this
        workspace. Only the

        workspace's admins, or an API token of the workspace one of them
        created, manage them.
      operationId: v1_workspace_invitations_list
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WorkspaceInvitation'
          description: ''
      security:
        - ApiKeyAuth: []
components:
  schemas:
    WorkspaceInvitation:
      type: object
      description: >-
        A pending invitation to the organization whose invitee already has a
        place in your current

        workspace. `organization_role` is the role in the organization the
        invitation grants, and

        `workspace_role` the role waiting for the invitee in this workspace.
        `created_by` and `user` are

        ids, each expandable.
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        first_name:
          type: string
          readOnly: true
        last_name:
          type: string
          readOnly: true
        email:
          type: string
          format: email
          readOnly: true
          title: Email address
        organization_role:
          type: string
          readOnly: true
          description: The invitee's role in the organization.
        functional_area:
          readOnly: true
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/FunctionalAreaEnum'
            - $ref: '#/components/schemas/NullEnum'
        other_functional_area:
          type: string
          readOnly: true
          nullable: true
        sent_at:
          type: string
          format: date-time
          readOnly: true
        expires_at:
          type: string
          format: date-time
          readOnly: true
        accepted_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        revoked_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        created_by:
          type: integer
          readOnly: true
          description: The user who sent the invitation. (Expandable)
        user:
          type: integer
          nullable: true
          readOnly: true
          description: >-
            The user the invitation created, pending in the organization until
            they accept. (Expandable)
        workspace_role:
          type: string
          readOnly: true
          description: The role waiting for the invitee in this workspace.
        shared:
          type: boolean
          readOnly: true
          description: >-
            Whether the invitation reaches beyond this workspace: issued
            elsewhere, or its invitee is in another workspace too. A shared
            invitation is revoked from the organization's invitations, not here.
      required:
        - accepted_at
        - created_at
        - created_by
        - email
        - expires_at
        - first_name
        - functional_area
        - id
        - last_name
        - organization_role
        - other_functional_area
        - revoked_at
        - sent_at
        - shared
        - user
        - workspace_role
    FunctionalAreaEnum:
      enum:
        - data_analytics
        - sales
        - customer_support
        - operations
        - marketing
        - finance
        - product_development
        - growth
        - executive_leadership
        - other
      type: string
      description: |-
        * `data_analytics` - Data & Analytics
        * `sales` - Sales
        * `customer_support` - Customer Support
        * `operations` - Operations
        * `marketing` - Marketing
        * `finance` - Finance
        * `product_development` - Product Development
        * `growth` - Growth
        * `executive_leadership` - Executive Leadership
        * `other` - Other
    NullEnum:
      enum:
        - null
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API Key authentication. Format: ''x-api-key: api_key'''

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.