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

# Re-arm a price alert

> Arms a triggered or disabled alert again at its stored price. The direction is chosen again from the current mark, so an alert that fired upward waits for the next cross in whichever direction now reaches its price. Counts toward the 25 armed alerts.



## OpenAPI

````yaml /openapi.yaml post /v1/price-alerts/{alert_id}/rearm
openapi: 3.1.0
info:
  title: MyFundedPerps API (Beta)
  version: 1.0.0
  description: >-
    The developer API is in beta. Breaking changes may be introduced at any
    time. Programmatic access to MyFundedPerps paper-trading challenge accounts.
    API trades use the same real order books and simulated execution engine as
    the web trading interface. Every response carries an `X-Request-Id` header
    for support and log correlation.
  contact:
    url: https://myfundedperpetuals.com/contact
servers:
  - url: https://developers.myfundedperpetuals.com
    description: Live
  - url: https://sandbox.myfundedperpetuals.com
    description: Sandbox (test keys and sandbox accounts only)
security:
  - bearerAuth: []
  - bearerAuth: []
    partnerKey: []
tags:
  - name: General
  - name: Authentication
  - name: Accounts
  - name: Markets
  - name: Positions
  - name: Orders
  - name: Fills
  - name: Strategy Orders
  - name: Price Alerts
paths:
  /v1/price-alerts/{alert_id}/rearm:
    post:
      tags:
        - Price Alerts
      summary: Re-arm a price alert
      description: >-
        Arms a triggered or disabled alert again at its stored price. The
        direction is chosen again from the current mark, so an alert that fired
        upward waits for the next cross in whichever direction now reaches its
        price. Counts toward the 25 armed alerts.
      operationId: rearmPriceAlert
      parameters:
        - $ref: '#/components/parameters/PriceAlertId'
      responses:
        '200':
          description: Re-armed price alert.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PriceAlertEnvelope'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/PriceAlertRejected'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          $ref: '#/components/responses/PriceUnavailable'
components:
  parameters:
    PriceAlertId:
      name: alert_id
      in: path
      required: true
      schema:
        type: string
  schemas:
    PriceAlertEnvelope:
      type: object
      required:
        - data
      properties:
        data:
          $ref: '#/components/schemas/PriceAlert'
    PriceAlert:
      type: object
      required:
        - id
        - market_id
        - provider
        - symbol
        - coin
        - price
        - condition
        - status
        - price_source
        - current_price_at_creation
        - created_at
        - updated_at
      properties:
        id:
          type: string
        market_id:
          type: string
          example: binance|BTCUSDT
        provider:
          type: string
        symbol:
          type: string
        coin:
          type: string
        price:
          type: number
          description: Level the mark must reach.
        condition:
          type: string
          enum:
            - above
            - below
          description: >-
            `above` fires when the mark rises to `price`; `below` when it falls
            to it. Chosen from the mark when the alert was armed.
        status:
          type: string
          enum:
            - active
            - triggered
            - disabled
          description: >-
            `active` alerts are armed. `triggered` alerts fired and stay listed
            for 90 days. `disabled` alerts are not watched until re-armed.
        note:
          type: string
          maxLength: 80
        price_source:
          type: string
          enum:
            - mark
        current_price_at_creation:
          type: number
        trigger_price:
          type: number
          description: Mark observed when the alert fired.
        triggered_at:
          type: integer
          description: Unix time in milliseconds.
        created_at:
          type: integer
          description: Unix time in milliseconds.
        updated_at:
          type: integer
          description: Unix time in milliseconds.
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/Error'
    Error:
      type: object
      required:
        - code
        - message
        - request_id
      properties:
        code:
          type: string
        message:
          type: string
        request_id:
          type: string
          format: uuid
        details:
          type: array
          description: >-
            Present on request-validation failures, with one entry per invalid
            field so a request can be fixed in one pass.
          items:
            $ref: '#/components/schemas/ValidationIssue'
    ValidationIssue:
      type: object
      required:
        - field
        - issue
      properties:
        field:
          type: string
          description: >-
            Wire name of the offending request field, such as `size` or
            `operations[2].price`. The value `body` refers to the whole payload.
        issue:
          type: string
  responses:
    Unauthorized:
      description: Missing, invalid, or revoked API key, or an invalid partner key.
      headers:
        WWW-Authenticate:
          schema:
            type: string
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    NotFound:
      description: Resource not found or not owned by the authenticated user.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    PriceAlertRejected:
      description: >-
        The alert cannot be armed or changed: the market does not offer alerts,
        the armed-alert limit is reached, the price has too many decimal places,
        the note is too long, or the alert is not in a state that allows the
        operation. `error.message` names the reason.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    RateLimited:
      description: >-
        The per-IP request limit, a partner budget, or an account-wide operation
        budget is exhausted.
      headers:
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
        X-RateLimit-Limit:
          $ref: '#/components/headers/RateLimitLimit'
        X-RateLimit-Scope:
          $ref: '#/components/headers/RateLimitScope'
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    PriceUnavailable:
      description: The market's current price is temporarily unavailable. Retry shortly.
      headers:
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  headers:
    RequestId:
      description: Stable identifier for support and log correlation.
      schema:
        type: string
        format: uuid
    RetryAfter:
      description: Seconds to wait before retrying.
      schema:
        type: integer
        minimum: 1
    RateLimitLimit:
      description: >-
        Requests per minute allowed by the request budget that ran out. Sent on
        request-budget 429s; account-wide operation budget 429s omit it.
      schema:
        type: integer
        minimum: 1
    RateLimitScope:
      description: >-
        Which request budget ran out: `ip` for the per-address limit, `api_key`
        for a partner's per-trader-key budget, or `partner` for a partner's
        combined budget. Sent on request-budget 429s; account-wide operation
        budget 429s omit it.
      schema:
        type: string
        enum:
          - ip
          - api_key
          - partner
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: MyFundedPerps API key
      description: >-
        API key beginning with `fp_live_` (live keys, served at
        developers.myfundedperpetuals.com) or `fp_test_` (test keys, served at
        sandbox.myfundedperpetuals.com). A key presented on the other host is
        rejected with `401` and a message naming the correct host.
    partnerKey:
      type: apiKey
      in: header
      name: X-MFP-Partner-Key
      description: >-
        Optional partner key beginning with `mfp_partner_`, issued by
        MyFundedPerps to platforms that call the live API on behalf of many
        traders. Send it beside the trader's own `fp_live_` key: the request is
        then counted against the partner's budgets instead of the per-address
        limit. It grants no access on its own. An unknown, malformed, or revoked
        partner key returns `401` with code `invalid_partner_key`. The header is
        ignored on the sandbox host and on requests without a live trader key.

````

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