> ## Documentation Index > Fetch the complete documentation index at: https://docs.ebury.com/llms.txt > Use this file to discover all available pages before exploring further. # Update a beneficiary Update a single beneficiary by beneficiary ID, using a list of names and values. We do not currently support `PUT`. This may be supported in a later release. ## OpenAPI ````yaml /openapi.json patch /beneficiaries/{beneficiary_id} openapi: 3.0.0 info: description: | Ebury API allows customers: to retrieve accounts, balances, beneficiaries, and transactions; to get buy/sell estimates and quotes, book trades and retrieve trade history; to allocate payments to a trade and beneficiary, and to submit payments in bulk; to download documents such as trade receipt, payment instruction and payment receipt; to manage the authorised persons on their account. The Metadata API allows applications to clarify some parts of the Ebury API that are impractical to express schematically. termsOfService: https://docs.ebury.io/#terms-of-use title: Ebury API version: '0.1' servers: - url: https://{environment}.ebury.io variables: environment: default: api enum: - api - sandbox security: - api_key: [] paths: /beneficiaries/{beneficiary_id}: parameters: - $ref: '#/components/parameters/BeneficiaryId' - $ref: '#/components/parameters/ClientId' - $ref: '#/components/parameters/Authorization' - $ref: '#/components/parameters/XContactID' patch: tags: - Beneficiaries summary: Update a beneficiary description: Update a beneficiary by beneficiary's identifier. operationId: beneficiary_patch requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateBeneficiary' description: List of field names and values for update an existing beneficiary. required: true responses: '204': $ref: '#/components/responses/BeneficiaryUpdated' '400': $ref: '#/components/responses/ValidationError' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/BeneficiaryOrClientNotFound' '409': $ref: '#/components/responses/Forbidden' '502': $ref: '#/components/responses/IntegrationError' components: parameters: BeneficiaryId: description: The identifier of a beneficiary. in: path name: beneficiary_id required: true schema: type: string ClientId: description: The identifier of a client. in: query name: client_id required: true schema: type: string Authorization: description: The access token. in: header name: Authorization required: true schema: type: string XContactID: description: The identifier of a contact. in: header name: X-Contact-ID required: false schema: type: string schemas: UpdateBeneficiary: allOf: - $ref: '#/components/schemas/BankAccountCoreData' - $ref: '#/components/schemas/BeneficiaryCoreData' description: >- The data to update a beneficiary. After a beneficiary has received a payment, the only fields available for modification are email_addresses, email_notification and beneficiary_reference. type: object BankAccountCoreData: description: >- The data of the bank account. Refer to the Metadata API for valid field combinations. properties: account_number: description: The account number of the bank account. type: string bank_address_line_1: description: The first address line of the bank. type: string bank_country_code: description: The ISO 3166-1 alpha-2 code of the bank's country. pattern: '[A-Z]{2}' type: string bank_currency_code: description: The ISO 4217 code of the bank account's currency. pattern: '[A-Z]{3}' type: string bank_identifier: description: The identifier of the bank. type: string bank_name: description: Name of the bank account holder. type: string correspondent_account: description: The account for the correspondant account of the bank. type: string correspondent_swift_code: description: The SWIFT code for the correspondant account of the bank. type: string iban: description: The IBAN of the bank account. type: string inn: description: The INN of the bank account. type: string kbk: description: The KBK of the bank account. type: string kio: description: The KIO of the bank account. type: string kpp: description: The KPP of the bank account. type: string purpose_of_payment: description: >- Text explaining the purpose of payment. Required by the Central Bank for all payments sent to China (CHN) in the Chinese Renminbi (CNY) currency or United Arab Emirates in any currency (GDE to RDA) [Coming soon]. enum: - /CGODDR/ - /CGODDR/PART/ - /CGODDR/RETN/ - /CSTRDR/ - /CSTRDR/PART/ - /CSTRDR/RETN/ - /COCADR/ - /COCADR/RTN/ - /CCTFDR/ - /CCTFDR/PART/ - /CCTFDR/RETN/ - /CCDNDR/ - /CCDNDR/RTN/ - GDE - GDI - GMS - STS - ATS - OTS - STR - SCO - INS - FIS - IPC - TCS - ITS - IFS - RDS - PMS - TTS - PRS - GOS - SAL - IGD - IID - PIP - PRR - DOE - ISH - ISL - ISS - IOL - IOD - GRI - CHC - EDU - ALW - AES - LAS - OVT - TKT - SAA - COP - COM - EOS - BON - PEN - UTL - DCP - LND - LIP - IPO - POR - RNT - LNC - EMI - DIV - ACM - CCP - POS - MCR - CIN - TOF - IGT - OAT - SVI - SVO - SVP - MWI - MWO - MWP - PRP - PRW - IRP - IRW - CEA - PPA - DSF - DLF - FSA - FIA - DSA - DLA - FDA - AFA - SLA - LLA - LEA - RFS - TCR - CEL - PPL - LDS - LDL - FSL - FIL - DSL - DLL - FDL - AFL - SLL - LLL - LEL - RLS - TCP - TAX - REL - RDL - REA - RDA type: string reason_for_trade: description: The reason for trade of the bank account. type: string reference_information: description: The reference information of the bank account. type: string russian_central_bank_account: description: The Russian central account number of the bank account. type: string swift_code: description: The SWIFT code of the bank account. type: string vo: description: The VO of the bank account. type: string required: - bank_country_code - bank_currency_code type: object BeneficiaryCoreData: description: The core data of a beneficiary. properties: address_line_1: description: The first address line of the beneficiary. type: string beneficiary_reference: description: The reference for the beneficiary. type: string country_code: description: The ISO 3166-1 alpha-2 code of the beneficiary's country. pattern: '[A-Z]{2}' type: string email_addresses: description: The list of beneficiary's email addresses. items: format: email type: string type: array email_notification: description: >- Whether the beneficiary should receive email notification of payments. type: boolean name: description: The name of the beneficiary. type: string post_code: description: The post code of the beneficiary. type: string type: object ErrorMessage: description: An error message. properties: code: type: string description: The code for the error. details: description: Error details type: string message: type: string description: A short description of the cause of the error. required: - code - message - details type: object responses: BeneficiaryUpdated: description: Beneficiary updated. ValidationError: description: >- Formatting, parameter or schema validation error. See error message for further details. content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' Unauthorized: description: Access denied due to authentication failure. Forbidden: description: >- Could not complete action due to data constraints. Refer to error message for additional details. content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' BeneficiaryOrClientNotFound: description: Beneficiary or client identifier not found. IntegrationError: description: Internal integration error. content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' securitySchemes: api_key: description: An API Key. in: header name: x-api-key type: apiKey ````