# Kardinal Plan API

**Canonical:** https://apis.io/apis/kardinal/kardinal-plan-api/  
**Provider:** Kardinal — https://apis.io/providers/kardinal/  
**Base URL:** https://app.kardinal.ai/api/v2  
**Documentation:** https://developers.kardinal.ai/

Kardinal Plan API is one of 8 APIs that [Kardinal](https://apis.io/providers/kardinal/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Plan. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

How to create, retrieve, update and delete plans.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/agencies/{agencyId}/plans` | Retrieves a collection of plans |
| GET | `/agencies/{agencyId}/plans/{planId}` | Retrieve a plan |
| PUT | `/agencies/{agencyId}/plans/{planId}` | Create or update a plan |
| DELETE | `/agencies/{agencyId}/plans/{planId}` | Delete a plan |
| PUT | `/agencies/{agencyId}/plans/{planId}/running` | Stop or restart the optimization of a plan |
| GET | `/agencies/{agencyId}/plans/{planId}/solution` | Retrieve a plan solution |
| GET | `/agencies/{agencyId}/plans/{planId}/solution/objectives` | Retrieve the objectives of a plan solution |
| GET | `/agencies/{agencyId}/plans/{planId}/state` | Fetch the latest state of a plan |
| GET | `/agencies/{agencyId}/plans/{planId}/states` | Fetch the latest states of a plan |
| GET | `/agencies/{agencyId}/plans/{planId}/status` | Retrieve a plan status |
| PUT | `/agencies/{agencyId}/plans/{planId}/mode` | Changes a plan's mode |
| GET | `/agencies/{agencyId}/plans/{planId}/manual/check` | Check if a plan is in manual mode |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/kardinal/refs/heads/main/openapi/kardinal-plan-api-openapi.yml
- **Documentation** — https://developers.kardinal.ai/
- **APIReference** — https://developers.kardinal.ai/api-reference/authenticate/request-a-password-token
- **GettingStarted** — https://developers.kardinal.ai/getting-started/first-api-call
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/kardinal/refs/heads/main/authentication/kardinal-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/kardinal/refs/heads/main/errors/kardinal-error-codes.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/kardinal/refs/heads/main/data-model/kardinal-data-model.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/kardinal/refs/heads/main/mcp/kardinal-tool-crosswalk.yml

## Other Kardinal APIs (7)

- [Kardinal Authenticate API](https://apis.io/apis/kardinal/kardinal-authenticate-api/)
- [Kardinal Core API](https://apis.io/apis/kardinal/kardinal-core-api/)
- [Kardinal Management API](https://apis.io/apis/kardinal/kardinal-management-api/)
- [Kardinal Order API](https://apis.io/apis/kardinal/kardinal-order-api/)
- [Kardinal Resource API](https://apis.io/apis/kardinal/kardinal-resource-api/)
- [Kardinal Simple Plan API](https://apis.io/apis/kardinal/kardinal-simpleplan-api/)
- [Kardinal Solution API](https://apis.io/apis/kardinal/kardinal-solution-api/)

## Tags

Plan

---

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