Equipe do seller
Lista, adiciona e remove os usuários que administram o painel de um seller, com papéis de gerente e membro.
A equipe de um seller são os usuários que entram no painel dele. Cada pessoa tem um papel: owner (dono, um por seller, criado com o cadastro), manager ou member. O administrador da loja pode acrescentar e remover gerentes e membros. Ler exige view_vendors ou manage_vendors; escrever exige manage_vendors. O dono também gerencia a própria equipe pelo painel do seller.
Listar a equipe
/api/v1/admin/vendors/{id}/teamAdminLista os usuários da equipe de um seller
Parâmetros de caminho
iduuidobrigatório{
"members": [
{
"user_id": "0fd409fb-9869-4c50-a18c-a810a19abeed",
"vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
"role": "owner",
"first_name": "Aurora",
"last_name": "Menezes",
"email": "aurora@lojateste.example.com",
"status": "A",
"email_verified": true,
"created_at": "2026-07-13T04:19:10Z"
},
{
"user_id": "ba6b819a-eea7-4265-a9ae-b65815b5a4ec",
"vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
"role": "manager",
"first_name": "Mateus",
"last_name": "Fonseca",
"email": "mateus@lojateste.example.com",
"status": "A",
"email_verified": true,
"created_at": "2026-06-19T17:18:07Z"
}
]
}Campos da resposta
membersarraymembers[].user_iduuidmembers[].rolestringownermanagermembermembers[].first_namestringmembers[].last_namestringmembers[].emailstringmembers[].statusstringA ativa).members[].email_verifiedbooleanmembers[].created_atstringAdicionar à equipe
Procura um usuário pelo e-mail. Se ele já existe e é do tipo seller, é só vinculado ao seller. Se não existe, é criado (a senha é obrigatória). Se o e-mail pertence a um cliente ou administrador, a operação é recusada.
/api/v1/admin/vendors/{id}/teamAdminAdiciona um usuário à equipe do seller
Parâmetros de caminho
iduuidobrigatórioCorpo da requisição
emailstringobrigatóriorolestringpadrão: membermanagermemberowner é reservado e devolve 400 invalid_role.passwordstringfirst_namestringlast_namestringusergroup_idsarraycurl -X POST "$BASE_URL/api/v1/admin/vendors/94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36/team" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"email":"mateus@lojateste.example.com","role":"manager","password":"Senha-Forte-2026","first_name":"Mateus","last_name":"Fonseca"}'{
"user_id": "ba6b819a-eea7-4265-a9ae-b65815b5a4ec",
"members": [
{ "user_id": "ba6b819a-eea7-4265-a9ae-b65815b5a4ec", "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36", "role": "manager", "email": "mateus@lojateste.example.com", "status": "A" }
]
}A resposta traz o user_id e a equipe atualizada.
Remover da equipe
Tira o vínculo do usuário com o seller. A conta de usuário não é apagada. O dono não pode ser removido por aqui.
/api/v1/admin/vendors/{id}/team/{userId}AdminRemove um usuário da equipe do seller
Parâmetros de caminho
iduuidobrigatóriouserIduuidobrigatório{ "removed": true }Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 400 | Falta email. | {"error":"email_required","detail":"email is required"} |
| 400 | role fora de manager/member. | {"error":"invalid_role","detail":"role must be 'manager' or 'member'"} |
| 400 | Usuário novo sem password. | {"error":"password_required","detail":"a password is required to create a new vendor administrator"} |
| 400 | Falha ao criar o usuário ou ao vincular. | {"error":"user_create_failed","detail":"..."} |
| 409 | O e-mail é de uma conta que não é de seller. | {"error":"email_in_use","detail":"this email already belongs to a non-vendor account"} |
| 409 | Tentativa de remover o dono. | {"error":"cannot_remove_owner","detail":"cannot remove vendor owner via team-member API"} |
| 500 | id que não é UUID (na listagem). | {"error":"list_team_failed","detail":"..."} |
| 401 / 403 | Sem token ou sem privilégio. | {"error":"missing authorization header"} |