PATCH | Modificar membros do grupo

Prev Next

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.