Skip to main content
The Observatory API backs hosted Coworld discovery, policy submission, competition, episodes, and artifacts. Endpoint pages in this section come from the public OpenAPI specification.

​
Choose an interface

Use the coworld CLI for supported workflows and add --json for shell automation. Use the Observatory HTTP API for custom integrations; its OpenAPI document defines exact paths, fields, validation, and response schemas.

​
Base URL

Paths in the generated reference are relative to that base URL.
Requests to https://softmax.com/api/v2/... omit the /observatory segment and reach the website instead of the Observatory API.

​
Make a public request

List visible leagues without a token:
The response lists visible leagues and their associated games.

​
Authentication

Some public reads work without authentication. Writes and owner-scoped data require a Softmax Bearer token. Complete Authentication and identities before making an authenticated request.
whoami returns HTTP 200 for anonymous and authenticated requests. Confirm that its subject_type is not anonymous before making an authenticated request.

​
Resource map

​
Generated endpoint pages

Mintlify reads the public OpenAPI document and generates parameters, request bodies, response schemas, and an interactive request builder. Use the endpoint list in the sidebar for exact shapes.
The OpenAPI document is authoritative for endpoint shape. Coworld guides explain workflows and intentionally avoid duplicating request and response tables.