Pular para o conteúdo principal
POST
Adicionar membros ao espaço de trabalho
Este endpoint requer uma chave de API de gerenciamento com workspaces:write e uma função de proprietário ou administrador.
As pessoas entram em um espaço de trabalho por meio de um convite: elas o aceitam, o que cria uma solicitação de entrada, e este endpoint a aprova. Cada usuário em user_ids precisa ter uma solicitação de entrada pendente no espaço de trabalho. Outros usuários são recusados; envie um convite a eles primeiro. Quem já é membro mantém a própria função. A função pode ser admin ou member. Sem função, cada pessoa recebe a função com que o convite foi criado. Só o proprietário do espaço de trabalho pode adicionar administradores, e a propriedade do espaço de trabalho não pode ser atribuída por este endpoint. Cada pessoa é aprovada separadamente. Se uma aprovação falhar, as pessoas aprovadas antes continuam no espaço de trabalho e as restantes não são tentadas. A resposta é então um 409 cujas listas approved, failed e not_attempted mostram onde parou, para que você corrija o problema e envie de novo os usuários restantes.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Parâmetros de caminho

id
string
obrigatório

UUID ou slug do espaço de trabalho.

Corpo

application/json
user_ids
string[]
obrigatório
Required array length: 1 - 100 elements
role
enum<string>
Opções disponíveis:
admin,
member

Resposta

Membros adicionados

added_count
integer
obrigatório
Intervalo obrigatório: x >= 0
approved
string[]
obrigatório

Usuários adicionados por esta solicitação, na ordem em que foram aprovados.

failed
object[]
obrigatório

O usuário cuja aprovação falhou, com o motivo. Os usuários seguintes não são tentados.

not_attempted
string[]
obrigatório

Usuários não tentados porque uma aprovação anterior falhou. As solicitações de entrada deles continuam pendentes.

error
string
message
string
data
object[]

Os detalhes dos membros adicionados. São omitidos se não puderem ser lidos depois das aprovações; approved continua listando quem foi adicionado.

Última modificação em 16 de novembro de 2026