---
title: "Add people to the workspace by email [write, owner or admin]"
method: POST
path: "/universes/{slug}/invites"
---

# Add people to the workspace by email \[write, owner or admin\]

`POST /universes/{slug}/invites`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/universes/{slug}/invites`
- Auth: HTTP bearer

Up to 50 emails per call; the workspace may hold at most 200 pending invitations in total. To invite more than 50 people, send multiple calls. Set send_email to true to send invitation mail and include per-email delivery results. sent means provider acceptance; unavailable leaves a usable link to share. No email is sent and no delivery field is returned by default. The response carries one link token per new invitation (shown only here; links are /join/{token} on the consumer app). Each person joins through the link, or the next time they use AgentSky signed in with that verified email; an invitation lasts 30 days.

## Path parameters

- `slug` string, required

## Request body

- object
  - `emails` string[], required
  - `send_email` boolean
  - `role` 'admin' | 'member'

## Response `201`

Created

- object
  - `invites` object[]
  - `links` object[]
    - `email` string
    - `token` string
  - `delivery` object[]
    - `email` string
    - `status` 'sent' | 'unavailable'

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 7 info
  - added the new optional request property `send_email`
  - added the optional property `delivery` to the response with the `201` status
  - added the optional property `error/request_id` to the response with the `default` status
  - added the optional property `links` to the response with the `201` status
  - …3 more

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/universes/:slug/invites/post.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)