MIGHTY DEVELOPERS

Get a file input

GET /v1/mic/inputs/{inputId}. MIC API request examples, required scopes and response schemas. Sandbox access requires an approved application.

Start here →

Request access

Service access is reviewed before credentials are issued. Public documentation and the read-only demo do not grant private sandbox or production access.

GET /v1/mic/inputs/{inputId}

Operation ID: getMicPublicInput

Authenticate your application

After access approval, sandbox provisioning and license activation, create client credentials in your workspace. Keep MIGHTY_CLIENT_ID and MIGHTY_CLIENT_SECRET in your server environment. Exchange them for an access token with the required scope. This example uses a POSIX shell such as Bash.

curl --request POST "https://www.pradiota.com/sandbox/oauth/token" \
  --user "$MIGHTY_CLIENT_ID:$MIGHTY_CLIENT_SECRET" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'scope=files:read mic.inputs:read'

Set MIGHTY_ACCESS_TOKEN to the returned access_token. Send it as Authorization: Bearer and request a new token when it expires. MIC API access is not enabled yet; request sandbox access to prepare your integration.

Send a request

After sandbox access is approved, use an access token for your application. Set MIGHTY_ACCESS_TOKEN. After MIC access is approved, open the MIC console at /developers/console/mic, choose the application and credential, then Load current workspace. Use the returned micws_ ID as MIC_WORKSPACE_ID and replace the other MIC variables with your workspace’s resource IDs. The example sends Bearer authentication and required query parameters; copying it does not send a request.

Required scope: mic.inputs:read. Additional permissions: files:read.

curl --request GET "https://www.pradiota.com/sandbox/v1/mic/inputs/${MIC_INPUT_ID}" \
  --header "Authorization: Bearer ${MIGHTY_ACCESS_TOKEN}" \
  --header 'Accept: application/json'

Query & header schemas

{
  "query": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "headers": {}
}

Success response schema

HTTP 200

{
  "$ref": "#/$defs/InputEnvelope",
  "$defs": {
    "InputEnvelope": {
      "type": "object",
      "properties": {
        "data": {
          "$ref": "#/$defs/Input"
        },
        "meta": {
          "type": "object",
          "properties": {
            "requestId": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          "required": [
            "requestId"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "data",
        "meta"
      ],
      "additionalProperties": false
    },
    "Input": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "workspaceId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "environment": {
          "type": "string",
          "enum": [
            "SANDBOX",
            "PRODUCTION"
          ]
        },
        "state": {
          "type": "string",
          "enum": [
            "WAITING_SCAN",
            "READY",
            "QUARANTINED",
            "EXPIRED",
            "WITHDRAWN"
          ]
        },
        "resourceVersion": {
          "type": "string",
          "pattern": "^[1-9][0-9]{0,18}$",
          "maxLength": 19
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "maxLength": 40
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "maxLength": 40
        },
        "inputKind": {
          "type": "string",
          "enum": [
            "M4_FILE",
            "ACQUISITION",
            "DATASET_VERSION"
          ]
        },
        "referenceId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "sha256": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "scanState": {
          "type": "string",
          "enum": [
            "PENDING",
            "CLEAN",
            "INFECTED",
            "UNAVAILABLE",
            "STALE",
            "NOT_APPLICABLE"
          ]
        },
        "classification": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "expiresAt": {
          "oneOf": [
            {
              "type": "string",
              "format": "date-time",
              "maxLength": 40
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "workspaceId",
        "environment",
        "state",
        "resourceVersion",
        "createdAt",
        "updatedAt",
        "inputKind",
        "referenceId",
        "sha256",
        "scanState",
        "classification",
        "expiresAt"
      ],
      "additionalProperties": false
    }
  }
}

Use cURL or install the MIC SDK and follow the language examples.

Browse MIC methods