Create and version an Agent

Create an Agent, update it, and retrieve immutable Versions.

Checkfu matches Claude Managed Agents: Agent Versions are automatic. There is no Draft resource and no publish operation. The CLI and TypeScript examples require CLI access and SDK access.

import { Checkfu } from "@checkfu/sdk"

const checkfu = new Checkfu({ apiKey: process.env.CHECKFU_API_KEY })

Create Version 1

CLI

export CHECKFU_AGENT_ID="$(checkfu agent create --json --input '{
  "name": "release-notes",
  "model": "claude-opus-5",
  "system": "Lead with user impact, then cite verification evidence."
}' | jq -r '.id')"

The CLI and cURL tabs capture the stable agent_… ID in CHECKFU_AGENT_ID; the TypeScript tab retains it as agent.id. The created Agent has version: 1.

Create the next Version

CLI

checkfu agent update "$CHECKFU_AGENT_ID" --json --input '{
  "version": 1,
  "description": "Drafts concise release notes from verified changes."
}'

A changed configuration returns Version 2. The optional version field is the optimistic-concurrency guard; omit it for a last-write-wins declarative apply loop. An unchanged effective configuration is a no-op.

Retrieve one exact Version

CLI

checkfu agent get "$CHECKFU_AGENT_ID" --version 1 --json

Updating the Agent head never changes an earlier Version.

List Version history

CLI

checkfu agent versions "$CHECKFU_AGENT_ID" --json

The CMA-compatible Session slice is the next lifecycle step. The retired Draft, Release, export/import, and AgentDeployment calls are not part of the current Agent API.