> ## Documentation Index > Fetch the complete documentation index at: https://docs.iron.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Update a webhook > Updates an existing webhook for the currently authenticated partner ## OpenAPI ````yaml /spec.yaml patch /webhooks/{id} openapi: 3.1.0 info: description: The Stablecoin Payment Network title: Iron API - Sandbox version: 1.0-16670 servers: - url: https://api.sandbox.iron.xyz/api security: [] tags: - description: >- Wallet and bank account registration Every wallet address that interacts with Iron must be registered (linked) to a customer **before** it can be used in any flow — onramp, offramp, or swap. This is a regulatory requirement under the **Travel Rule**, which obliges Virtual Asset Service Providers to exchange originator and beneficiary information for crypto transfers. Iron supports two wallet types: - **Self-hosted wallets** — the customer controls the private key. Registration requires a signed proof-of-ownership message. - **Hosted wallets** — the wallet is custodied by another VASP (e.g. Coinbase, Kraken). Registration requires the VASP's DID so Iron can exchange travel-rule data with the custodian. Similarly, fiat bank accounts must be registered before they can receive offramp payouts. name: Addresses - description: Operations on Autoramp name: Autoramp - description: Operations on Chronicle collateral name: ChronicleCollateral - description: Operations on Currencies name: Currencies - description: Operations on Customers name: Customer - description: Operations on Exchange Rate name: ExchangeRate - description: Operations on Fee Profiles name: FeeProfiles - description: Operations for Sandbox Testing name: Sandbox - description: Operations on SSE name: Sse - description: Operations on Terms and Conditions name: TermsAndConditions - description: Operations on Webhooks name: Webhooks paths: /webhooks/{id}: patch: tags: - Webhooks summary: Update a webhook description: | Updates an existing webhook for the currently authenticated partner operationId: updateWebhook parameters: - deprecated: false description: >- Optional sub-partner UUID, if provided, the webhook will be updated under scope of the sub-partner explode: true in: header name: X-SUB-PARTNER-ID required: false schema: type: string - deprecated: false description: The ID of the webhook to update explode: true in: path name: id required: true schema: format: uuid type: string requestBody: content: application/json; charset=utf-8: schema: $ref: '#/components/schemas/UpdateWebhookRequest' description: The webhook update request required: true responses: '200': content: application/json; charset=utf-8: schema: $ref: '#/components/schemas/Webhook' description: Update successful '400': content: application/json; charset=utf-8: schema: type: string description: Bad request (e.g. invalid data) '401': content: application/json; charset=utf-8: schema: type: string description: Unauthorized '404': content: application/json; charset=utf-8: schema: type: string description: Not Found '500': content: application/json; charset=utf-8: schema: $ref: '#/components/schemas/ApiError' description: Failed to update the webhook security: - ApiKeyAuth: [] components: schemas: UpdateWebhookRequest: description: | Update Webhook Request Request to update an existing webhook properties: enabled: description: Optional enabled status type: boolean label: description: Optional new label for the webhook type: string topics: description: Optional new topics for the webhook items: $ref: '#/components/schemas/WebhookEventType' type: array url: description: Optional new URL for the webhook type: string title: UpdateWebhookRequest type: object Webhook: description: | Webhook Response containing webhook details properties: created_at: description: When the webhook was created format: date-time type: string enabled: description: Whether the webhook is enabled type: boolean id: description: The ID of the webhook format: uuid type: string label: description: A descriptive label for the webhook type: string last_failure: description: The last time the webhook was executed with an error format: date-time type: string last_failure_reason: description: The reason for the last failure type: string partner_id: description: The partner ID that owns this webhook format: uuid type: string topics: description: The topics this webhook subscribes to items: $ref: '#/components/schemas/WebhookEventType' type: array updated_at: description: When the webhook was last updated format: date-time type: string url: description: The URL to send webhook events to type: string required: - id - label - url - partner_id - topics - created_at - updated_at - enabled title: Webhook type: object ApiError: description: |- Standard error response returned to API clients for server errors. Includes a trace_id that clients can reference when reporting issues. properties: message: description: Human-readable error message type: string trace_id: description: Trace ID that can be used to look up request details in logs type: string required: - message - trace_id title: ApiError type: object WebhookEventType: description: | Webhook Event Types Represents the different types of webhook events that can be sent enum: - Transaction - NewBankAccount - NewAutoramp - DepositAddressCreated - RegisterFiatAddressStatus - RegisterAutorampStatus - TransactionStatus - CustomerCreated - CustomerStatus - IdentificationStatus - Ping type: string securitySchemes: ApiKeyAuth: description: API Key in: header name: X-API-Key type: apiKey ````