---
title: "Scan a remote model"
method: POST
path: "/scan/v3/jobs"
tags: ["Model Scanner SaaS", "Model Scanner Self-Hosted (Deprecated)"]
---

# Scan a remote model

`POST /scan/v3/jobs`

## Response `201`

Scan job request was accepted

- ScanJob
  - `inventory` object, required
    - `model_name` string, required — Name of the model
    - `model_version` string, required — If you do not provide a version, one will be generated for you.
    - `requested_scan_location` string — **DEPRECATED**: Use `scan_target` instead. Location of files to be scanned. Maintained for backwards compatibility. If both `requested_scan_location` and `scan_target` are provided, `scan_target` takes precedence.
    - `scan_target` union — Specifies what to scan. Must provide at least one of: deep_scan with file location details, provider_details, or both.
      - object
        - `deep_scan` union, required
          - object
            - `file_location` string, required — URL or path to the model files
            - `files` object[] — List of specific files to scan
              - …
          - object
            - `file_location` string — URL or path to the model files
            - `files` object[], required — List of specific files to scan
              - …
        - `provider_details` ProviderDetails
          - `provider` 'AWS_BEDROCK' | 'AWS_SAGEMAKER' | 'AZURE_AI_FOUNDRY' | 'AZURE_ML' | 'DATABRICKS', required
          - `provider_model_id` string, required — The provider's unique identifier for the model. Examples: - AWS Bedrock: "anthropic.claude-3-5-sonnet-20241022-v2:0" - Azure AI Foundry: "Claude-3-5-Sonnet"
          - `model_arn` string — Optional full ARN or resource identifier for the model. Used for provisioned models, custom deployments, or cross-account access.
          - `country` string — Optional country code (ISO 3166-1 alpha-2) for the location where the model provider is primarily based.
        - `asset_region` string — region of the discovered asset
        - `asset_id` string, uuid — identifier of the discovered asset
      - object
        - `deep_scan` union
          - object
            - `file_location` string, required — URL or path to the model files
            - `files` object[] — List of specific files to scan
              - …
          - object
            - `file_location` string — URL or path to the model files
            - `files` object[], required — List of specific files to scan
              - …
        - `provider_details` ProviderDetails, required
          - `provider` 'AWS_BEDROCK' | 'AWS_SAGEMAKER' | 'AZURE_AI_FOUNDRY' | 'AZURE_ML' | 'DATABRICKS', required
          - `provider_model_id` string, required — The provider's unique identifier for the model. Examples: - AWS Bedrock: "anthropic.claude-3-5-sonnet-20241022-v2:0" - Azure AI Foundry: "Claude-3-5-Sonnet"
          - `model_arn` string — Optional full ARN or resource identifier for the model. Used for provisioned models, custom deployments, or cross-account access.
          - `country` string — Optional country code (ISO 3166-1 alpha-2) for the location where the model provider is primarily based.
        - `asset_region` string — region of the discovered asset
        - `asset_id` string, uuid — identifier of the discovered asset
    - `requesting_entity` string, required — Entity that requested the scan
    - `request_source` 'Hybrid Upload' | 'API Upload' | 'Integration' | 'UI Upload' | 'AI Asset Discovery' — Identifies the system that requested the scan
    - `origin` string — Specifies the platform or service where the model originated before being scanned
  - `scan_id` string, uuid — unique identifier for the scan
  - `status` 'pending' | 'running' | 'done' | 'failed' | 'canceled' — Status of the scan

## Other responses

- `400` — The request failed due to a client error, with one or more of the following possible causes: 1. The request required a tenant_id field, which was missing. 2. The request was malformed syntactically or semantically.
- `422` — Validation Error

---

[API](https://skmtc.net/hiddenlayerai/apis/hiddenlayer-audit-api.md) · [All operations](https://skmtc.net/hiddenlayerai/apis/hiddenlayer-audit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiddenlayerai/hiddenlayer-audit-api/versions/efca861e915b/schema)