Immuta Asset API

APIs for managing assets

Operations 9

GET /api/asset/byMetadata Get asset by metadata #
GET /api/asset/{id} Get asset by ID #
PUT /api/asset/{id} Update asset by ID #
PATCH /api/asset/{id} Partially update asset by ID #
GET /api/asset/{id}/request-forms Get request forms for an asset #
GET /api/asset/{id}/review-flows Get review flows for an asset #
POST /api/asset/{id}/request Request access or masking exception for an asset #
DELETE /api/asset/{id}/request/{requestId} Revoke access to an asset #
GET /api/asset/{id}/recent-determinations Returns 5 most recent manual access determinations #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/immuta-asset-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

immuta-asset-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Immuta Data Marketplace Asset API
  description: This is the API for the Immuta Data Marketplace based on the OpenAPI 3.0 specification. The API supports the discovery and management of data products as well as access to those products including both the request and approval process.
  version: '1.0'
  contact:
    name: Support
    url: https://support.immuta.com
    email: support@immuta.com
  termsOfService: https://www.immuta.com/terms-of-service
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://{global-segment}.api.immutacloud.com/marketplace
  description: Marketplace API Endpoint
  variables:
    global-segment:
      default: na
      enum:
      - na
      - eu
      - ap
      description: Marketplace API global segment
tags:
- name: Asset
  description: APIs for managing assets
paths:
  /api/asset/byMetadata:
    get:
      description: Search for assets by their metadata.
      operationId: getAssetByMetadata
      parameters:
      - description: Dot-delimited fully qualified name of the asset.
        required: true
        name: fullyQualifiedName
        in: query
        schema:
          type: string
      - description: Asset type to help narrow down the search if there are multiple assets with the same fullyQualifiedName.
        required: false
        name: assetType
        in: query
        schema:
          type: string
      - description: Hostname or IP address of the asset.
        required: false
        name: host
        in: query
        schema:
          type: string
      - description: Port to narrow connection matching.
        required: false
        name: port
        in: query
        schema:
          minimum: 1
          maximum: 65535
          type: integer
      - description: Technology of the asset.
        required: false
        name: technology
        in: query
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetDto'
      security:
      - bearer: []
      summary: Get asset by metadata
      tags:
      - Asset
  /api/asset/{id}:
    get:
      description: Search assets by ID.
      operationId: getAssetById
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetDto'
      security:
      - bearer: []
      summary: Get asset by ID
      tags:
      - Asset
    put:
      description: Update an existing asset by ID
      operationId: updateAsset
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAssetDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetDto'
      security:
      - bearer: []
      summary: Update asset by ID
      tags:
      - Asset
    patch:
      description: Partially update an existing asset by ID. Only provided fields will be updated. Use null to clear request forms or review flows.
      operationId: patchAsset
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchAssetDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetDto'
      security:
      - bearer: []
      summary: Partially update asset by ID
      tags:
      - Asset
  /api/asset/{id}/request-forms:
    get:
      description: Get the request forms assigned to the asset.
      operationId: getAssetRequestForms
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetRequestForms'
      security:
      - bearer: []
      summary: Get request forms for an asset
      tags:
      - Asset
  /api/asset/{id}/review-flows:
    get:
      description: Get the review flows configured for the asset.
      operationId: getAssetReviewFlows
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetReviewFlows'
      security:
      - bearer: []
      summary: Get review flows for an asset
      tags:
      - Asset
  /api/asset/{id}/request:
    post:
      description: Create a new access or masking exception request for the specified asset.
      operationId: requestAsset
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAssetRequestDto'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HydratedAccessRequest'
      security:
      - bearer: []
      summary: Request access or masking exception for an asset
      tags:
      - Asset
  /api/asset/{id}/request/{requestId}:
    delete:
      description: Updates the specified access request to revoked and revokes access to data source(s) associated with the asset.
      operationId: revokeAssetRequest
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: requestId
        required: true
        in: path
        schema:
          type: string
      responses:
        '204':
          description: ''
      security:
      - bearer: []
      summary: Revoke access to an asset
      tags:
      - Asset
  /api/asset/{id}/recent-determinations:
    get:
      description: Returns 5 most recent data access requests with a terminal status as well as the approval records which contributed to that status.
      operationId: RecentAssetDeterminations
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: type
        required: false
        in: query
        schema:
          default: DATA_ACCESS
          type: string
          enum:
          - DATA_ACCESS
          - MASKING_EXCEPTION
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecentDeterminations'
      security:
      - bearer: []
      summary: Returns 5 most recent manual access determinations
      tags:
      - Asset
