API Overview

The Cortex API is an HTTP API for building applications and automation on Cortex.

Base URL

https://api.cortex.cognit-dx.com

Request Format

  • JSON endpoints expect Content-Type: application/json.
  • Protected endpoints require Authorization: Bearer <token>.
  • Path IDs are UUIDs unless an endpoint states otherwise.
  • List endpoints use limit and offset where pagination is supported.

API Types

TypePurpose
Platform APIEndpoints for applications, SDKs, CLI workflows, and automations.
Organization AdministrationEndpoints for administrators managing the current organization.
System OperationsEndpoints for Cortex system administrators.

Response Conventions

  • List endpoints commonly return { items, total?, limit?, offset? }.
  • Errors use { error, code?, details? }.
  • Async execution endpoints return queued or running records first; clients then read run state and events.