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

# Update Pulse

> Update the pulse settings for an account. Use this to enable or disable the pulse. Returns an array of pulses for consistency with the GET endpoint.



## OpenAPI

````yaml api-reference/openapi/accounts.json PATCH /api/pulses
openapi: 3.1.0
info:
  title: Recoup API - Accounts
  description: >-
    API documentation for the Recoup platform - an AI agent platform for the
    music industry
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.recoupable.dev
security: []
paths:
  /api/pulses:
    patch:
      description: >-
        Update the pulse settings for an account. Use this to enable or disable
        the pulse. Returns an array of pulses for consistency with the GET
        endpoint.
      requestBody:
        description: Pulse fields to update
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePulseRequest'
      responses:
        '200':
          description: Pulse updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PulsesResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    UpdatePulseRequest:
      type: object
      required:
        - active
      properties:
        active:
          type: boolean
          description: Whether to enable or disable the pulse
          example: true
        account_id:
          type: string
          format: uuid
          description: >-
            UUID of the account to update the pulse for. Only applicable when
            the authenticated account has access to multiple accounts via
            organization membership. If not provided, updates the pulse for the
            API key's own account.
    PulsesResponse:
      type: object
      required:
        - status
        - pulses
      properties:
        status:
          type: string
          enum:
            - success
            - error
          description: Status of the request
        pulses:
          type: array
          items:
            $ref: '#/components/schemas/Pulse'
          description: >-
            Array of pulse objects. Contains pulses for the authenticated
            account. If the account has access to organizations, all
            organization accounts are included.
        error:
          type: string
          description: Error message (only present if status is error)
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
    Pulse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the pulse
        account_id:
          type: string
          format: uuid
          description: Unique identifier for the associated account
        active:
          type: boolean
          description: Whether the pulse is active (defaults to true)

````