components:
  schemas:
    AssetRequestForms:
      type: object
      properties:
        dataAccessForm:
          type: object
          properties:
            id:
              type: string
              format: uuid
            name:
              type: string
            fields:
              type: array
              items:
                discriminator:
                  propertyName: type
                oneOf:
                - type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                    type:
                      type: string
                      enum:
                      - DROPDOWN
                      - CHECKBOXES
                    label:
                      type: string
                    required:
                      default: true
                      type: boolean
                    options:
                      type: array
                      items:
                        type: object
                        properties:
                          value:
                            type: string
                        required:
                        - value
                  required:
                  - id
                  - type
                  - label
                  - options
                  title: Selection Form Field
                - type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                    type:
                      type: string
                      enum:
                      - SHORT_ANSWER
                    label:
                      type: string
                    required:
                      default: true
                      type: boolean
                  required:
                  - id
                  - type
                  - label
                  title: Short Answer Form Field
                - type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                    type:
                      type: string
                      enum:
                      - ACCESS_DURATION
                    label:
                      type: string
                      enum:
                      - How long do you need access to this data?
                    required:
                      type: boolean
                      enum:
                      - true
                  required:
                  - id
                  - type
                  - label
                  - required
                  title: Access Duration Form Field
              title: RequestFormFields
            policy:
              type: object
              properties:
                version:
                  type: string
                  description: Policy schema version
                rules:
                  type: array
                  items:
                    type: object
                    properties:
                      conditions:
                        oneOf:
                        - type: object
                          properties:
                            all:
                              type: array
                              items: {}
                          required:
                          - all
                          additionalProperties: false
                        - type: object
                          properties:
                            any:
                              type: array
                              items: {}
                          required:
                          - any
                          additionalProperties: false
                        - type: object
                          properties:
                            not: {}
                          required:
                          - not
                          additionalProperties: false
                      event:
                        discriminator:
                          propertyName: type
                        oneOf:
                        - type: object
                          properties:
                            type:
                              type: string
                              enum:
                              - approve
                            params:
                              type: object
                              properties:
                                comment:
                                  type: string
                                duration:
                                  type: number
                                  minimum: 1
                                durationUnit:
                                  type: string
                                  enum:
                                  - HOURS
                                  - DAYS
                                  - WEEKS
                                  - MONTHS
                                  - YEARS
                              additionalProperties: false
                          required:
                          - type
                          - params
                        - type: object
                          properties:
                            type:
                              type: string
                              enum:
                              - deny
                            params:
                              type: object
                              properties:
                                comment:
                                  type: string
                          required:
                          - type
                          - params
                        - type: object
                          properties:
                            type:
                              type: string
                              enum:
                              - review
                            params:
                              type: object
                              properties:
                                stages:
                                  type: array
                                  items:
                                    oneOf:
                                    - type: object
                                      properties:
                                        all:
                                          type: array
                                          items:
                                            oneOf:
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - USER
                                                  description: Entity type
                                                id:
                                                  type: string
                                                  description: Entity ID
                                                displayName:
                                                  type: string
                                                  description: Entity display name
                                              required:
                                              - type
                                              - id
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - GROUP
                                                  description: Entity type
                                                id:
                                                  type: number
                                                  description: Entity ID
                                                iamId:
                                                  type: string
                                                  description: IAM ID
                                                name:
                                                  type: string
                                                  description: Entity display name
                                              required:
                                              - type
                                              - name
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - PERMISSION
                                                permission:
                                                  type: string
                                                  enum:
                                                  - GOVERNANCE
                                                  - USER_ADMIN
                                                  - AUDIT
                                                  description: Global permission
                                              required:
                                              - type
                                              - permission
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - DOMAIN PERMISSION
                                                permission:
                                                  type: string
                                                  enum:
                                                  - Manage Policies
                                                  - Audit Activity
                                                  - Manage Data Products
                                                  - Manage Identifiers
                                                  description: Domain permission
                                                domainId:
                                                  type: string
                                                  description: Domain ID
                                              required:
                                              - type
                                              - permission
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - ATTRIBUTE
                                                key:
                                                  type: string
                                                  description: Attribute key
                                                value:
                                                  type: string
                                                  description: Attribute value
                                              required:
                                              - type
                                              - key
                                              - value
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - CATALOG PERMISSION
                                              required:
                                              - type
                                          minItems: 1
                                      required:
                                      - all
                                    - type: object
                                      properties:
                                        any:
                                          type: array
                                          items:
                                            oneOf:
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - USER
                                                  description: Entity type
                                                id:
                                                  type: string
                                                  description: Entity ID
                                                displayName:
                                                  type: string
                                                  description: Entity display name
                                              required:
                                              - type
                                              - id
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - GROUP
                                                  description: Entity type
                                                id:
                                                  type: number
                                                  description: Entity ID
                                                iamId:
                                                  type: string
                                                  description: IAM ID
                                                name:
                                                  type: string
                                                  description: Entity display name
                                              required:
                                              - type
                                              - name
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - PERMISSION
                                                permission:
                                                  type: string
                                                  enum:
                                                  - GOVERNANCE
                                                  - USER_ADMIN
                                                  - AUDIT
                                                  description: Global permission
                                              required:
                                              - type
                                              - permission
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - DOMAIN PERMISSION
                                                permission:
                                                  type: string
                                                  enum:
                                                  - Manage Policies
                                                  - Audit Activity
                                                  - Manage Data Products
                                                  - Manage Identifiers
                                                  description: Domain permission
                                                domainId:
                                                  type: string
                                                  description: Domain ID
                                              required:
                                              - type
                                              - permission
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - ATTRIBUTE
                                                key:
                                                  type: string
                                                  description: Attribute key
                                                value:
                                                  type: string
                                                  description: Attribute value
                                              required:
                                              - type
                                              - key
                                              - value
                                            - type: object
                                              properties:
                                                type:
                                                  type: string
                                                  enum:
                                                  - CATALOG PERMISSION
                                              required:
                                              - type
                                          minItems: 1
                                      required:
                                      - any
                                  description: Array of stages for manual review
                              required:
                              - stages
                          required:
                          - type
                          - params
                        - type: object
                          properties:
                            type:
                              type: string
                              enum:
                              - dataProductPolicy
                          required:
                          - type
                    required:
                    - conditions
                    - event
                defaultEvent:
                  discriminator:
                    propertyName: type
                  oneOf:
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                        - approve
                      params:
                        type: object
                        properties:
                          comment:
                            type: string
                          duration:
                            type: number
                            minimum: 1
                          durationUnit:
                            type: string
                            enum:
                            - HOURS
                            - DAYS
                            - WEEKS
                            - MONTHS
                            - YEARS
                        additionalProperties: false
                    required:
                    - type
                    - params
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                        - deny
                      params:
                        type: object
                        properties:
                          comment:
                            type: string
                    required:
                    - type
                    - params
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                        - review
                      params:
                        type: object
                        properties:
                          stages:
                            type: array
                            items:
                              oneOf:
                              - type: object
                                properties:
                                  all:
                                    type: array
                                    items:
                                      oneOf:
                                      - type: object
                                        properties:
                                          type:
                                            type: string
                                            enum:
                                            - USER
                                            description: Entity type
                                          id:
                                            type: string
                                            description: Entity ID
                                          displayName:
                                            type: string
                                            description: Entity display name
                                        required:
                                        - type
                                        - id
                                      - type: object
                                        properties:
                                          type:
                                            type: string
                                            enum:
                                            - GROUP
                                            description: Entity type
                                          id:
                                            type: number
                                            description: Entity ID
                                          iamId:
                                            type: string
                                            description: IAM ID
                                          name:
                                            type: string
                                            description: Entity display name
                                        required:
                                        - type
                                        - name
                                      - type: object
                                        properties:
                                          type:
                                            type: string
                                            enum:
                                            - PERMISSION
                                          permission:
                                            type: string
                                            enum:
                                            - GOVERNANCE
                                            - USER_ADMIN
                                            - AUDIT
                                            description: Global permission
                                        required:
                                        - type
                                        - permission
                                      - type: object
                                        properties:
                                          type:
                                            type: string
                                            enum:
                                            - DOMAIN PERMISSION
                                          permission:
                                            type: string
                                            enum:
                                            - Manage Policies
                                            - Audit Activity
                                            - Manage Data Products
                                            - Manage Identifiers
                                            description: Domain permissi

# --- truncated at 32 KB (728 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/immuta/refs/heads/main/openapi/immuta-asset-api-openapi.yml