team

Invite team members

Invites people to your team by email; each invitation lasts 7 days.

  • Send one address as email, or up to 500 as invitations or as a CSV file's text in csv.
  • An address already on the team, in another team or repeated in the request is refused on its own row. One already invited returns its pending invitation.
  • Only an owner can invite an owner.
  • With an Idempotency-Key, repeating the same request returns the first answer.
post/v1/team/invitations

Request

  • Base URL: https://api.pomerado.ai
  • URL: https://api.pomerado.ai/v1/team/invitations
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

1 to 200 letters, digits, _ or -, such as a UUID

Repeat a request safely: the same key and body answer the first request's job again with Idempotent-Replayed: true; the same key with a different body answers idempotency_conflict.

Request body

emailstring

One address to invite; answers its Invitation

role'owner' | 'admin' | 'member'

With email: its role (default member)

csvstring

A CSV file's text: an email column and an optional role column, with or without a header row, up to 500 rows; answers each row's result

Response

With invitations or csv: each row's invitation or error, by index

Changes

No recorded changes to this operation across all 1 revision of this API.