> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Actualizar un grupo de cuentas

> Actualiza el nombre, el ID de comercio o el grupo padre de un grupo de cuentas existente

Actualiza los detalles de un grupo de cuentas existente: su nombre, su ID de comercio o el grupo bajo el que está anidado.

Solo se modifican los campos presentes en el cuerpo. `parent_code` tiene tres estados: omítelo para dejar el padre sin cambios, envía `null` para desvincular el grupo y volver a convertirlo en raíz, o envía el `id` de otro grupo para anidar el grupo bajo él. El anidamiento es solo estructural: no otorga ni revoca ningún permiso.


## OpenAPI

````yaml openapi/es/organizations/update-account-group.json PATCH /organizations/account-groups/{account_group_id}
openapi: 3.1.0
info:
  title: Account Groups API - Update
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /organizations/account-groups/{account_group_id}:
    patch:
      summary: Actualizar un grupo de cuentas
      description: >-
        Actualiza un grupo de cuentas. Todos los campos son opcionales y solo se
        modifican los campos presentes en el cuerpo.


        `parent_code` anida el grupo bajo otro grupo de la misma organización.
        Tiene tres estados: **ausente** deja el padre actual sin cambios;
        **`null`** desvincula el grupo y lo vuelve a promover a raíz, junto con
        los subgrupos que cuelgan de él; un **`id` de grupo** anida el grupo
        bajo ese grupo. El anidamiento es solo estructural: no concede ni revoca
        nada, por lo que mover un grupo deja intactos todos los permisos
        existentes.
      operationId: update-account-group
      parameters:
        - name: account_group_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID del grupo de cuentas.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Nombre del grupo de cuentas (min=1, max=255).
                merchant_id:
                  type: string
                  description: Identificador local (min=1, max=255).
                parent_code:
                  type:
                    - string
                    - 'null'
                  format: uuid
                  description: >-
                    El `id` del grupo bajo el cual se anidará este grupo.
                    Omítelo para dejar el padre sin cambios; envía `null` para
                    desvincular el grupo y convertirlo de nuevo en raíz. El
                    padre debe pertenecer a la misma organización y no puede ser
                    el propio grupo ni uno de sus descendientes.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  name:
                    type: string
                  merchant_id:
                    type: string
                  parent_code:
                    type:
                      - string
                      - 'null'
                    format: uuid
                    description: >-
                      El `id` del grupo bajo el cual se anida este grupo. `null`
                      para un grupo raíz (de nivel superior).
                  created_at:
                    type: string
                    format: date-time
                  updated_at:
                    type: string
                    format: date-time
        '400':
          description: >-
            Solicitud incorrecta. El campo `code` indica el motivo:


            - `PARENT_NOT_FOUND`: no hay ningún grupo con ese `parent_code` en
            esta organización.

            - `INVALID_PARENT`: el grupo se envió como su propio padre.

            - `PARENT_IS_DESCENDANT`: el padre de destino está dentro del propio
            subárbol de este grupo, por lo que el movimiento crearía un ciclo.

            - `MAX_NESTING_DEPTH`: el movimiento llevaría el árbol más allá de
            la profundidad máxima de 20 niveles.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    description: Código de error legible por máquina.
                  messages:
                    type: array
                    items:
                      type: string
                    description: Detalles legibles por personas.
              example:
                code: PARENT_IS_DESCENDANT
                messages:
                  - >-
                    Account group [LATAM] is inside [Acme], so it cannot become
                    its parent.
        '404':
          description: >-
            No encontrado: no hay ningún grupo de cuentas con ese
            `account_group_id` en esta organización.
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: PUBLIC-API-KEY
      x-default: <Your PUBLIC-API-KEY>
    sec1:
      type: apiKey
      in: header
      name: PRIVATE-SECRET-KEY
      x-default: <Your PRIVATE-SECRET-KEY>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.