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

# Remove rows from role settings: Roles with what they grant and who holds them.

> Roles with what they grant and who holds them.

is_system marks the two roles the product maintains rather than the tenant: the administrator,
which holds every permission and reaches every site, and the read-only role the product's support
team signs in with. Every other role is the tenant's own to rename, change or delete.

is_external marks the ones that make their holder somebody another company employs — the second
half of what identity.is_external() reads, and the reason granting one is not the same
kind of act as granting any of the others.

held_only_by_service_accounts is true when the role has holders and every one of them is a service
account, which is what a picker choosing whom to share with or ask for a signature leaves out.



## OpenAPI

````yaml /api-reference/openapi.json delete /role_settings
openapi: 3.0.0
info:
  description: ''
  title: >-
    The only schema PostgREST exposes. Reads are security_invoker views; writes
    are SECURITY DEFINER functions. Rebuilt wholesale on every deploy — it holds
    no data.
  version: 12.2.3
servers:
  - url: https://app.assetinfinity.ai/api
security: []
tags:
  - name: Signing in
  - name: Profile
  - name: My work
  - name: Sites and locations
  - name: Assets
  - name: Asset lifecycle
  - name: Asset components
  - name: Work lifecycle
  - name: Work order execution
  - name: Work sequencing
  - name: Maintenance
  - name: Inspections
  - name: Checklists
  - name: Verification
  - name: Self verification
  - name: Inventory
  - name: Inventory detail
  - name: Parts demand
  - name: Procurement
  - name: Vendors and contracts
  - name: Contracts
  - name: Amendments
  - name: Vendor spend forecast
  - name: Workforce
  - name: Workforce detail
  - name: Capacity
  - name: Dispatch
  - name: Shutdown
  - name: Permits
  - name: Tools
  - name: Tools on jobs
  - name: Bookings
  - name: Calibration history
  - name: Reliability
  - name: Sensors and meters
  - name: Readers
  - name: Trackers
  - name: Real-time location
  - name: Feeds
  - name: Energy
  - name: IT assets
  - name: IT asset software
  - name: IT asset topology
  - name: Map
  - name: Floor plans
  - name: Labels
  - name: Lost and found
  - name: Visitors
  - name: Root cause analysis
  - name: Costing
  - name: Finance
  - name: Budgets
  - name: Capex plans
  - name: FF&E plans
  - name: Documents
  - name: Document control
  - name: Document folders
  - name: Document tree
  - name: Knowledge
  - name: Reports
  - name: Dashboards
  - name: Extracts
  - name: Data exports
  - name: Audit center
  - name: Audit feed
  - name: Activity
  - name: Conversations
  - name: Notifications
  - name: Date reminders
  - name: Channels
  - name: Search
  - name: Copilot
  - name: Import
  - name: Bulk jobs
  - name: File exchange
  - name: Filing exceptions
  - name: Files
  - name: Sync
  - name: Support
  - name: API keys
  - name: Webhooks
  - name: MCP connections
  - name: MCP sign-in
  - name: SCIM provisioning
  - name: Directory sync
  - name: Security streams
  - name: Single sign-on
  - name: Two-factor sign-in
  - name: Admin
  - name: Access
  - name: Lookups
  - name: Read models
  - name: Reference
  - name: Reference columns
  - name: Reference entry
  - name: List views
  - name: Mapping
  - name: Numbering
  - name: Branding
  - name: Custom fields
  - name: Form studio
  - name: Workflows
  - name: Workflow studio
  - name: Rules
  - name: Statuses and transitions
  - name: Currencies and locales
  - name: Today
  - name: Work configuration
  - name: Asset configuration
  - name: Inventory configuration
  - name: Tool configuration
  - name: Workforce configuration
  - name: Vendor and contract configuration
  - name: Document configuration
  - name: Inspection configuration
  - name: Sites, locations and the organisation
  - name: Setup
  - name: Features
  - name: Billing
  - name: Licence
  - name: Welcome
  - name: Tray
  - name: Tenant switch
  - name: Release
  - name: Telegram
  - name: Inbound mail
  - name: Platform
