Endpoint: PATCH {{senhasegura_url}}/iso/scim/v2/Groups/{group_id}
Descrição: Realiza modificações parciais na configuração do grupo, com foco principal em operações de gerenciamento de membros usando a sintaxe PATCH do SCIM.
Parâmetros da Requisição
- Método:
PATCH
- Parâmetro de Caminho:
group_id
(obrigatório).
- Identificador do grupo alvo.
- Content-Type: application/json.
- Authorization: Token Bearer obrigatório.
Estrutura do Corpo da Requisição
{
"schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
"Operations": [
{
"op": "add",
"path": "members",
"value": [
{
"value": "string"
}
]
}
]
}
Elementos da Requisição
Elemento |
Descrição |
schemas |
Identificador do schema de operação PATCH do SCIM. |
Operations |
Array de operações de modificação. |
op |
Tipo de operação (add , remove , replace ). |
path |
Caminho do atributo alvo para modificação. |
value |
Novo valor ou array de valores a serem aplicados. |
Operações Suportadas
Operação |
Descrição |
Add Members |
Adiciona novos usuários à associação do grupo. |
Remove Members |
Remove usuários existentes do grupo. |
Replace Members |
Substitui toda a lista de membros. |
Códigos de Status
Código de Status |
Descrição |
200 OK |
Modificação do grupo realizada com sucesso e dados atualizados. |
204 No Content |
Modificação bem-sucedida sem corpo de resposta. |
400 Bad Request |
Sintaxe inválida da operação PATCH. |
404 Not Found |
Grupo alvo não existe. |
401 Unauthorized |
Token de autenticação inválido ou ausente. |