Back to API Reference

Mira API

Update Log

User-facing version notes for the public Mira API contract. The top section summarizes the current release against the previous documented version; the history below records the supported public workflows by version.

Latest changes

Version 2.1.0 from 2.0.1

Current
  • Response formatting was cleaned up for a simpler, consistent envelope.
  • People and job search ID types are updated to string IDs across search results and entity detail lookups.
  • Public people and job search result windows are adjusted to 100 results per request.
  • Scholar search result sizing is updated to support explicit size values up to 100.
  • Job detail and source selection now follow public detail field defaults for public API keys.
  • GET /v1/version is supported alongside GET /version.
Version history

Documented API Versions

These entries describe the user-facing API contract for each documented public Mira API version.

2.1.0Current

Focuses public API usage around stable string IDs, public detail fields, cleaner response formatting, and clearer version discovery.

  • Search results return string profile and job IDs for downstream detail lookups.
  • Entity detail APIs accept the string type IDs returned by search.
  • Public people and job search result windows are adjusted to 100 results per request.
  • Scholar search supports explicit result sizing up to 100 for public API keys.
  • Job detail defaults return public job detail fields.
  • Source selection follows public field access rules for public API keys.
  • Version discovery supports both /version and /v1/version.
2.0.1Previous

Published the ID-first public REST contract and matching OpenClaw skills for search, entity detail, grading, jobs, and scholars.

  • People and job search returned IDs first, with full documents fetched through entity detail APIs.
  • Profile detail lookup supported profile IDs and LinkedIn URLs.
  • Job detail lookup supported job IDs.
  • People grading, bulk grading, comparison, contact unlock, stats, job search, and scholar search were documented together.
  • Version discovery used /version.
Integration notes

Recommended Update Path

Use these notes when refreshing integrations from the previous public contract to the current one.

  • Use search results as lookup handles: pass returned profile_ids or job_ids directly into the matching entity detail endpoint.
  • Use size values up to 100 for public people, job, and scholar search workflows.
  • If API responses differ from an installed skill or local integration notes, check /version and update the integration guide before continuing.