---
title: "Create workspace invitation"
method: POST
path: "/api/v1/workspaces/{workspace_id}/invitations"
tags: ["invitations"]
---

# Create workspace invitation

`POST /api/v1/workspaces/{workspace_id}/invitations`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/workspaces/{workspace_id}/invitations`
- Auth: none declared

Create an invitation to join the workspace. Requires owner or admin role.

## Path parameters

- `workspace_id` string, uuid, required

## Headers

- `authorization` string, nullable

## Request body

- WorkspaceInvitationCreate: Create workspace invitation request. Issue #165: Team Collaboration - Workspace Invitation System Note: Email is required and must match the Google account used for OAuth login.
  - `email` string, required: Email address (must match Google OAuth account)
  - `role` 'owner' | 'admin' | 'member' | 'viewer': Workspace-level tenancy role. Ordering: OWNER > ADMIN > MEMBER > VIEWER (see WORKSPACE_ROLE_WEIGHTS).
  - `expires_in_days` integer, nullable: Days until expiration (7/30/90/365 or null=never)
  - `allowed_context_ids` string[], nullable: Context IDs to allow (required for member/viewer, minimum 1)

## Response `200`

Successful Response

- WorkspaceInvitationResponse: Workspace invitation response. Issue #165: Team Collaboration - Workspace Invitation System
  - `id` unknown, required
  - `workspace_id` unknown, required
  - `token` unknown, required
  - `email` unknown, required
  - `role` unknown, required
  - `invited_by` unknown, required
  - `expires_at` unknown, required
  - `accepted_at` unknown, required
  - `accepted_by` unknown, required
  - `created_at` unknown, required
  - `invitation_url` unknown, required
  - `is_expired` unknown, required
  - `is_accepted` unknown, required
  - `allowed_context_ids` unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/aa9df1a21db9?raw)