> ## Documentation Index > Fetch the complete documentation index at: https://developers.tiendadepuntos.com/llms.txt > Use this file to discover all available pages before exploring further. # Actualizar un operador > Actualiza los datos personales del operador y, si mandás `branches`, reemplaza sus asignaciones de sucursal y permisos por las que envíes. Los datos personales son incrementales: lo que no mandes queda como está. El email, la contraseña y el documento no se editan por acá — el email es la identidad con la que el operador entra al panel y la contraseña tiene su propio flujo de reseteo. ## OpenAPI ````yaml /api-reference/openapi.json put /external/operators/{id} openapi: 3.0.0 info: title: API de Tienda de Puntos description: >- API pública de Tienda de Puntos. Permite sumar puntos por compra, consultar clientes, validar canjes y consumir cupones desde tu POS, ERP o e-commerce. Todas las llamadas se autentican con el header `x-api-key`. version: 0.0.1 contact: {} servers: - url: https://api.tiendadepuntos.com description: Producción - url: https://apidev.tiendadepuntos.com description: Desarrollo security: - ApiKeyAuth: [] tags: [] paths: /external/operators/{id}: put: tags: - Operadores summary: Actualizar un operador description: >- Actualiza los datos personales del operador y, si mandás `branches`, reemplaza sus asignaciones de sucursal y permisos por las que envíes. Los datos personales son incrementales: lo que no mandes queda como está. El email, la contraseña y el documento no se editan por acá — el email es la identidad con la que el operador entra al panel y la contraseña tiene su propio flujo de reseteo. operationId: ExternalOperatorController_update parameters: - name: id required: true in: path description: ID del operador en Tienda de Puntos. schema: type: integer example: 3312 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateExternalOperatorDto' responses: '200': description: Operador actualizado. content: application/json: schema: type: object properties: success: type: boolean example: true status: type: integer example: 200 message: type: string example: Request was successful data: $ref: '#/components/schemas/ExternalOperatorOutputDto' required: - success - status - message '400': description: El cuerpo o los parámetros no pasaron la validación. content: application/json: schema: type: object properties: statusCode: type: integer example: 400 timestamp: type: string format: date-time example: '2026-07-31T14:05:12.431Z' path: type: string example: /external/tags/add method: type: string example: POST message: type: string example: Error de validación errors: type: array nullable: true items: type: object data: type: object nullable: true '404': description: >- Falta el header `x-api-key` (`Api Key is required`) o la API key no corresponde a ningún comercio (`Business not found`). También se usa cuando el recurso pedido no existe. content: application/json: schema: type: object properties: statusCode: type: integer example: 404 timestamp: type: string format: date-time example: '2026-07-31T14:05:12.431Z' path: type: string example: /external/tags/add method: type: string example: POST message: type: string example: Api Key is required errors: type: array nullable: true items: type: object data: type: object nullable: true security: - ApiKeyAuth: [] components: schemas: UpdateExternalOperatorDto: type: object properties: firstName: type: string description: Nombre del operador. example: Ana lastName: type: string description: Apellido del operador. example: Gómez phone: type: string description: Teléfono. example: '+541164593678' birthday: type: string description: Fecha de nacimiento en ISO 8601. example: '1990-01-01' branches: description: >- Sucursales y permisos del operador. Si se omite, el operador queda creado sin asignaciones y no puede operar hasta que se le asigne una desde el panel. type: array items: $ref: '#/components/schemas/ExternalOperatorBranchInputDto' ExternalOperatorOutputDto: type: object properties: id: type: number description: ID del operador en Tienda de Puntos. example: 3312 role: type: string description: >- Rol del operador. `admin` administra el comercio completo; `operator` opera en las sucursales que tenga asignadas. enum: - admin - operator example: operator firstName: type: string description: Nombre. example: Ana lastName: type: string description: Apellido. example: Gómez fullName: type: string description: Nombre completo. example: Ana Gómez email: type: string description: Email con el que el operador ingresa al panel. example: ana@micomercio.com nullable: true documentNumber: type: string description: Número de documento. example: '40100800' nullable: true phone: type: string description: Teléfono. example: '+541164593678' nullable: true birthday: format: date-time type: string example: '1990-01-01T00:00:00.000Z' nullable: true hasCompletedOnboarding: type: boolean description: Si el operador ya terminó el onboarding del panel. example: false branches: description: Sucursales y permisos asignados. Los `admin` no tienen asignaciones. type: array items: $ref: '#/components/schemas/ExternalOperatorBranchOutputDto' createdAt: format: date-time type: string example: '2026-02-14T12:30:00.000Z' updatedAt: format: date-time type: string example: '2026-06-01T09:15:00.000Z' required: - id - role - firstName - lastName - fullName - email - documentNumber - phone - birthday - hasCompletedOnboarding - branches - createdAt - updatedAt ExternalOperatorBranchInputDto: type: object properties: branchId: type: number description: >- Sucursal en la que opera. Los IDs salen de `GET /external/branch`. Si se omite, el operador queda sin sucursal asignada. example: 1972 permissionGroupId: type: number description: >- Grupo de permisos con el que opera en esa sucursal. Los grupos se crean en el panel; sus IDs aparecen en el campo `branches` de cualquier operador ya configurado. Si se omite, el operador queda sin permisos hasta que se le asigne un grupo desde el panel. example: 12 ExternalOperatorBranchOutputDto: type: object properties: branchId: type: number description: >- Sucursal asignada. `null` si el operador no está atado a una sucursal puntual. example: 1972 nullable: true branchName: type: string description: Nombre de la sucursal. example: Sucursal Centro nullable: true permissionGroupId: type: number description: >- Grupo de permisos con el que opera en esa sucursal. `null` si todavía no tiene uno asignado. example: 12 nullable: true permissionGroupName: type: string description: Nombre del grupo de permisos. example: Cajeros nullable: true required: - branchId - branchName - permissionGroupId - permissionGroupName securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API key del comercio. Se genera desde el panel de Tienda de Puntos, en Configuración → Integraciones. ````