---
title: "Create a team invite"
method: POST
path: "/api/v1/teams/{team}/invite"
---

# Create a team invite

`POST /api/v1/teams/{team}/invite`

Generates a new invite code for the specified team. The authenticated user
must be a member of the team with the `owner` or `admin` role.

The returned code is a short alphanumeric string that other users can
present to join the team. Each call produces a new code; previously issued
codes are not invalidated by this request.

## Path parameters

- `team` string, required

## Response `200`

Successful response

- TeamInvite — A team invite containing a short alphanumeric code that other users can present to join the team.
  - `code` string, required — Short alphanumeric join code. Pass this value as `join_code` to the join-with-code endpoint to add a user to the team.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Team not found

---

[API](https://skmtc.net/archastro/apis/archastro-platform-api.md) · [All operations](https://skmtc.net/archastro/apis/archastro-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archastro/archastro-platform-api/versions/a8772b442f86/schema)