---
title: "Invite a teammate to this workspace (owner only). Emails them the invite and also returns the link to share by hand. Enterprise workspaces only: ATI Pro is one person."
method: POST
path: "/v1/workspace/invite"
---

# Invite a teammate to this workspace (owner only). Emails them the invite and also returns the link to share by hand. Enterprise workspaces only: ATI Pro is one person.

`POST /v1/workspace/invite`

## Request

- Base URL: `https://api.americantradesindex.com`
- URL: `https://api.americantradesindex.com/v1/workspace/invite`
- Auth: HTTP bearer

## Request body

- object
  - `email` string, required

## Response `200`

{token, url, email, emailed} (201)

## Other responses

- `400`: invalid email, or that person is already in this workspace
- `401`: unauthorized: missing, invalid or revoked key
- `402`: upgrade_required (no active plan), credits_exhausted (period pool used up) or payment_required (last charge failed); body carries an `upgrade` URL
- `403`: owner only, or single_seat_plan (ATI Pro is one person; teams are Enterprise)
- `429`: rate_limited (120/min per workspace). Every response carries RateLimit-Limit/Remaining/Reset/Policy; a 429 adds Retry-After

---

[API](https://skmtc.dev/americantradesindex/apis/american-trades-index-api.md) · [All operations](https://skmtc.dev/americantradesindex/apis/american-trades-index-api/llms.txt) · [OpenAPI document](https://skmtc.dev/americantradesindex/apis/american-trades-index-api/revisions/5a9de4d8c76b?raw)