> ## 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.

# Exchange this session for one in another tenant the same person holds an account in.

> Carries nothing across but the person: the token names the other tenant's user row, and that row's
own roles and site access are what RLS answers to. Refuses anything that is not a live account in a
live tenant linked to this one, and says the same sentence for "no such organisation" as for "not
yours".

Applies the door rules of the tenant being entered rather than the one being left: an
SSO-only tenant is refused with SSO_REQUIRED, and a tenant that asks for a second factor answers
MFA_REQUIRED with a challenge api.verify_mfa finishes.



## OpenAPI

````yaml /api-reference/openapi.json get /rpc/switch_organization
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: Assets
  - name: Asset lifecycle
  - name: Work lifecycle
  - name: Maintenance
  - name: Inventory
  - name: Inventory detail
  - name: Procurement
  - name: Contracts
  - name: Workforce
  - name: Capacity
  - name: Dispatch
  - name: Tools
  - name: Inspections
  - name: Verification
  - name: Reliability
  - name: Parts demand
  - name: Sensors and meters
  - name: Map
  - name: Floor plans
  - name: Labels
  - name: Lost and found
  - name: Root cause analysis
  - name: Reports
  - name: Audit center
  - name: Activity
  - name: Notifications
  - name: Channels
  - name: Search
  - name: Copilot
  - name: Import
  - name: Files
  - name: Sync
  - name: Support
  - name: Admin
  - name: Access
  - name: Lookups
  - name: Read models
  - name: Branding
  - name: Custom fields
  - name: Form studio
  - name: Workflows
  - name: Workflow studio
  - name: Rules
  - name: Statuses and transitions
  - name: Currencies and locales
  - 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: Platform
  - name: Amendments
  - name: Asset clone
  - name: Asset components
  - name: Asset register
  - name: Asset transfer
  - name: Audit feed
  - name: Billing
  - name: Bookings
  - name: Budgets
  - name: Bulk jobs
  - name: Calibration history
  - name: Capex plans
  - name: Conversations
  - name: Costing
  - name: Currency
  - name: Dashboards
  - name: Directory sync
  - name: Document control
  - name: Document folders
  - name: Document tree
  - name: Documents
  - name: Energy
  - name: Extracts
  - name: Features
  - name: Feeds
  - name: File exchange
  - name: Filing exceptions
  - name: Finance
  - name: Inbound mail
  - name: Keys
  - name: Knowledge
  - name: Licence
  - name: List views
  - name: Locations
  - name: Mapping
  - name: Mcp
  - name: Mcp oauth
  - name: Mfa
  - name: Numbering
  - name: Permits
  - name: Readers
  - name: Reference
  - name: Reference columns
  - name: Reference entry
  - name: Release
  - name: Scim
  - name: Security streams
  - name: Self verification
  - name: Setup
  - name: Shutdown
  - name: Sso
  - name: Telegram
  - name: Tenant switch
  - name: The caller's own work
  - name: The checklist library
  - name: Tools on a job, and who has them out
  - name: Tray
  - name: Vendor spend forecast
  - name: Vendors and contracts
  - name: Visitors
  - name: Work order execution
  - name: Work sequencing
  - name: Workforce detail
externalDocs:
  description: PostgREST Documentation
  url: https://postgrest.org/en/v12/references/api.html
paths:
  /rpc/switch_organization:
    get:
      tags:
        - Tenant switch
      summary: >-
        Exchange this session for one in another tenant the same person holds an
        account in.
      description: >-
        Carries nothing across but the person: the token names the other
        tenant's user row, and that row's

        own roles and site access are what RLS answers to. Refuses anything that
        is not a live account in a

        live tenant linked to this one, and says the same sentence for "no such
        organisation" as for "not

        yours".


        Applies the door rules of the tenant being entered rather than the one
        being left: an

        SSO-only tenant is refused with SSO_REQUIRED, and a tenant that asks for
        a second factor answers

        MFA_REQUIRED with a challenge api.verify_mfa finishes.
      parameters:
        - in: query
          name: p_organization_id
          required: true
          schema:
            format: uuid
            type: string
        - in: query
          name: p_device_identifier
          required: false
          schema:
            format: text
            type: string
        - in: query
          name: p_platform
          required: false
          schema:
            format: text
            type: string
      responses:
        '200':
          description: OK

````