API Reference - Cadenya

The Cadenya API gives you programmatic control over every resource in the platform: tool sets, agents, objectives, memory, and more. Every endpoint here is generated from the OpenAPI specification, with request and response schemas and copy-paste SDK snippets in TypeScript, Go, Ruby, and cURL.

Base URL

https://api.cadenya.com

Authentication

Every request is authenticated with an HTTP bearer token (a JWT minted from a workspace-scoped API key):

Authorization: Bearer $CADENYA_API_KEY

See the API Design guide for how keys are issued, rotated, and scoped to workspaces.

SDKs

Official SDKs wrap the API in idiomatic clients:

TypeScript

npm install @cadenya/cadenya

Go

go get github.com/cadenya/cadenya-go

Ruby

gem install cadenya

CLI

brew install cadenya/tools/cadenya-cli

Conventions

External IDs. Pass your own external_id: value anywhere the API accepts a Cadenya ID. See External IDs are first-class in paths.
Field masks. Updates are PUT-shaped but behave like PATCH through update_mask. See Updates use field masks.
Pagination. List endpoints share a common shape with limit, cursor, prefix, and query. See List requests.

Browse the endpoints in the sidebar to get started.

​Base URL

​Authentication

​SDKs