> ## Documentation Index
> Fetch the complete documentation index at: https://developers.dwolla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Resolve alert

> Resolves an alert for your Dwolla account by setting its `status` to `resolved`. Returns the updated alert, with `status` set to `resolved`, the `resolved` timestamp set, and no `resolve` link.

You can only resolve an alert that has a `resolve` link in its `_links`. The link is present only while the alert is `open` and can be resolved, so check for it before resolving an alert.

Resolving an alert changes only the alert itself: its `status` becomes `resolved`, and `actionRequired` is removed when no further action is needed. It doesn't release holds on transfers or change the Customer, and it doesn't take the action described in `actionRequired` for you.

Resolving an alert that's already resolved, or that you can't resolve, returns a `400 ValidationError` error with the embedded code `NotAllowed`, and the alert isn't changed.

Alerts are in active development and must be enabled for your account. To enable alerts, please [reach out to Dwolla](https://www.dwolla.com/contact?b=apidocs).

Requires an application access token for your account. Returns a `404 NotFound` error if the alert doesn't exist.




## OpenAPI

````yaml post /alerts/{id}
openapi: 3.1.0
info:
  title: Dwolla API
  description: Dwolla API Documentation
  contact:
    name: Dwolla Developer Relations Team
    url: https://developers.dwolla.com
    email: api@dwolla.com
  version: '2.0'
  termsOfService: https://www.dwolla.com/legal/tos/
  license:
    name: MIT
    url: https://github.com/Dwolla/dwolla-openapi/blob/master/LICENSE
servers:
  - url: https://api.dwolla.com
    description: Production server
  - url: https://api-sandbox.dwolla.com
    description: Sandbox server
security:
  - clientCredentials: []
tags:
  - name: tokens
    description: Operations related to Application Access Tokens
  - name: root
    description: Root API operations
  - name: accounts
    description: Operations related to Accounts
  - name: customers
    description: Operations related to Customers
  - name: kba
    description: Operations related to Knowledge-Based Authentication
  - name: beneficial owners
    description: Operations related to Beneficial Owners
  - name: documents
    description: Operations related to Documents
  - name: exchanges
    description: Operations related to Exchanges
  - name: exchange sessions
    description: Operations related to Exchange Sessions
  - name: funding sources
    description: Operations related to Funding Sources
  - name: transfers
    description: Operations related to Transfers
  - name: labels
    description: Operations related to Labels
  - name: mass payments
    description: Operations related to Mass Payments
  - name: events
    description: Operations related to Events
  - name: alerts
    description: Operations related to Alerts
  - name: webhook subscriptions
    description: Operations related to Webhook Subscriptions
  - name: webhooks
    description: Operations related to Webhooks
  - name: client tokens
    description: Operations related to Client Tokens
  - name: sandbox simulations
    description: Sandbox-only operations for simulating processing of bank transfers
paths:
  /alerts/{id}:
    post:
      tags:
        - alerts
      summary: Resolve alert
      description: >
        Resolves an alert for your Dwolla account by setting its `status` to
        `resolved`. Returns the updated alert, with `status` set to `resolved`,
        the `resolved` timestamp set, and no `resolve` link.


        You can only resolve an alert that has a `resolve` link in its `_links`.
        The link is present only while the alert is `open` and can be resolved,
        so check for it before resolving an alert.


        Resolving an alert changes only the alert itself: its `status` becomes
        `resolved`, and `actionRequired` is removed when no further action is
        needed. It doesn't release holds on transfers or change the Customer,
        and it doesn't take the action described in `actionRequired` for you.


        Resolving an alert that's already resolved, or that you can't resolve,
        returns a `400 ValidationError` error with the embedded code
        `NotAllowed`, and the alert isn't changed.


        Alerts are in active development and must be enabled for your account.
        To enable alerts, please [reach out to
        Dwolla](https://www.dwolla.com/contact?b=apidocs).


        Requires an application access token for your account. Returns a `404
        NotFound` error if the alert doesn't exist.
      operationId: updateAlert
      parameters:
        - name: id
          in: path
          description: The alert's unique identifier.
          required: true
          schema:
            type: string
            format: uuid
            example: d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42
        - $ref: '#/components/parameters/Accept'
      requestBody:
        required: true
        description: Parameters to resolve an alert
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAlert'
            examples:
              resolve:
                summary: Resolve an alert
                value:
                  status: resolved
      responses:
        '200':
          description: successful operation
          headers: {}
          content:
            application/vnd.dwolla.v1.hal+json:
              schema:
                $ref: '#/components/schemas/Alert'
              examples:
                resolved_unusual_transfer_activity:
                  summary: Resolved unusual transfer activity alert
                  value:
                    _links:
                      self:
                        href: >-
                          https://api-sandbox.dwolla.com/alerts/d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42
                        type: application/vnd.dwolla.v1.hal+json
                        resource-type: alert
                      customer:
                        href: >-
                          https://api-sandbox.dwolla.com/customers/b0e1c5a6-2f3d-4e7a-8c9b-1d2e3f4a5b6c
                        type: application/vnd.dwolla.v1.hal+json
                        resource-type: customer
                      transfers:
                        href: >-
                          https://api-sandbox.dwolla.com/customers/b0e1c5a6-2f3d-4e7a-8c9b-1d2e3f4a5b6c/transfers
                        type: application/vnd.dwolla.v1.hal+json
                        resource-type: transfer
                    id: d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42
                    type: unusual-transfer-activity
                    status: resolved
                    description: >-
                      Unusual transfer activity was detected for one of your
                      customers.
                    created: '2026-10-14T16:32:08.000Z'
                    lastUpdated: '2026-10-16T09:12:44.000Z'
                    resolved: '2026-10-16T09:12:44.000Z'
                    unusualTransferActivity:
                      transferCount: 12
                      totalAmount:
                        value: '48250.00'
                        currency: USD
        '400':
          description: Bad Request
          headers: {}
          content:
            application/vnd.dwolla.v1.hal+json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/UpdateAlertStatusInvalidError'
                  - $ref: '#/components/schemas/UpdateAlertStatusNotAllowedError'
              examples:
                status_invalid:
                  summary: status is missing or isn't resolved
                  value:
                    code: ValidationError
                    message: >-
                      Validation error(s) present. See embedded errors list for
                      more details.
                    _embedded:
                      errors:
                        - code: Invalid
                          message: Status invalid.
                          path: /status
                          _links: {}
                status_not_allowed:
                  summary: Alert is already resolved or can't be resolved
                  value:
                    code: ValidationError
                    message: >-
                      Validation error(s) present. See embedded errors list for
                      more details.
                    _embedded:
                      errors:
                        - code: NotAllowed
                          message: Status not allowed.
                          path: /status
                          _links: {}
        '401':
          description: Unauthorized
          headers: {}
          content:
            application/vnd.dwolla.v1.hal+json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: InvalidScope
                  message:
                    type: string
                    example: Missing or invalid scopes for requested endpoint.
        '403':
          description: Forbidden
          headers: {}
          content:
            application/vnd.dwolla.v1.hal+json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: InvalidTokenType
                  message:
                    type: string
                    example: The requested endpoint requires an account token.
        '404':
          description: Not Found
          headers: {}
          content:
            application/vnd.dwolla.v1.hal+json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
      x-codeSamples:
        - lang: bash
          source: >
            POST
            https://api-sandbox.dwolla.com/alerts/d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42

            Content-Type: application/json

            Accept: application/vnd.dwolla.v1.hal+json

            Authorization: Bearer
            pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY


            {
              "status": "resolved"
            }


            ...


            {
              "_links": {
                "self": {
                  "href": "https://api-sandbox.dwolla.com/alerts/d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42",
                  "type": "application/vnd.dwolla.v1.hal+json",
                  "resource-type": "alert"
                },
                "customer": {
                  "href": "https://api-sandbox.dwolla.com/customers/b0e1c5a6-2f3d-4e7a-8c9b-1d2e3f4a5b6c",
                  "type": "application/vnd.dwolla.v1.hal+json",
                  "resource-type": "customer"
                },
                "transfers": {
                  "href": "https://api-sandbox.dwolla.com/customers/b0e1c5a6-2f3d-4e7a-8c9b-1d2e3f4a5b6c/transfers",
                  "type": "application/vnd.dwolla.v1.hal+json",
                  "resource-type": "transfer"
                }
              },
              "id": "d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42",
              "type": "unusual-transfer-activity",
              "status": "resolved",
              "description": "Unusual transfer activity was detected for one of your customers.",
              "created": "2026-10-14T16:32:08.000Z",
              "lastUpdated": "2026-10-16T09:12:44.000Z",
              "resolved": "2026-10-16T09:12:44.000Z",
              "unusualTransferActivity": {
                "transferCount": 12,
                "totalAmount": {
                  "value": "48250.00",
                  "currency": "USD"
                }
              }
            }
        - lang: javascript
          source: >
            // Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node

            var alertUrl =
              "https://api-sandbox.dwolla.com/alerts/d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42";
            var requestBody = {
              status: "resolved",
            };


            dwolla.post(alertUrl, requestBody).then((res) => res.body.status);
            // => 'resolved'
        - lang: python
          source: >
            # Using dwollav2 - https://github.com/Dwolla/dwolla-v2-python

            alert_url =
            'https://api-sandbox.dwolla.com/alerts/d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42'

            request_body = {
              'status': 'resolved'
            }


            alert = app_token.post(alert_url, request_body)

            alert.body['status'] # => 'resolved'
        - lang: php
          source: |
            /**
             * No example for this language yet.
             **/
        - lang: ruby
          source: >
            # Using dwolla_v2 - https://github.com/Dwolla/dwolla-v2-ruby

            alert_url =
            'https://api-sandbox.dwolla.com/alerts/d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42'

            request_body = {
              "status" => "resolved"
            }


            alert = app_token.post alert_url, request_body

            alert.status # => "resolved"
components:
  parameters:
    Accept:
      name: Accept
      in: header
      required: true
      description: >-
        The media type of the response. Must be
        application/vnd.dwolla.v1.hal+json
      schema:
        type: string
        enum:
          - application/vnd.dwolla.v1.hal+json
        default: application/vnd.dwolla.v1.hal+json
  schemas:
    UpdateAlert:
      title: UpdateAlert
      description: >-
        Parameters to update an alert. Currently, the only supported update is
        resolving the alert.
      type: object
      required:
        - status
      properties:
        status:
          type: string
          description: The alert's new status. Must be `resolved`.
          const: resolved
          example: resolved
    Alert:
      title: Alert
      description: >-
        A notification about activity on your account that may need your
        attention.
      type: object
      required:
        - _links
        - id
        - type
        - status
        - description
        - created
        - lastUpdated
      properties:
        _links:
          type: object
          required:
            - self
          properties:
            self:
              description: The alert's resource URI.
              allOf:
                - $ref: '#/components/schemas/HalLink'
              example:
                href: >-
                  https://api.dwolla.com/alerts/d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42
                type: application/vnd.dwolla.v1.hal+json
                resource-type: alert
            customer:
              description: >-
                The Customer the alert is about. Present only when the alert is
                related to a Customer.
              allOf:
                - $ref: '#/components/schemas/HalLink'
              example:
                href: >-
                  https://api.dwolla.com/customers/b0e1c5a6-2f3d-4e7a-8c9b-1d2e3f4a5b6c
                type: application/vnd.dwolla.v1.hal+json
                resource-type: customer
            transfers:
              description: >-
                The Customer's transfers. Present only when the alert is related
                to a Customer's transfers.
              allOf:
                - $ref: '#/components/schemas/HalLink'
              example:
                href: >-
                  https://api.dwolla.com/customers/b0e1c5a6-2f3d-4e7a-8c9b-1d2e3f4a5b6c/transfers
                type: application/vnd.dwolla.v1.hal+json
                resource-type: transfer
            resolve:
              description: >-
                Resolves the alert. Present only while the alert is `open` and
                can be resolved. To resolve the alert, send a `POST` request to
                this link with `{"status": "resolved"}`. Check for this link
                before resolving an alert.
              allOf:
                - $ref: '#/components/schemas/HalLink'
              example:
                href: >-
                  https://api.dwolla.com/alerts/d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42
                type: application/vnd.dwolla.v1.hal+json
                resource-type: alert
        id:
          type: string
          format: uuid
          description: The alert's unique identifier.
          example: d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42
        type:
          type: string
          description: >
            The kind of alert. Currently the only value is
            `unusual-transfer-activity`. More types may be added in the future,
            so handle values you don't recognize.
          enum:
            - unusual-transfer-activity
          x-speakeasy-unknown-values: allow
          example: unusual-transfer-activity
        status:
          type: string
          description: Whether the alert is still `open` or has been `resolved`.
          enum:
            - open
            - resolved
          example: open
        description:
          type: string
          description: A human-readable description of the alert.
          example: Unusual transfer activity was detected for one of your customers.
        actionRequired:
          $ref: '#/components/schemas/ActionRequired'
        created:
          type: string
          format: date-time
          description: When the alert was created.
          example: '2026-10-14T16:32:08.000Z'
        lastUpdated:
          type: string
          format: date-time
          description: When the alert last changed.
          example: '2026-10-14T16:32:08.000Z'
        resolved:
          type: string
          format: date-time
          description: When the alert was resolved. Omitted while the alert is unresolved.
          example: '2026-10-16T09:12:44.000Z'
        unusualTransferActivity:
          $ref: '#/components/schemas/UnusualTransferActivity'
    UpdateAlertStatusInvalidError:
      title: UpdateAlertStatusInvalidError
      description: The request body's `status` is missing or isn't `resolved`.
      type: object
      example:
        code: ValidationError
        message: >-
          Validation error(s) present. See embedded errors list for more
          details.
        _embedded:
          errors:
            - code: Invalid
              message: Status invalid.
              path: /status
              _links: {}
      required:
        - code
        - message
        - _embedded
      properties:
        code:
          type: string
          example: ValidationError
        message:
          type: string
          example: >-
            Validation error(s) present. See embedded errors list for more
            details.
        _embedded:
          type: object
          required:
            - errors
          properties:
            errors:
              type: array
              minItems: 1
              items:
                type: object
                required:
                  - code
                  - message
                  - path
                properties:
                  code:
                    type: string
                    enum:
                      - Invalid
                    example: Invalid
                  message:
                    type: string
                    example: Status invalid.
                  path:
                    type: string
                    example: /status
                  _links:
                    type: object
                    example: {}
    UpdateAlertStatusNotAllowedError:
      title: UpdateAlertStatusNotAllowedError
      description: >-
        The alert can't be resolved, such as when it's already resolved or
        doesn't have a `resolve` link.
      type: object
      example:
        code: ValidationError
        message: >-
          Validation error(s) present. See embedded errors list for more
          details.
        _embedded:
          errors:
            - code: NotAllowed
              message: Status not allowed.
              path: /status
              _links: {}
      required:
        - code
        - message
        - _embedded
      properties:
        code:
          type: string
          example: ValidationError
        message:
          type: string
          example: >-
            Validation error(s) present. See embedded errors list for more
            details.
        _embedded:
          type: object
          required:
            - errors
          properties:
            errors:
              type: array
              minItems: 1
              items:
                type: object
                required:
                  - code
                  - message
                  - path
                properties:
                  code:
                    type: string
                    enum:
                      - NotAllowed
                    example: NotAllowed
                  message:
                    type: string
                    example: Status not allowed.
                  path:
                    type: string
                    example: /status
                  _links:
                    type: object
                    example: {}
    NotFoundError:
      title: NotFoundError
      description: Error response schema for 404 NotFound
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          example: NotFound
        message:
          type: string
          example: The requested resource was not found.
    HalLink:
      title: HalLink
      type: object
      properties:
        href:
          type: string
          example: https://api.dwolla.com
        type:
          type: string
          example: application/vnd.dwolla.v1.hal+json
        resource-type:
          type: string
          example: resource-type
    ActionRequired:
      title: ActionRequired
      description: >-
        What you need to do to address the alert. Present only while action is
        required from you. More members may be added to this object in the
        future.
      type: object
      required:
        - description
      properties:
        description:
          type: string
          description: >-
            Instructions for addressing the alert, as plain text (not markdown).
            Paragraphs are separated by blank lines.
          example: >-
            Your feedback is required to complete this customer's review. Please
            review the activity and email risk@dwolla.com to confirm the
            appropriate action.


            Approve Transfers: Activity is expected.

            Suspend Customer: Activity is not expected.


            Please include the customer ID and provide an explanation for the
            proposed action. We will reach out if we require more information.
    UnusualTransferActivity:
      title: UnusualTransferActivity
      description: >-
        Details of the transfer activity that triggered an
        `unusual-transfer-activity` alert. Omitted for alerts without these
        details.
      type: object
      required:
        - transferCount
        - totalAmount
      properties:
        transferCount:
          type: integer
          description: The number of transfers involved in the activity.
          example: 12
        totalAmount:
          description: The total amount of the transfers involved in the activity.
          allOf:
            - $ref: '#/components/schemas/TransferAmount'
          example:
            value: '48250.00'
            currency: USD
    TransferAmount:
      title: TransferAmount
      type: object
      required:
        - value
        - currency
      properties:
        value:
          type: string
          example: '5.00'
        currency:
          type: string
          example: USD
  securitySchemes:
    clientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /token
          x-speakeasy-token-endpoint-authentication: client_secret_basic
          scopes: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.