> ## Documentation Index
> Fetch the complete documentation index at: https://developers.portao3.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# /realms/{realmId}/organizations/{organizationId}/groups/{groupId}



## OpenAPI

````yaml /api-reference/identity.openapi.json put /realms/{realmId}/organizations/{organizationId}/groups/{groupId}
openapi: 3.0.3
info:
  title: Identity
  version: 1.0.0
  description: >-
    Portão 3 identity API. Generated by tools/openapi from code (routes +
    security) and the hand-written spec (request/response bodies). 5 app groups
    run without the identity authorizer; publicPatterns enumerates every route
    they expose. Confidence tiers: generated:typed=34 copied:manual=1
    unknown=57.
servers:
  - url: https://api.identity.v2.portao3.com.br/
    description: production
  - url: https://api.identity.dev.3pers.com.br/
    description: development
security:
  - bearerAuth: []
tags:
  - name: Authentication
  - name: Current User
  - name: Custom Fields
  - name: API Clients
  - name: Users
  - name: Organizations
  - name: Realms
  - name: Internal & Support
paths:
  /realms/{realmId}/organizations/{organizationId}/groups/{groupId}:
    put:
      tags:
        - Organizations
      summary: /realms/{realmId}/organizations/{organizationId}/groups/{groupId}
      operationId: putRealmsByRealmIdOrganizationsByOrganizationIdGroupsByGroupId
      parameters:
        - name: realmId
          in: path
          required: true
          schema:
            type: string
        - name: organizationId
          in: path
          required: true
          schema:
            type: string
        - name: groupId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 80
                description:
                  type: string
                  maxLength: 500
                memberIds:
                  minItems: 1
                  type: array
                  items:
                    type: string
                    minLength: 1
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  realm:
                    type: string
                  organization:
                    type: string
                  name:
                    type: string
                  description:
                    type: string
                  memberIds:
                    type: array
                    items:
                      type: string
                  createdBy:
                    type: string
                  updatedBy:
                    type: string
                  createdAt:
                    anyOf:
                      - type: string
                      - type: string
                        format: date-time
                  updatedAt:
                    anyOf:
                      - type: string
                      - type: string
                        format: date-time
                required:
                  - id
                  - realm
                  - organization
                  - name
                  - memberIds
                description: >-
                  Org-scoped user groups (identity `groups` collection).


                  Groups are authored by org/realm ADMINs and consumed by the
                  ruleengine business-policy engine: a `business_policies`
                  approval entry of type GROUP points at a group id, and the
                  policy-request creation resolves it to the concrete member
                  users through `IdentityClient.getOrganizationGroup`.


                  NOTE the field names `realm`/`organization` (NOT
                  realmId/organizationId) — that is identity's own persistence
                  convention (see `customField`).
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````