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

# Delete symbol risk control

> Deletes risk limits for a symbol on a trading account owned by the authenticated principal's organization. The caller must have Controls Premium and organization control edit access.



## OpenAPI

````yaml /api-reference/controls.openapi.json delete /v1/controls/accounts/{account_id}/symbols/{symbol}/risk
openapi: 3.1.0
info:
  title: controls
  description: ''
  license:
    name: ''
  version: 0.1.0
servers:
  - url: https://api.anthid.com
    description: Production
security: []
tags:
  - name: Organization Controls
    description: Organization-level control configuration
  - name: Account Manual Controls
    description: Account-level manual control configuration
  - name: Account Risk Controls
    description: Account-level risk-limit control configuration
  - name: Account Time Controls
    description: Account-level time-window control configuration
  - name: Symbol Manual Controls
    description: Symbol-level manual control configuration
  - name: Symbol Risk Controls
    description: Symbol-level risk-limit control configuration
  - name: Symbol Time Controls
    description: Symbol-level time-window control configuration
  - name: Effective Controls
    description: Read combined controls after scope inheritance
  - name: Control Evaluation
    description: Effective control-state evaluation
paths:
  /v1/controls/accounts/{account_id}/symbols/{symbol}/risk:
    delete:
      tags:
        - Symbol Risk Controls
      summary: Delete symbol risk control
      description: >-
        Deletes risk limits for a symbol on a trading account owned by the
        authenticated principal's organization. The caller must have Controls
        Premium and organization control edit access.
      operationId: deleteSymbolRiskControl
      parameters:
        - name: account_id
          in: path
          description: Trading account ID
          required: true
          schema:
            type: string
            format: uuid
          example: 550e8400-e29b-41d4-a716-446655440000
        - name: symbol
          in: path
          description: Trading symbol
          required: true
          schema:
            type: string
          example: AAPL
      responses:
        '200':
          description: >-
            Symbol risk control deleted, or was already deleted. `deleted_at` is
            when it was first removed and does not move on a repeat call.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletedResponse'
              example:
                deleted: true
                deleted_at: '2026-08-12T16:20:00Z'
                resource: symbol_risk_control
        '400':
          description: Request body is invalid
          content:
            text/plain:
              schema:
                type: string
        '401':
          description: >-
            Missing or invalid authentication credentials, or the credential
            carries no active organization
          content:
            text/plain:
              schema:
                type: string
        '403':
          description: >-
            Caller lacks entitlement, edit permission, or ownership of the
            trading account. A trading account that does not exist is refused
            the same way as one owned by another organization, so a caller
            cannot confirm an id exists elsewhere
          content:
            text/plain:
              schema:
                type: string
        '404':
          description: No control of this kind has ever existed here
          content:
            text/plain:
              schema:
                type: string
        '429':
          description: Caller exceeded the request rate limit
          content:
            text/plain:
              schema:
                type: string
        '500':
          description: Unexpected server error while deleting the control
          content:
            text/plain:
              schema:
                type: string
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    DeletedResponse:
      type: object
      description: >-
        The body every successful delete returns.


        Deletes are idempotent, so a caller that retries one it is unsure landed

        gets the same 200 as the caller that deleted it. That leaves the caller

        unable to tell the two apart from the status alone, which is what

        `deleted_at` is for: it is the moment the resource was *first* deleted
        and

        does not move on a repeat call.
      required:
        - deleted
        - resource
        - deleted_at
      properties:
        deleted:
          type: boolean
          description: >-
            Always true. A caller checking one field to confirm the outcome does
            not

            have to special-case which endpoint it called.
        deleted_at:
          type: string
          format: date-time
          description: When the resource was first deleted, not when this call was made.
        id:
          type:
            - string
            - 'null'
          description: >-
            Absent for resources keyed by a natural composite key rather than a

            single identifier, which today is every control in the controls
            service.

            The path already identifies those, so nothing is lost by omitting
            it.
        resource:
          $ref: '#/components/schemas/DeletedResourceKind'
    DeletedResourceKind:
      type: string
      description: >-
        The resource a delete acted on.


        Named rather than free text so a caller can branch on it, and so the
        same

        vocabulary is available when these deletes start emitting events.
      enum:
        - trading_account
        - broker_credential
        - oauth_client
        - organization
        - user
        - organization_control
        - account_control
        - account_risk_control
        - account_time_control
        - symbol_control
        - symbol_risk_control
        - symbol_time_control
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````