# Kognitos Runs API

**Canonical:** https://apis.io/apis/kognitos/kognitos-runs-api/  
**Provider:** Kognitos — https://apis.io/providers/kognitos/  
**Base URL:** https://app.us-1.kognitos.com/api/v1  
**Documentation:** https://docs.kognitos.com/guides/api-reference/api-reference

Kognitos Runs API is one of 9 APIs that [Kognitos](https://apis.io/providers/kognitos/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Runs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and 6 JSON Schemas.

Execute automations and manage run lifecycle — start, pause, continue, and view events.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs/{run_id}` | Get Run |
| GET | `/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs` | List Runs |
| POST | `/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs/{run_id}:pause` | Pause Run |
| POST | `/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs/{run_id}:continue` | Continue Run |
| GET | `/api/v1/organizations/{organization_id}/workspaces/{workspace_id}:automationRunAggregates` | Query Automation Run Aggregates |
| GET | `/api/v1/organizations/{organization_id}/workspaces/{workspace_id}:dailyRunAggregates` | Query Daily Run Aggregates |
| GET | `/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/executions/{execution_id}/outputs` | Get Execution Outputs |
| GET | `/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/automations/{automation_id}/runs/{run_id}/events` | List Run Events |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/kognitos/refs/heads/main/openapi/kognitos-runs-api-openapi.yml
- **Documentation** — https://docs.kognitos.com/guides/api-reference/api-reference
- **Authentication** — https://docs.kognitos.com/guides/api-reference/api-keys
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/kognitos/refs/heads/main/json-schema/kognitos-v1-automation-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/kognitos/refs/heads/main/json-schema/kognitos-v1-exception-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/kognitos/refs/heads/main/json-schema/kognitos-v1-guide-entry-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/kognitos/refs/heads/main/json-schema/kognitos-api-http-body-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/kognitos/refs/heads/main/json-schema/kognitos-v1-run-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/kognitos/refs/heads/main/json-schema/kognitos-v1-list-run-events-response-schema.json

## Other Kognitos APIs (8)

- [Kognitos MCP Server](https://apis.io/apis/kognitos/kognitos-mcp-server/)
- [Kognitos Analytics API](https://apis.io/apis/kognitos/kognitos-analytics-api/)
- [Kognitos Automations API](https://apis.io/apis/kognitos/kognitos-automations-api/)
- [Kognitos Books API](https://apis.io/apis/kognitos/kognitos-books-api/)
- [Kognitos Exceptions API](https://apis.io/apis/kognitos/kognitos-exceptions-api/)
- [Kognitos Files API](https://apis.io/apis/kognitos/kognitos-files-api/)
- [Kognitos Organizations API](https://apis.io/apis/kognitos/kognitos-organizations-api/)
- [Kognitos Workspaces API](https://apis.io/apis/kognitos/kognitos-workspaces-api/)

## Tags

Runs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/kognitos/kognitos-runs-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/kognitos/.