PRADIOTAMIGHTY DEVELOPERS

MIGHTY DEVELOPERS

TypeScript SDK

Install the development SDK in a server-side Node.js project. JavaScript, TypeScript declarations and the account client are included.

Start here →

Install the SDK

Download a package for your language and follow its installation guide. After your application is approved, use its credentials and the scopes required by each API.

Development SDK · 259 service methods · 124 account and console methods

Archives are downloadable here, not published to Maven Central, npm or PyPI. Installing a package does not grant API access. Use approved sandbox credentials with https://www.pradiota.com/sandbox/v1. These packages preserve the configured API path. Current sandbox API base URL: https://www.pradiota.com/sandbox/v1.

Read the preview manifest →

TypeScript development SDK

Version 0.0.0-v5-development.2 · 184,609 bytes

Download TypeScript SDK

SHA-256
2e8889d7fc4caa59eb1e30cc3002d87de96bd4834a44f59b8bdf881f1cd7876b

Runtime requirements

Node.js 22 or newer; preview built and tested on Node.js 25.8.1.

ES modules. The archive includes JavaScript, TypeScript declarations and the ./human account client.

An approved organization grant and issued client credentials for platform.capabilities:read.

Keep client credentials in your server environment; never put client secrets in browser code.

Native API base URL https://www.pradiota.com/sandbox/v1. These packages preserve the configured API path. Use approved sandbox credentials.

Install locally

npm install --ignore-scripts https://www.pradiota.com/assets/developer-sdks/preview-20261007-sandbox-path/pradiota-mighty-developers-staging-0.0.0-v5-development.2.tgz
# Save the example as example.mjs and run it server-side:
node example.mjs

Make your first request

Create client credentials after your application is approved and its sandbox license is active. Set MIGHTY_CLIENT_ID and MIGHTY_CLIENT_SECRET in your server environment. The example exchanges them for a platform.capabilities:read token, then calls GET /v1/capabilities. Java and TypeScript use platformCapabilitiesGet; Python uses platform_capabilities_get. Save the example in the file named in the install instructions, then run it locally. Check the HTTP status, request ID and response body.

First request — approved application required
import { Client } from "@pradiota/mighty-developers-staging";

function required(name) {
  const value = process.env[name];
  if (!value?.trim()) throw new Error(`Set ${name}`);
  return value;
}

const client = new Client("https://www.pradiota.com/sandbox/v1");
const auth = await client.clientCredentials(required("MIGHTY_CLIENT_ID"),
  required("MIGHTY_CLIENT_SECRET"), "platform.capabilities:read");
if (auth.status !== 200 || !auth.body || typeof auth.body !== "object"
    || typeof auth.body.access_token !== "string" || !auth.body.access_token.trim()) {
  throw new Error(`Credential exchange failed: HTTP ${auth.status}`);
}
const response = await client.platformCapabilitiesGet(auth.body.access_token);
console.log(response.status, response.requestId, response.body);

Fresh-install checks: 2496 service transport cases and 67 account transport cases passed, with no failures or skips. These check installation and HTTP behavior. These checks use a local API test server and do not verify requests made with your credentials.

Transport verification

All 259 service methods passed HTTP tests in each language with origin, /v1 and /sandbox/v1 addresses. These tests verify client HTTP behavior against a local API test server.

SDK source f037ad356b212fd71a003b1bc490e84f32888500
Packaged contract SHA-256 6bc41c50901daa46fc98bfa658c366033c15028be53aaa81161b1633ff7426a7

MIC SDKs

Use the MIC client to work with inputs, recipes, jobs, file downloads and processing requests. This release includes the 15 methods in the MIC API reference.

Node.js / TypeScript MIC client

Version 0.1.0-development.2 · 16,707 bytes

Download MIC SDK

Node.js 22 or later. Download the archive into your project directory, then follow the installation commands.

npm install ./pradiota-mic-0.1.0-development.2.tgz

Check your workspace

After your application is approved for MIC and its sandbox license is active, create client credentials. Set MIGHTY_CLIENT_ID and MIGHTY_CLIENT_SECRET on your server and exchange them for a token with mic.capabilities:read.

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. Copy your workspace’s micws_ ID from the MIC console into MIC_WORKSPACE_ID. Save the example as mic-example.mjs, then run it on your server.

The SDK method getMicPublicCapabilities calls GET /v1/mic/capabilities in all three languages. The response describes the capabilities available to your application and workspace.

import { MicClient } from "@pradiota/mic";

function required(name) {
  const value = process.env[name];
  if (!value?.trim()) throw new Error(`Set ${name}`);
  return value;
}

const client = new MicClient({
  baseUrl: "https://www.pradiota.com/sandbox/v1",
  tokenProvider: () => required("MIGHTY_ACCESS_TOKEN"),
});
const response = await client.getMicPublicCapabilities({
  workspaceId: required("MIC_WORKSPACE_ID"),
});
console.log(response.status, response.requestId, response.body);
node mic-example.mjs
Checksum & verification
691793414cb3a45e83f851259bbbf68bc6b99f5415205be235a75faa4ca7e41a

Compare the SHA-256 with your downloaded archive. The release manifest lists every artifact and its validation details.

Read DAY, MONTH or ENTITLEMENT usage with mic.usage:read. MONTH reports measured calendar-month totals; granted, remaining and resetAt are null because no monthly allowance is approved.

Read the package guide.

Request every scope shown for the operation. File-backed methods also require files:read. Use a stable ASCII idempotency key of 8–160 characters for each mutation and the current If-Match value when cancelling a job.

Methods & required scopes
EndpointSDK methodRequired token scopes
GET /v1/mic/capabilitiesgetMicPublicCapabilitiesmic.capabilities:read
POST /v1/mic/inputscreateMicPublicInputfiles:read mic.inputs:write
GET /v1/mic/inputs/{inputId}getMicPublicInputfiles:read mic.inputs:read
GET /v1/mic/recipeslistMicExecutableRecipesmic.recipes:read
GET /v1/mic/recipe-versions/{versionId}getMicExecutableRecipemic.recipes:read
POST /v1/mic/jobscreateMicJobmic.jobs:run
GET /v1/mic/jobslistMicJobsmic.jobs:read
GET /v1/mic/jobs/{jobId}getMicJobmic.jobs:read
POST /v1/mic/jobs/{jobId}/cancellationscancelMicJobmic.jobs:cancel
POST /v1/mic/jobs/{jobId}/retriesretryMicJobmic.jobs:run
GET /v1/mic/assets/{assetId}/contentgetMicPublicAssetContentfiles:read mic.assets:read
GET /v1/mic/operations/{operationId}getMicPublicOperationmic.operations:read
GET /v1/mic/usagegetMicPublicUsagemic.usage:read
POST /v1/mic/processing-requestsrequestMicSharedFileProcessingfiles:read mic.jobs:run
GET /v1/mic/processing-requests/{requestId}getMicSharedFileProcessingRequestmic.jobs:read

Downloads are buffered with a default 64 MiB limit. Use Range for larger files; Node and Python expose a configurable response limit, while Java uses the fixed default.

A processing request is submitted for review. Approval and execution are separate steps; follow its status in the MIC console.