externalDocs:
  description: PostgREST Documentation
  url: https://postgrest.org/en/v12/references/api.html
paths:
  /role_settings:
    delete:
      tags:
        - Access
      summary: >-
        Remove rows from role settings: Roles with what they grant and who holds
        them.
      description: >-
        Roles with what they grant and who holds them.


        is_system marks the two roles the product maintains rather than the
        tenant: the administrator,

        which holds every permission and reaches every site, and the read-only
        role the product's support

        team signs in with. Every other role is the tenant's own to rename,
        change or delete.


        is_external marks the ones that make their holder somebody another
        company employs — the second

        half of what identity.is_external() reads, and the reason granting one
        is not the same

        kind of act as granting any of the others.


        held_only_by_service_accounts is true when the role has holders and
        every one of them is a service

        account, which is what a picker choosing whom to share with or ask for a
        signature leaves out.
      parameters:
        - $ref: '#/components/parameters/rowFilter.role_settings.id'
        - $ref: '#/components/parameters/rowFilter.role_settings.code'
        - $ref: '#/components/parameters/rowFilter.role_settings.name'
        - $ref: '#/components/parameters/rowFilter.role_settings.description'
        - $ref: '#/components/parameters/rowFilter.role_settings.is_system'
        - $ref: '#/components/parameters/rowFilter.role_settings.is_external'
        - $ref: '#/components/parameters/rowFilter.role_settings.own_assets_only'
        - $ref: '#/components/parameters/rowFilter.role_settings.work_order_reach'
        - $ref: >-
            #/components/parameters/rowFilter.role_settings.work_order_edit_reach
        - $ref: '#/components/parameters/rowFilter.role_settings.is_active'
        - $ref: '#/components/parameters/rowFilter.role_settings.permissions'
        - $ref: '#/components/parameters/rowFilter.role_settings.users'
        - $ref: '#/components/parameters/rowFilter.role_settings.permission_codes'
        - $ref: >-
            #/components/parameters/rowFilter.role_settings.held_only_by_service_accounts
        - $ref: '#/components/parameters/rowFilter.role_settings.row_version'
        - $ref: '#/components/parameters/preferReturn'
      responses:
        '204':
          description: No Content
components:
  parameters:
    rowFilter.role_settings.id:
      in: query
      name: id
      required: false
      schema:
        type: string
    rowFilter.role_settings.code:
      in: query
      name: code
      required: false
      schema:
        type: string
    rowFilter.role_settings.name:
      in: query
      name: name
      required: false
      schema:
        type: string
    rowFilter.role_settings.description:
      in: query
      name: description
      required: false
      schema:
        type: string
    rowFilter.role_settings.is_system:
      in: query
      name: is_system
      required: false
      schema:
        type: string
    rowFilter.role_settings.is_external:
      in: query
      name: is_external
      required: false
      schema:
        type: string
    rowFilter.role_settings.own_assets_only:
      in: query
      name: own_assets_only
      required: false
      schema:
        type: string
    rowFilter.role_settings.work_order_reach:
      in: query
      name: work_order_reach
      required: false
      schema:
        type: string
    rowFilter.role_settings.work_order_edit_reach:
      in: query
      name: work_order_edit_reach
      required: false
      schema:
        type: string
    rowFilter.role_settings.is_active:
      in: query
      name: is_active
      required: false
      schema:
        type: string
    rowFilter.role_settings.permissions:
      in: query
      name: permissions
      required: false
      schema:
        type: string
    rowFilter.role_settings.users:
      in: query
      name: users
      required: false
      schema:
        type: string
    rowFilter.role_settings.permission_codes:
      in: query
      name: permission_codes
      required: false
      schema:
        type: string
    rowFilter.role_settings.held_only_by_service_accounts:
      in: query
      name: held_only_by_service_accounts
      required: false
      schema:
        type: string
    rowFilter.role_settings.row_version:
      in: query
      name: row_version
      required: false
      schema:
        type: string
    preferReturn:
      description: Preference
      in: header
      name: Prefer
      required: false
      schema:
        enum:
          - return=representation
          - return=minimal
          - return=none
        type: string

````

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