PRADIOTAMIGHTY DEVELOPERS

MIGHTY DEVELOPERS

Check workspace capabilities

GET /v1/mic/capabilities. 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/capabilities

Operation ID: getMicPublicCapabilities

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=mic.capabilities: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.capabilities:read. Additional permissions: none.

curl --request GET "https://www.pradiota.com/sandbox/v1/mic/capabilities" \
  --header "Authorization: Bearer ${MIGHTY_ACCESS_TOKEN}" \
  --header 'Accept: application/json' \
  --get \
  --data-urlencode "workspaceId=${MIC_WORKSPACE_ID}"
Query & header schemas
{
  "query": {
    "type": "object",
    "properties": {
      "workspaceId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 128
      }
    },
    "required": [
      "workspaceId"
    ],
    "additionalProperties": false
  },
  "headers": {}
}
Success response schema

HTTP 200

{
  "$ref": "#/$defs/CapabilitySetEnvelope",
  "$defs": {
    "CapabilitySetEnvelope": {
      "type": "object",
      "properties": {
        "data": {
          "$ref": "#/$defs/CapabilitySet"
        },
        "meta": {
          "type": "object",
          "properties": {
            "requestId": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            }
          },
          "required": [
            "requestId"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "data",
        "meta"
      ],
      "additionalProperties": false
    },
    "CapabilitySet": {
      "type": "object",
      "properties": {
        "workspaceId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "environment": {
          "type": "string",
          "enum": [
            "SANDBOX",
            "PRODUCTION"
          ]
        },
        "capabilities": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Capability"
          },
          "minItems": 0,
          "maxItems": 100
        },
        "limits": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/QuotaBucket"
          },
          "minItems": 0,
          "maxItems": 32
        }
      },
      "required": [
        "workspaceId",
        "environment",
        "capabilities",
        "limits"
      ],
      "additionalProperties": false
    },
    "Capability": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "operation": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "version": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "supportLevel": {
          "type": "string",
          "enum": [
            "RAW_ONLY",
            "EXTRACT",
            "NORMALIZE",
            "PUBLISH_READY_FOR_RECIPE"
          ]
        },
        "enabled": {
          "type": "boolean"
        },
        "prerequisite": {
          "oneOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 1000
            },
            {
              "type": "null"
            }
          ]
        },
        "evidenceRef": {
          "oneOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            },
            {
              "type": "null"
            }
          ]
        },
        "maxInputBytes": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "maxRows": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "maxPages": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100000
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32
          },
          "minItems": 0,
          "maxItems": 32
        }
      },
      "required": [
        "kind",
        "operation",
        "version",
        "supportLevel",
        "enabled",
        "prerequisite",
        "evidenceRef",
        "maxInputBytes",
        "maxRows",
        "maxPages",
        "languages"
      ],
      "additionalProperties": false
    },
    "QuotaBucket": {
      "type": "object",
      "properties": {
        "unit": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "windowStart": {
          "type": "string",
          "format": "date-time",
          "maxLength": 40
        },
        "windowEnd": {
          "type": "string",
          "format": "date-time",
          "maxLength": 40
        },
        "granted": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "used": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "reserved": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "remaining": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "resetAt": {
          "oneOf": [
            {
              "type": "string",
              "format": "date-time",
              "maxLength": 40
            },
            {
              "type": "null"
            }
          ]
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time",
          "maxLength": 40
        }
      },
      "required": [
        "unit",
        "windowStart",
        "windowEnd",
        "granted",
        "used",
        "reserved",
        "remaining",
        "resetAt",
        "expiresAt"
      ],
      "additionalProperties": false
    }
  }
}

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

Browse MIC methods