> ## Documentation Index > Fetch the complete documentation index at: https://docs.telepatia.ai/llms.txt > Use this file to discover all available pages before exploring further. # Atualizar um paciente > Atualiza o nome ou o internalCode de um paciente. A identidade nacional não é editável aqui. ## OpenAPI ````yaml /pt-BR/scribe-api/openapi-institutional.json patch /v1/patients/{patient_id} openapi: 3.1.0 info: title: Scribe Public API description: >- API REST externa para integração com a plataforma Telepatia. Autentique-se com chaves de API, defina o contexto da consulta e busque sessões de scribe. version: 0.1.0 servers: - url: https://scribe-api.telepatia.ai description: Production security: - BearerAuth: [] paths: /v1/patients/{patient_id}: patch: tags: - Patients summary: Atualizar um paciente description: >- Atualiza o nome ou o internalCode de um paciente. A identidade nacional não é editável aqui. operationId: api_patient_update_v1_patients__patient_id__patch parameters: - name: patient_id in: path required: true schema: type: string title: Patient Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PatientUpdateRequest' example: internalCode: EMR-99999 name: Jane Doe responses: '200': description: Resposta bem-sucedida content: application/json: schema: $ref: '#/components/schemas/PatientResponse' example: createdAt: '2026-07-01T12:00:00.000Z' id: sp_a1b2c3d4e5f6g7h8 idCountry: COLOMBIA idType: CC idValue: '1024567890' internalCode: EMR-12345 name: John Doe '400': description: >- Requisição inválida — parâmetros inválidos, falhas de validação ou campos ausentes. content: application/json: examples: parameter_missing: summary: Missing required field value: error: type: invalid_request_error code: parameter_missing message: name is required. param: name requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 parameter_invalid: summary: Invalid field value value: error: type: invalid_request_error code: parameter_invalid message: >- idCountry must be a valid country name, ISO alpha-2, or ISO alpha-3 code. param: idCountry requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 account_invalid: summary: Invalid account value: error: type: invalid_request_error code: account_invalid message: Account has no valid authId. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Não autorizado — chave de API ausente ou inválida. content: application/json: examples: authentication_required: summary: Invalid or missing API key value: error: type: authentication_error code: authentication_required message: Invalid API key. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Proibido — a chave de API não pode executar esta operação. content: application/json: examples: permission_denied: summary: Caller lacks permission for this resource value: error: type: permission_error code: permission_denied message: You do not have permission to access this resource. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 permission_denied_role: summary: API key's account role is not allowed this operation value: error: type: permission_error code: permission_denied message: >- Your API key is not allowed to create accounts. Account creation requires an institutional API key; this key is scoped to a doctor account. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Não encontrado — o recurso solicitado não existe. content: application/json: examples: resource_not_found: summary: Resource not found value: error: type: invalid_request_error code: resource_not_found message: No session scribe found for the given consultation ID. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 schema: $ref: '#/components/schemas/ErrorResponse' '409': description: Conflito — o recurso já existe ou está em estado conflitante. content: application/json: examples: resource_conflict: summary: Resource conflict value: error: type: invalid_request_error code: resource_conflict message: >- consultationInternalId is already in use by a different consultation. param: consultationInternalId requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Serviço indisponível — uma dependência externa está indisponível. content: application/json: examples: service_unavailable: summary: External service unavailable value: error: type: api_error code: service_unavailable message: >- The service is temporarily unavailable. Please try again later. requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: PatientUpdateRequest: properties: name: anyOf: - type: string maxLength: 500 minLength: 1 - type: 'null' title: Name description: New display name. examples: - Jane Doe internalCode: anyOf: - type: string maxLength: 128 minLength: 1 - type: 'null' title: Internalcode description: >- Caller-provided internal code, unique within your institution. Omit to leave unchanged; send null to clear. examples: - EMR-99999 type: object title: PatientUpdateRequest description: >- Request body for updating a patient. All fields optional; at least one required. The national identity (idCountry/idType/idValue) is not editable here — it stays the deduplication key. `internalCode` follows PATCH semantics: omit to leave it unchanged, send null to clear it. examples: - internalCode: EMR-99999 name: Jane Doe PatientResponse: properties: id: type: string title: Id description: Stable public identifier. examples: - sp_a1b2c3d4e5f6g7h8 name: type: string title: Name examples: - John Doe idCountry: anyOf: - type: string - type: 'null' title: Idcountry examples: - COLOMBIA idType: anyOf: - type: string - type: 'null' title: Idtype examples: - CC idValue: anyOf: - type: string - type: 'null' title: Idvalue examples: - '1024567890' internalCode: anyOf: - type: string - type: 'null' title: Internalcode description: Caller-provided internal code for your institution (null if none). examples: - EMR-12345 createdAt: type: string title: Createdat description: ISO-8601 timestamp when the patient was created. type: object required: - id - name - createdAt title: PatientResponse description: A single patient. `id` is the stable public id (sp_...). examples: - createdAt: '2026-07-01T12:00:00.000Z' id: sp_a1b2c3d4e5f6g7h8 idCountry: COLOMBIA idType: CC idValue: '1024567890' internalCode: EMR-12345 name: John Doe ErrorResponse: description: Envelope padronizado de resposta de erro. properties: error: $ref: '#/components/schemas/ErrorDetailWithRequestId' required: - error title: ErrorResponse type: object ErrorDetailWithRequestId: description: >- Top-level error object: :class:`ErrorDetail` plus the request correlation id. Kept as a subclass rather than a field on ``ErrorDetail`` because ``ErrorDetail`` is also the per-item error shape inside the batch account-creation response (``BatchAccountResult.error``), which is serialized with nulls included. Adding the field there would publish ``"requestId": null`` on an HTTP 200, and there is only ever one request id per batch anyway -- batch callers read the ``X-Request-ID`` response header. properties: type: description: Broad error category for high-level handling. examples: - invalid_request_error title: Type type: string code: description: Machine-readable error code. Clients should switch on this value. examples: - parameter_invalid title: Code type: string message: description: Human-readable error message ending with a period. examples: - >- idCountry must be a valid country name, ISO alpha-2, or ISO alpha-3 code. title: Message type: string param: anyOf: - type: string - type: 'null' default: null description: The request field that caused the error, if applicable. examples: - idCountry title: Param details: anyOf: - additionalProperties: true type: object - type: 'null' default: null description: Optional structured, machine-readable context for the error. examples: - pendingConsultations: - sessionId: abc123 url: https://... title: Details requestId: anyOf: - type: string - type: 'null' default: null description: >- Unique id for this request, identical to the X-Request-ID response header. Quote it when contacting support. examples: - 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30 title: Requestid required: - type - code - message title: ErrorDetailWithRequestId type: object securitySchemes: BearerAuth: type: http scheme: bearer description: Chave de API enviada como token Bearer ````