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

# Move an asset, hand it to a new custodian, restate its department and change its status in one

> act, and record that it happened.

The three verbs it calls keep every refusal they have; what this adds is the order the state
model's `requires_custodian` demands, one approval rather than three, and the transfer row a
handover or a gate pass is printed from.

Who holds the asset afterwards is that same flag's answer. A status marked "Requires custodian" is
one this asks who; any other is a status nobody holds an asset in, so a transfer into one releases
whoever holds it — unless the call names somebody, which is always obeyed.



## OpenAPI

````yaml /api-reference/openapi.json post /rpc/transfer_asset
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/transfer_asset:
    post:
      tags:
        - Asset transfer
      summary: >-
        Move an asset, hand it to a new custodian, restate its department and
        change its status in one
      description: >-
        act, and record that it happened.


        The three verbs it calls keep every refusal they have; what this adds is
        the order the state

        model's `requires_custodian` demands, one approval rather than three,
        and the transfer row a

        handover or a gate pass is printed from.


        Who holds the asset afterwards is that same flag's answer. A status
        marked "Requires custodian" is

        one this asks who; any other is a status nobody holds an asset in, so a
        transfer into one releases

        whoever holds it — unless the call names somebody, which is always
        obeyed.
      parameters:
        - $ref: '#/components/parameters/preferParams'
      requestBody:
        content:
          application/json:
            schema:
              description: >-
                Move an asset, hand it to a new custodian, restate its
                department and change its status in one

                act, and record that it happened.


                The three verbs it calls keep every refusal they have; what this
                adds is the order the state

                model's `requires_custodian` demands, one approval rather than
                three, and the transfer row a

                handover or a gate pass is printed from.


                Who holds the asset afterwards is that same flag's answer. A
                status marked "Requires custodian" is

                one this asks who; any other is a status nobody holds an asset
                in, so a transfer into one releases

                whoever holds it — unless the call names somebody, which is
                always obeyed.
              properties:
                p_asset_id:
                  format: uuid
                  type: string
                p_authorised_by_user_id:
                  format: uuid
                  type: string
                p_batch_id:
                  format: uuid
                  type: string
                p_custom_fields:
                  format: jsonb
                p_department_id:
                  format: uuid
                  type: string
                p_notes:
                  format: text
                  type: string
                p_reason:
                  format: text
                  type: string
                p_to_custodian_name:
                  format: text
                  type: string
                p_to_custodian_user_id:
                  format: uuid
                  type: string
                p_to_custody_until:
                  format: date
                  type: string
                p_to_location_id:
                  format: uuid
                  type: string
                p_to_site_id:
                  format: uuid
                  type: string
                p_to_status_code:
                  format: text
                  type: string
                p_transferred_at:
                  format: timestamp with time zone
                  type: string
              required:
                - p_asset_id
              type: object
          application/vnd.pgrst.object+json:
            schema:
              description: >-
                Move an asset, hand it to a new custodian, restate its
                department and change its status in one

                act, and record that it happened.


                The three verbs it calls keep every refusal they have; what this
                adds is the order the state

                model's `requires_custodian` demands, one approval rather than
                three, and the transfer row a

                handover or a gate pass is printed from.


                Who holds the asset afterwards is that same flag's answer. A
                status marked "Requires custodian" is

                one this asks who; any other is a status nobody holds an asset
                in, so a transfer into one releases

                whoever holds it — unless the call names somebody, which is
                always obeyed.
              properties:
                p_asset_id:
                  format: uuid
                  type: string
                p_authorised_by_user_id:
                  format: uuid
                  type: string
                p_batch_id:
                  format: uuid
                  type: string
                p_custom_fields:
                  format: jsonb
                p_department_id:
                  format: uuid
                  type: string
                p_notes:
                  format: text
                  type: string
                p_reason:
                  format: text
                  type: string
                p_to_custodian_name:
                  format: text
                  type: string
                p_to_custodian_user_id:
                  format: uuid
                  type: string
                p_to_custody_until:
                  format: date
                  type: string
                p_to_location_id:
                  format: uuid
                  type: string
                p_to_site_id:
                  format: uuid
                  type: string
                p_to_status_code:
                  format: text
                  type: string
                p_transferred_at:
                  format: timestamp with time zone
                  type: string
              required:
                - p_asset_id
              type: object
          application/vnd.pgrst.object+json;nulls=stripped:
            schema:
              description: >-
                Move an asset, hand it to a new custodian, restate its
                department and change its status in one

                act, and record that it happened.


                The three verbs it calls keep every refusal they have; what this
                adds is the order the state

                model's `requires_custodian` demands, one approval rather than
                three, and the transfer row a

                handover or a gate pass is printed from.


                Who holds the asset afterwards is that same flag's answer. A
                status marked "Requires custodian" is

                one this asks who; any other is a status nobody holds an asset
                in, so a transfer into one releases

                whoever holds it — unless the call names somebody, which is
                always obeyed.
              properties:
                p_asset_id:
                  format: uuid
                  type: string
                p_authorised_by_user_id:
                  format: uuid
                  type: string
                p_batch_id:
                  format: uuid
                  type: string
                p_custom_fields:
                  format: jsonb
                p_department_id:
                  format: uuid
                  type: string
                p_notes:
                  format: text
                  type: string
                p_reason:
                  format: text
                  type: string
                p_to_custodian_name:
                  format: text
                  type: string
                p_to_custodian_user_id:
                  format: uuid
                  type: string
                p_to_custody_until:
                  format: date
                  type: string
                p_to_location_id:
                  format: uuid
                  type: string
                p_to_site_id:
                  format: uuid
                  type: string
                p_to_status_code:
                  format: text
                  type: string
                p_transferred_at:
                  format: timestamp with time zone
                  type: string
              required:
                - p_asset_id
              type: object
          text/csv:
            schema:
              description: >-
                Move an asset, hand it to a new custodian, restate its
                department and change its status in one

                act, and record that it happened.


                The three verbs it calls keep every refusal they have; what this
                adds is the order the state

                model's `requires_custodian` demands, one approval rather than
                three, and the transfer row a

                handover or a gate pass is printed from.


                Who holds the asset afterwards is that same flag's answer. A
                status marked "Requires custodian" is

                one this asks who; any other is a status nobody holds an asset
                in, so a transfer into one releases

                whoever holds it — unless the call names somebody, which is
                always obeyed.
              properties:
                p_asset_id:
                  format: uuid
                  type: string
                p_authorised_by_user_id:
                  format: uuid
                  type: string
                p_batch_id:
                  format: uuid
                  type: string
                p_custom_fields:
                  format: jsonb
                p_department_id:
                  format: uuid
                  type: string
                p_notes:
                  format: text
                  type: string
                p_reason:
                  format: text
                  type: string
                p_to_custodian_name:
                  format: text
                  type: string
                p_to_custodian_user_id:
                  format: uuid
                  type: string
                p_to_custody_until:
                  format: date
                  type: string
                p_to_location_id:
                  format: uuid
                  type: string
                p_to_site_id:
                  format: uuid
                  type: string
                p_to_status_code:
                  format: text
                  type: string
                p_transferred_at:
                  format: timestamp with time zone
                  type: string
              required:
                - p_asset_id
              type: object
        required: true
      responses:
        '200':
          description: OK
components:
  parameters:
    preferParams:
      description: Preference
      in: header
      name: Prefer
      required: false
      schema:
        enum:
          - params=single-object
        type: string

````