> ## Documentation Index > Fetch the complete documentation index at: https://docs.pruff.com/llms.txt > Use this file to discover all available pages before exploring further. # Asignar subordinado > Asigna un usuario como subordinado de otro. El usuario superior pasa a ver las cuentas de sus subordinados además de las suyas (por ejemplo, en `GET /wallet/user/{email}`). Identifica a cada lado de la relación con su email. Para cada lado debes enviar el email o el id; si envías ambos, se usa el id. Para crear una relación nueva, el usuario superior debe tener un rol con el permiso para tener subordinados; si no lo tiene, la solicitud responde 403. La operación es idempotente: si la relación ya existía, responde 200 con `alreadyAssigned: true` y no cambia nada, incluso si el superior ya no tiene ese permiso. ## OpenAPI ````yaml openapi/clients.yaml PATCH /user/subordinate/assign openapi: 3.1.0 info: title: API de clientes de Pruff version: '1' description: >- Endpoints que tus sistemas llaman para leer y operar los datos de tu empresa en Pruff. Todas las solicitudes van por HTTPS y se autentican con el header `x-api-key`. Las convenciones de formato, paginación y errores se describen en https://docs.pruff.com/api/introduccion. servers: - url: https://api.pruff.com/api/clients security: - ApiKeyAuth: [] tags: - name: Facturas description: Consulta de facturas electrónicas, facturas transables y cesiones. - name: Documentos description: Consulta y creación de documentos asociados a tus clientes. - name: Archivos description: Carga de archivos a operaciones y a los requerimientos de tus documentos. - name: Financiamiento description: >- Simula créditos, crea solicitudes de factoring y consulta las prórrogas de tu empresa. - name: Comité description: >- Consulta las aprobaciones de una solicitud en los comités de riesgo y de operaciones, y registra nuevas firmas. - name: Chat description: Exporta y envía mensajes del chat de una solicitud. - name: Reportes description: >- Reportes de operaciones, cartera, recaudaciones, cuentas pendientes y flujos de tu empresa. - name: Datahub description: >- Consulta de la información tributaria, financiera y de riesgo que Pruff tiene de tus clientes y deudores. - name: Mercado Público description: >- Licitaciones y órdenes de compra de Mercado Público (ChileCompra) cargadas en Pruff. - name: CRM description: >- Datos comerciales de tu CRM en Pruff: empresas con su ficha, pipeline, prospectos, gestiones y simulaciones. - name: SGR description: Operaciones SGR (garantías) de tu empresa. - name: Sincronizador description: >- Pide sincronizar a un cliente con el SII o la TGR para obtener su información más actualizada, y consulta el estado de esas sincronizaciones. - name: Usuarios description: >- Administra los usuarios de tu empresa en Pruff (crear, editar, eliminar, consultar su perfil y asignar subordinados) y consulta las cuentas (empresas conectadas) a las que cada usuario tiene acceso. - name: Contactos description: Crea contactos asociados a las empresas de tu cartera. paths: /user/subordinate/assign: patch: tags: - Usuarios summary: Asignar subordinado description: >- Asigna un usuario como subordinado de otro. El usuario superior pasa a ver las cuentas de sus subordinados además de las suyas (por ejemplo, en `GET /wallet/user/{email}`). Identifica a cada lado de la relación con su email. Para cada lado debes enviar el email o el id; si envías ambos, se usa el id. Para crear una relación nueva, el usuario superior debe tener un rol con el permiso para tener subordinados; si no lo tiene, la solicitud responde 403. La operación es idempotente: si la relación ya existía, responde 200 con `alreadyAssigned: true` y no cambia nada, incluso si el superior ya no tiene ese permiso. operationId: assignUserSubordinate requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UserSubordinateRequest' example: userEmail: jefe@example.com subordinatesUserEmail: ejecutivo@example.com responses: '200': description: Subordinado asignado, o la relación ya existía. content: application/json: schema: $ref: '#/components/schemas/UserSubordinateAssignResponse' example: message: Subordinate assigned alreadyAssigned: false '400': description: >- Falta identificar a alguno de los dos usuarios, algún valor tiene formato inválido, o intentaste asignar un usuario como subordinado de sí mismo. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missingSuperior: summary: No identificaste al usuario superior value: message: custom displayMessage: userId or userEmail is required data: errors: - path: userId message: userId or userEmail is required code: custom selfAssignment: summary: El superior y el subordinado son el mismo usuario value: message: A user cannot be their own subordinate displayMessage: Un usuario no puede ser subordinado de sí mismo. '401': $ref: '#/components/responses/Unauthorized' '403': description: >- El usuario superior no tiene el permiso para tener subordinados y la relación aún no existe. Si ya existe, responde 200 sin comprobar el permiso. content: application/json: schema: $ref: '#/components/schemas/Error' example: message: >- The user does not have the have_subordinates permission and cannot have subordinates displayMessage: >- El usuario no tiene el permiso para tener subordinados. Asígnale un rol con ese permiso antes de asignarle un subordinado. '404': description: No se encontró el usuario superior o el subordinado. content: application/json: schema: $ref: '#/components/schemas/Error' examples: superiorNotFound: summary: No se encontró al usuario superior value: message: The user was not found displayMessage: No se encontró el usuario. subordinateNotFound: summary: No se encontró al subordinado value: message: The subordinate was not found displayMessage: No se encontró el subordinado. '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalError' '504': $ref: '#/components/responses/Timeout' components: schemas: UserSubordinateRequest: type: object description: >- Identifica al usuario superior (`userId` o `userEmail`) y al subordinado (`subordinatesUserId` o `subordinatesUserEmail`). Para cada lado debes enviar al menos uno de los dos campos; si envías ambos, se usa el id y se ignora el email. properties: userId: type: integer minimum: 1 description: Id del usuario superior. Obligatorio si no envías `userEmail`. example: 12 userEmail: type: string format: email description: Email del usuario superior. Obligatorio si no envías `userId`. example: jefe@example.com subordinatesUserId: type: integer minimum: 1 description: >- Id del usuario subordinado. Obligatorio si no envías `subordinatesUserEmail`. example: 34 subordinatesUserEmail: type: string format: email description: >- Email del usuario subordinado. Obligatorio si no envías `subordinatesUserId`. example: ejecutivo@example.com UserSubordinateAssignResponse: type: object required: - message - alreadyAssigned properties: message: type: string example: Subordinate assigned alreadyAssigned: type: boolean description: >- `true` si la relación ya existía, en cuyo caso la solicitud no cambió nada; `false` si se creó en esta solicitud. example: false Error: type: object required: - message properties: message: type: string description: >- Identifica el error. En algunos casos es un texto en inglés con valores variables. Para tu lógica, usa el código HTTP y, cuando exista, `data.code`. displayMessage: type: string description: >- Mensaje pensado para mostrarlo a una persona. Normalmente en español; algunos mensajes de validación vienen en inglés. data: description: Detalle adicional del error, cuando existe. responses: Unauthorized: description: >- Falta el header `x-api-key`, su valor no es válido o la cuenta de API de tu empresa no está habilitada. content: application/json: schema: type: object required: - message properties: message: type: string example: message: 'Unauthorized: Invalid API Key' TooManyRequests: description: >- Tu empresa superó el límite de solicitudes. Todas las API keys de tu empresa comparten el mismo límite. Espera los segundos que indica el header `Retry-After` (o `data.retryAfterSeconds`) antes de reintentar. headers: Retry-After: description: Segundos que debes esperar antes de reintentar. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: message: >- Rate limit exceeded: 501 requests in the current 60s window, limit is 500. Retry in 12s. displayMessage: >- Superaste el límite de 500 solicitudes cada 60 segundos. Vuelve a intentarlo en 12 segundos. data: code: RATE_LIMIT_EXCEEDED scope: All API keys of your company share this budget. limit: 500 used: 501 windowSeconds: 60 retryAfterSeconds: 12 resetAt: '2026-11-04T15:00:12.000Z' hint: >- Wait until resetAt (or honor the Retry-After header) before retrying. Avoid repeating identical requests: reuse responses you already fetched, use filters and larger pageSize values instead of one request per item, and cap your client concurrency. InternalError: description: >- Error inesperado en Pruff. El texto de `message` puede variar (por ejemplo en mayúsculas); no dependas de él. content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Internal server error Timeout: description: >- La solicitud superó el tiempo máximo de 55 segundos. La operación puede haberse completado igual: antes de reintentar una solicitud que crea o modifica datos, verifica su estado. content: application/json: schema: $ref: '#/components/schemas/Error' example: message: request_timeout displayMessage: La solicitud excedió el tiempo máximo permitido securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key que Pruff entrega a tu empresa. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.