API

Connect scripts and services to your workspace.

The ProteinIQ API runs scientific tools using your workspace's inputs, credits, and permissions. Jobs run asynchronously: submit a request, follow its progress, then retrieve structured results and files.

Data routes use the base URL https://proteiniq.io/api/v1 and require a workspace API key. API access requires Enterprise; active legacy Lite workspaces retain access.

Run your first analysis

The quickstart includes a complete Python script that checks a quote, submits an ESMfold job, waits for results, and downloads available files. It uses the Python standard library.

API resources

Each resource represents part of an analysis:

Tools: Discover available analyses and their accepted inputs, settings, outputs, and credit models.
Jobs: Quote, submit, list, monitor, share, or cancel individual tool runs.
Results: Read structured outputs and retrieve temporary file download URLs.
Files: Upload inputs once and reuse saved files across jobs.
Projects: Group jobs, files, workflows, and workflow runs.
Workflows: Run published workflows and manage their attempts and review checkpoints.
Events: Stream job progress instead of repeatedly requesting status.

Requests and responses

JSON write requests require Content-Type: application/json. Tool contracts describe accepted slots in input.slots[]; job requests supply their data in input.inputs[].

Resource responses identify their type with object, such as job or job_result. Paginated lists return data, has_more, and next_cursor. Pass a non-null cursor as starting_after to request the next page.

Errors return an error object with a stable code, readable message, and recovery guidance. Inspect the HTTP status before treating a response as a resource.

Workspace limits

API jobs use the same credits as jobs in the app. Quotes estimate spending without creating a job or reserving credits.

The account endpoint reports available credits, concurrency, request limits, and key metadata. Honor Retry-After when a request is throttled.

Client integrations

The OpenAPI specification describes HTTP routes and schemas. The Python SDK reference covers the maintained client and its current installation requirements. AI clients can connect through MCP.

API resources

Each resource represents part of an analysis:

Tools: Discover available analyses and their accepted inputs, settings, outputs, and credit models.

Jobs: Quote, submit, list, monitor, share, or cancel individual tool runs.

Results: Read structured outputs and retrieve temporary file download URLs.

Files: Upload inputs once and reuse saved files across jobs.

Projects: Group jobs, files, workflows, and workflow runs.

Workflows: Run published workflows and manage their attempts and review checkpoints.

Events: Stream job progress instead of repeatedly requesting status.

Requests and responses

JSON write requests require Content-Type: application/json. Tool contracts describe accepted slots in input.slots[]; job requests supply their data in input.inputs[].

Errors return an error object with a stable code, readable message, and recovery guidance. Inspect the HTTP status before treating a response as a resource.