---
title: "Create a new workspace invite (admin only)"
method: POST
path: "/api/workspaces/{workspace_id}/invites"
tags: ["invites"]
---

# Create a new workspace invite (admin only)

`POST /api/workspaces/{workspace_id}/invites`

## Request

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

## Path parameters

- `workspace_id` integer, required: Workspace ID

## Request body

- InviteCreateRequest
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `email` string, required
  - `role` string, required

## Response `201`

Created

- InviteMutationResponse
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `delivery_status` string, required
  - `invite` InviteResponse, required
    - `accepted_at` string, date-time, nullable, required
    - `code` string, required
    - `created_at` string, date-time, required
    - `created_by_user_id` integer, nullable, required
    - `expires_at` string, date-time, required
    - `id` integer, required
    - `invited_email` string, required
    - `role` string, required
    - `workspace_id` integer, required
  - `retry_after_seconds` integer

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/hillstar/apis/rfpai-api-go.md) - [All operations](https://skmtc.dev/hillstar/apis/rfpai-api-go/llms.txt) - [OpenAPI document](https://skmtc.dev/hillstar/apis/rfpai-api-go/revisions/b2532dc47fc6?raw)