Skip to main content
POST
Invite a Teammate
Adds an existing Tuco user to the workspace immediately, or emails an invitation to someone who does not have an account yet.

Endpoint

  • Method: POST
  • Path: /api/team/invite
  • Auth: Authorization: Bearer tuco_xxxxxxxxxxxxx

Body

Example request

Success response (200)

Permissions

A signed-in caller must be a workspace admin. An API key is accepted on its own: only a workspace owner or admin can mint one, and it is scoped to this workspace, so the key already carries the authority the check would test. This also means an integration keeps working when the person who created the key changes role or leaves. Agencies: use the workspace key for the workspace you are inviting into — the one returned by Create Agency Workspace. An agency key cannot invite, because “which workspace?” would be ambiguous.

Error responses