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

# Update action card status

> Transition action card to a new status.



## OpenAPI

````yaml /api/openapi.json patch /api/graph/v1/action-cards-v2/{card_id}/status
openapi: 3.1.0
info:
  title: Sequency Graph API
  description: >

    # Sequency Graph-Native Trading API


    Graph-native API for trading intelligence, built on FalkorDB.


    ## Features


    - **Screener**: Filter stocks using graph-native queries with relationship
    expansion

    - **Stock Detail**: Complete stock context with all relationships

    - **Confluence Scoring**: Setup quality assessment with weighted components

    - **Strategy Matching**: Find matching options strategies via graph
    traversal

    - **Market Context**: Current market-wide context for trading decisions


    ## Data Sources


    All data is sourced from the FalkorDB knowledge graph, populated by:

    - Pattern detector (Go) - Technical indicators, patterns

    - Graph sync service - Levels, volume profiles, news, day classification
  version: 1.0.0
servers: []
security: []
paths:
  /api/graph/v1/action-cards-v2/{card_id}/status:
    patch:
      tags:
        - Action Cards V2
      summary: Update action card status
      description: Transition action card to a new status.
      operationId: >-
        update_action_card_status_api_graph_v1_action_cards_v2__card_id__status_patch
      parameters:
        - name: card_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Card Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatusUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionCardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    StatusUpdate:
      properties:
        status:
          $ref: '#/components/schemas/app__models__action_card_v2__ActionCardStatus'
      type: object
      required:
        - status
      title: StatusUpdate
      description: Request body for status-only updates.
    ActionCardResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        user_id:
          type: string
          format: uuid
          title: User Id
        source:
          $ref: '#/components/schemas/ActionCardSource'
        underlying_symbol:
          type: string
          title: Underlying Symbol
        instrument_type:
          $ref: '#/components/schemas/app__models__action_card_v2__InstrumentType'
        instrument_symbol:
          type: string
          title: Instrument Symbol
        direction:
          type: string
          enum:
            - LONG
            - SHORT
          title: Direction
        timeframe:
          type: string
          enum:
            - intraday
            - swing
            - position
          title: Timeframe
        entry_price:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Entry Price
        stop_loss:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Stop Loss
        targets:
          items:
            $ref: '#/components/schemas/ActionCardTarget-Output'
          type: array
          title: Targets
        risk_reward:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Risk Reward
        source_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Id
        group_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Group Id
        group_role:
          anyOf:
            - type: string
            - type: 'null'
          title: Group Role
        contract:
          anyOf:
            - $ref: '#/components/schemas/ContractInfo-Output'
            - type: 'null'
        premium_levels:
          anyOf:
            - $ref: '#/components/schemas/PremiumLevels-Output'
            - type: 'null'
        market_context:
          anyOf:
            - $ref: '#/components/schemas/MarketContext'
            - type: 'null'
        sizing:
          anyOf:
            - $ref: '#/components/schemas/SizingInfo-Output'
            - type: 'null'
        entry_plan:
          anyOf:
            - $ref: '#/components/schemas/EntryPlanInfo-Output'
            - type: 'null'
        exit_plan:
          anyOf:
            - $ref: '#/components/schemas/ExitPlanInfo-Output'
            - type: 'null'
        risk_context:
          anyOf:
            - $ref: '#/components/schemas/RiskContext'
            - type: 'null'
        validation:
          anyOf:
            - $ref: '#/components/schemas/ValidationInfo'
            - type: 'null'
        backtest_edge:
          anyOf:
            - $ref: '#/components/schemas/BacktestEdge'
            - type: 'null'
        status:
          $ref: '#/components/schemas/app__models__action_card_v2__ActionCardStatus'
        completeness:
          $ref: >-
            #/components/schemas/app__models__action_card_v2__ActionCardCompleteness
        execution_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Execution Id
        outcome:
          anyOf:
            - $ref: '#/components/schemas/OutcomeInfo'
            - type: 'null'
        time_validity:
          anyOf:
            - type: string
            - type: 'null'
          title: Time Validity
        change_log:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Change Log
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        expires_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Expires At
      type: object
      required:
        - id
        - user_id
        - source
        - underlying_symbol
        - instrument_type
        - instrument_symbol
        - direction
        - timeframe
        - entry_price
        - stop_loss
        - targets
        - status
        - completeness
        - created_at
        - updated_at
      title: ActionCardResponse
      description: Full action card response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    app__models__action_card_v2__ActionCardStatus:
      type: string
      enum:
        - draft
        - active
        - monitoring
        - closed
        - expired
        - dismissed
      title: ActionCardStatus
      description: Action card lifecycle status.
    ActionCardSource:
      type: string
      enum:
        - manual
        - debate
        - rules
        - agent
      title: ActionCardSource
      description: How the action card was created.
    app__models__action_card_v2__InstrumentType:
      type: string
      enum:
        - equity
        - option
      title: InstrumentType
      description: Instrument type for the action card.
    ActionCardTarget-Output:
      properties:
        price:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Price
        exit_pct:
          type: integer
          maximum: 100
          minimum: 0
          title: Exit Pct
          description: Percentage of position to exit at this target
        label:
          anyOf:
            - type: string
            - type: 'null'
          title: Label
      type: object
      required:
        - price
        - exit_pct
      title: ActionCardTarget
      description: Single price target with exit allocation.
    ContractInfo-Output:
      properties:
        symbol:
          type: string
          title: Symbol
        expiration:
          type: string
          title: Expiration
        strike:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Strike
        option_type:
          type: string
          enum:
            - call
            - put
          title: Option Type
          description: call or put
        delta:
          anyOf:
            - type: number
            - type: 'null'
          title: Delta
        gamma:
          anyOf:
            - type: number
            - type: 'null'
          title: Gamma
        theta:
          anyOf:
            - type: number
            - type: 'null'
          title: Theta
        vega:
          anyOf:
            - type: number
            - type: 'null'
          title: Vega
        iv:
          anyOf:
            - type: number
            - type: 'null'
          title: Iv
        iv_percentile:
          anyOf:
            - type: number
            - type: 'null'
          title: Iv Percentile
        bid:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Bid
        ask:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Ask
        mid:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Mid
        spread_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Spread Pct
        oi:
          anyOf:
            - type: integer
            - type: 'null'
          title: Oi
        volume:
          anyOf:
            - type: integer
            - type: 'null'
          title: Volume
        dte:
          anyOf:
            - type: integer
            - type: 'null'
          title: Dte
      type: object
      required:
        - symbol
        - expiration
        - strike
        - option_type
      title: ContractInfo
      description: Options contract details.
    PremiumLevels-Output:
      properties:
        entry:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Entry
        stop:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Stop
        t1:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: T1
        t2:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: T2
        breakeven:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Breakeven
      type: object
      title: PremiumLevels
      description: Premium-based levels for options trades.
    MarketContext:
      properties:
        regime:
          anyOf:
            - $ref: '#/components/schemas/RegimeInfo'
            - type: 'null'
        day_type:
          anyOf:
            - $ref: '#/components/schemas/DayTypeInfo'
            - type: 'null'
        confluence:
          anyOf:
            - $ref: '#/components/schemas/ConfluenceInfo'
            - type: 'null'
        trend:
          anyOf:
            - $ref: '#/components/schemas/TrendInfo'
            - type: 'null'
        volume:
          anyOf:
            - $ref: '#/components/schemas/VolumeInfo'
            - type: 'null'
        institutional_levels:
          anyOf:
            - $ref: '#/components/schemas/InstitutionalLevelsInfo'
            - type: 'null'
      type: object
      title: MarketContext
      description: Combined market context for enrichment.
    SizingInfo-Output:
      properties:
        shares_or_contracts:
          type: integer
          title: Shares Or Contracts
        risk_per_unit:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Risk Per Unit
        risk_dollars:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Risk Dollars
        position_value:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Position Value
        portfolio_heat_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Portfolio Heat Pct
        day_type_modifier:
          anyOf:
            - type: number
            - type: 'null'
          title: Day Type Modifier
        vix_modifier:
          anyOf:
            - type: number
            - type: 'null'
          title: Vix Modifier
        consecutive_loss_modifier:
          anyOf:
            - type: number
            - type: 'null'
          title: Consecutive Loss Modifier
      type: object
      required:
        - shares_or_contracts
        - risk_per_unit
        - risk_dollars
      title: SizingInfo
      description: Position sizing details.
    EntryPlanInfo-Output:
      properties:
        order_type:
          type: string
          title: Order Type
        limit_price:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Limit Price
        trigger_conditions:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Trigger Conditions
        trigger_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Trigger Type
        trigger_level:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Trigger Level
        entry_zone:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Entry Zone
        scaling:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Scaling
        invalidation:
          anyOf:
            - type: string
            - type: 'null'
          title: Invalidation
        time_window:
          anyOf:
            - type: string
            - type: 'null'
          title: Time Window
      type: object
      required:
        - order_type
      title: EntryPlanInfo
      description: Entry execution plan.
    ExitPlanInfo-Output:
      properties:
        stop_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Stop Type
        trail_offset:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Trail Offset
        time_stop:
          anyOf:
            - type: string
            - type: 'null'
          title: Time Stop
        partial_targets:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Partial Targets
        stop_management:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Stop Management
        time_stops:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Time Stops
        invalidations:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Invalidations
      type: object
      title: ExitPlanInfo
      description: Exit execution plan.
    RiskContext:
      properties:
        portfolio_heat_before:
          anyOf:
            - type: number
            - type: 'null'
          title: Portfolio Heat Before
        portfolio_heat_after:
          anyOf:
            - type: number
            - type: 'null'
          title: Portfolio Heat After
        correlated_positions:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Correlated Positions
        max_daily_loss_used:
          anyOf:
            - type: number
            - type: 'null'
          title: Max Daily Loss Used
        gates_passed:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Gates Passed
        gates_failed:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Gates Failed
        daily_pnl_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Daily Pnl Pct
        weekly_pnl_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Weekly Pnl Pct
        open_positions:
          anyOf:
            - type: integer
            - type: 'null'
          title: Open Positions
        available_slots:
          anyOf:
            - type: integer
            - type: 'null'
          title: Available Slots
        cleared_to_trade:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Cleared To Trade
      type: object
      title: RiskContext
      description: Risk guardian context at card creation.
    ValidationInfo:
      properties:
        confidence:
          anyOf:
            - type: integer
            - type: 'null'
          title: Confidence
        key_risk:
          anyOf:
            - type: string
            - type: 'null'
          title: Key Risk
        debate_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Debate Id
        thesis_alignment:
          anyOf:
            - type: string
            - type: 'null'
          title: Thesis Alignment
        edge_quality:
          anyOf:
            - type: string
            - type: 'null'
          title: Edge Quality
        deciding_factors:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Deciding Factors
        agent_session_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Agent Session Id
        reasoning:
          anyOf:
            - type: string
            - type: 'null'
          title: Reasoning
        pop:
          anyOf:
            - type: number
            - type: 'null'
          title: Pop
        pop_source:
          anyOf:
            - type: string
            - type: 'null'
          title: Pop Source
        pop_sample_size:
          anyOf:
            - type: integer
            - type: 'null'
          title: Pop Sample Size
        rationale:
          anyOf:
            - type: string
            - type: 'null'
          title: Rationale
      type: object
      title: ValidationInfo
      description: Validation context from debate or analysis.
    BacktestEdge:
      properties:
        total_trades:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Trades
        win_rate:
          anyOf:
            - type: number
            - type: 'null'
          title: Win Rate
        avg_r:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg R
        profit_factor:
          anyOf:
            - type: number
            - type: 'null'
          title: Profit Factor
        edge_quality:
          anyOf:
            - type: string
            - type: 'null'
          title: Edge Quality
        similar_setups:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Similar Setups
      type: object
      title: BacktestEdge
      description: Historical backtest edge data.
    app__models__action_card_v2__ActionCardCompleteness:
      type: string
      enum:
        - skeleton
        - enriched
        - actionable
        - validated
      title: ActionCardCompleteness
      description: Completeness tier based on enrichment sections present.
    OutcomeInfo:
      properties:
        pnl_dollars:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Pnl Dollars
        pnl_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Pnl Pct
        r_multiple:
          anyOf:
            - type: number
            - type: 'null'
          title: R Multiple
        exit_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Exit Reason
        hold_days:
          anyOf:
            - type: integer
            - type: 'null'
          title: Hold Days
        filled_price:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Filled Price
        closed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Closed At
      type: object
      title: OutcomeInfo
      description: Post-trade outcome tracking.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    RegimeInfo:
      properties:
        classification:
          type: string
          title: Classification
        confidence:
          anyOf:
            - type: number
            - type: 'null'
          title: Confidence
        vix:
          anyOf:
            - type: number
            - type: 'null'
          title: Vix
        vix_context:
          anyOf:
            - type: string
            - type: 'null'
          title: Vix Context
      type: object
      required:
        - classification
      title: RegimeInfo
      description: Market regime context.
    DayTypeInfo:
      properties:
        classification:
          type: string
          title: Classification
        confidence:
          anyOf:
            - type: integer
            - type: 'null'
          title: Confidence
        size_modifier:
          anyOf:
            - type: number
            - type: 'null'
          title: Size Modifier
      type: object
      required:
        - classification
      title: DayTypeInfo
      description: Day type classification context.
    ConfluenceInfo:
      properties:
        bull:
          anyOf:
            - type: integer
            - type: 'null'
          title: Bull
        bear:
          anyOf:
            - type: integer
            - type: 'null'
          title: Bear
        net:
          anyOf:
            - type: integer
            - type: 'null'
          title: Net
        tier:
          anyOf:
            - type: string
            - type: 'null'
          title: Tier
        bias:
          anyOf:
            - type: string
            - type: 'null'
          title: Bias
      type: object
      title: ConfluenceInfo
      description: Confluence scoring summary.
    TrendInfo:
      properties:
        price:
          anyOf:
            - type: number
            - type: 'null'
          title: Price
        ema20:
          anyOf:
            - type: number
            - type: 'null'
          title: Ema20
        sma50:
          anyOf:
            - type: number
            - type: 'null'
          title: Sma50
        sma200:
          anyOf:
            - type: number
            - type: 'null'
          title: Sma200
        stack_valid:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Stack Valid
      type: object
      title: TrendInfo
      description: Trend and moving average context.
    VolumeInfo:
      properties:
        rvol:
          anyOf:
            - type: number
            - type: 'null'
          title: Rvol
        trend:
          anyOf:
            - type: string
            - type: 'null'
          title: Trend
        breakout_node:
          anyOf:
            - type: string
            - type: 'null'
          title: Breakout Node
      type: object
      title: VolumeInfo
      description: Volume context.
    InstitutionalLevelsInfo:
      properties:
        vwap:
          anyOf:
            - type: number
            - type: 'null'
          title: Vwap
        ib_high:
          anyOf:
            - type: number
            - type: 'null'
          title: Ib High
        ib_low:
          anyOf:
            - type: number
            - type: 'null'
          title: Ib Low
        poc:
          anyOf:
            - type: number
            - type: 'null'
          title: Poc
        vah:
          anyOf:
            - type: number
            - type: 'null'
          title: Vah
        val:
          anyOf:
            - type: number
            - type: 'null'
          title: Val
        pivots:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Pivots
      type: object
      title: InstitutionalLevelsInfo
      description: Key institutional price levels.

````