REST API

Our REST API is a programmatic interface for interacting with Kognitos, allowing you to manage agents, processes, files, and runs.

Version 2 is the latest version of the Kognitos REST API. Check out our migration guide here.

Authentication

Authentication uses an API Key, which must be included in the x-api-key header of every request:

x-api-key: YOUR_API_KEY

Base URLs

Our REST API is available in different regions. Use the base URL that matches your region when making requests:

Region	Base URL
US Region	https://rest-api.app.kognitos.com
EU Region	https://rest-api.eu.kognitos.com
UK Region	https://rest-api.uk.kognitos.com

Endpoints

These are the resources and endpoints in the Kognitos REST API (v2):

Resource	Endpoint	Description
Processes	GET /v2/processes	Get all processes for a specified agent
	GET /v2/processes/{id}	Get detailed information for a specific process
Runs	GET /v2/runs	Get all runs for a specified process and agent
	POST /v2/runs	Start a new run for a specified process
	GET /v2/runs/{id}	Get the details of a specific process run
Files	POST /v2/files	Request file upload URL
Health	GET /v2/health	Check the status and system health of the REST API v2