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

# Delete a position filter.

> Permanently removes a custom position-filter definition owned by the caller and removes its access grants.
This is a hard deletion, not an inactive transition, and completes before returning. Before deleting, callers
should ensure that the filter is not used elsewhere because deletion can leave those references without it.



## OpenAPI

````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json post /api/PositionFilter/Delete
openapi: 3.0.4
info:
  title: Derivitec Api 1.0
  version: '1.0'
servers:
  - url: https://api.riskportal.activeviam.com
security:
  - oauth2: []
  - apikey: []
tags:
  - name: AdminUser
  - name: AtotiReport
  - name: AtotiSession
  - name: BloombergOAuth
  - name: Bond
  - name: BondYieldCurvePage
  - name: BookAccess
  - name: Books
  - name: Commodity
  - name: Counterparties
  - name: Currencies
  - name: Equity
  - name: EquityDividend
  - name: EquityPage
  - name: FeatureFlag
  - name: Fx
  - name: FxPage
  - name: GroupAccess
  - name: Home
  - name: LegacyPosition
  - name: MarketData
  - name: MarketDataProvider
  - name: MarketDataProviderAccess
  - name: Meta
  - name: Notification
  - name: Organisation
  - name: PnLReport
  - name: PortfolioAccess
  - name: Portfolios
  - name: Position
  - name: PositionFilter
  - name: PricingEnvironment
  - name: PricingEnvironmentAccess
  - name: RateAsset
  - name: RateAssetPage
  - name: Report
  - name: ReportDefinition
  - name: ReportHistoryLauncherQuery
  - name: ReportLauncher
  - name: ReportQuery
  - name: ReportQueryViewUser
  - name: ReportRestriction
  - name: ReportView
  - name: RiskReport
  - name: Tradable
  - name: TradeBooking
  - name: User
  - name: VarReport
  - name: VarReportQuery
  - name: YieldCurvePage
paths:
  /api/PositionFilter/Delete:
    post:
      tags:
        - PositionFilter
      summary: Delete a position filter.
      description: >-
        Permanently removes a custom position-filter definition owned by the
        caller and removes its access grants.

        This is a hard deletion, not an inactive transition, and completes
        before returning. Before deleting, callers

        should ensure that the filter is not used elsewhere because deletion can
        leave those references without it.
      operationId: Delete
      requestBody:
        description: >-
          Required non-blank `EntityId` in the Risk Portal position-filter
          identifier namespace.
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/ApiPositionFilterDeleteRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/ApiPositionFilterDeleteRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/ApiPositionFilterDeleteRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ApiPositionFilterDeleteRequest'
      responses:
        '200':
          description: >-
            Returns deletion success, or missing identifier and non-owner or
            unavailable-filter errors in the response envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiPositionFilterDeleteResponse'
        '400':
          description: BadRequest
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
        - oauth2: []
        - apikey: []
components:
  schemas:
    ApiPositionFilterDeleteRequest:
      required:
        - $type
      type: object
      additionalProperties: false
      description: Selection of an owned custom position filter to delete.
      properties:
        name:
          type: string
          description: >-
            Name of the entity to select within the request's entity category.
            The value must not be null or empty.
          nullable: true
          example: Example entity
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.PositionFilters.ApiPositionFilterDeleteRequest,
              Derivitec.Web.Core
    ApiPositionFilterDeleteResponse:
      required:
        - $type
      type: object
      additionalProperties: false
      description: >-
        Success state and errors returned after attempting to delete a custom
        position filter.
      properties:
        is_success:
          type: boolean
          description: >-
            Whether the operation completed successfully. The default is `true`;
            error outcomes set it to `false`.
          example: true
        error_messages:
          type: array
          items:
            type: string
          description: >-
            Messages explaining operation-level failures. The collection is
            empty by default.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.PositionFilters.ApiPositionFilterDeleteResponse,
              Derivitec.Web.Core
  securitySchemes:
    oauth2:
      type: oauth2
      description: >-
        OAuth2 access-token requested from AWS Cognito and provided as a Auth
        Bearer header
      flows:
        implicit:
          authorizationUrl: https://auth.riskportal.derivitec.com/oauth2/authorize
          scopes: {}
    apikey:
      type: apiKey
      description: API-Key requested via the site and provided as a header
      name: x-api-key
      in: header

````