Claude Managed Agents

kenari meneruskan API Anthropic yang tidak diterjemahkannya langsung ke Anthropic: Managed Agents, Files, Skills, dan Message Batches. Kamu tetap memakai satu base URL dan satu key kn-. Anthropic menagih organisasi Anthropic Console di balik key-mu, jadi kredit API Max atau Team juga terpakai di sini. kenari tidak mengukurnya. Untuk request chat, lihat Messages.

Ini passthrough murni. kenari tidak membaca, mengubah, atau menerjemahkan body request maupun response. Untuk isi dan hasil tiap endpoint, lihat dokumentasi Anthropic.

Sebelum mulai

• Kamu butuh Langganan aktif. Lihat Khusus pelanggan Langganan.
• Kamu butuh API key Anthropic yang tersimpan di kenari. Tambahkan di Provider & Rute, tab Provider. Lihat Provider.
• Kamu butuh key kn- dari akunmu sendiri. Lihat Key.

Base URL dan path

Pakai https://kenari.id sebagai base URL, tanpa /v1, dan path yang sama dengan Anthropic. Path berikut diteruskan, masing-masing beserta semua path di bawahnya:

Path	Isinya
/v1/agents	Agent
/v1/environments	Environment
/v1/sessions	Session dan event-nya
/v1/vaults	Vault
/v1/deployments	Deployment
/v1/deployment_runs	Deployment run
/v1/memory_stores	Memory store
/v1/files	File
/v1/skills	Skill
/v1/messages/batches	Message Batches

GET, POST, PUT, PATCH, dan DELETE diteruskan. Path request yang memuat .., garis miring yang di-encode, atau backslash ditolak dengan 400 dan invalid_path.

SDK resmi Anthropic bisa dipakai dengan base URL ini. Atur ANTHROPIC_BASE_URL=https://kenari.id dan pakai key kn- sebagai API key, atau berikan keduanya ke client. SDK mengirim key di x-api-key, dan kenari menerimanya di sana. SDK juga mengatur sendiri header anthropic-beta untuk Managed Agents.

Key

Kirim key kn- sebagai x-api-key: kn-... atau Authorization: Bearer kn-.... Lihat Autentikasi & API key.

Passthrough membuka seluruh organisasi Anthropic-mu bagi siapa pun yang memegang key, dan batas di kenari tidak bisa melihat lalu lintas ini. Karena itu key berikut ditolak dengan 403:

• API key dibagikan, dengan shared_key_not_allowed.
• Key dengan cakupan model, batas biaya, atau batas token, dengan restricted_key_not_allowed.

Pakai key dari akunmu sendiri tanpa pembatasan.

Khusus pelanggan Langganan

Passthrough butuh Langganan aktif. Masa percobaan dan paket hadiah dihitung. Tanpa itu, request gagal dengan 403 dan subscription_required. Lihat Langganan.

API key Anthropic mana yang dipakai

kenari hanya memakai API key Anthropic yang kamu simpan sendiri. kenari tidak pernah memakai key miliknya, dan tidak pernah memakai key yang menunjuk ke base URL custom. Sebuah key dihitung jika aktif, tidak sedang dijeda, dan kredit Claude-nya belum habis saat berhenti otomatis menyala. Lihat Provider.

Akunmu punya	Yang terjadi
Satu key seperti itu	kenari memakainya otomatis.
Tidak ada	409 dan anthropic_credential_required. Tambahkan key di tab Provider.
Dua atau lebih	409 dan credential_required, sampai kamu menyebut satu lewat header x-kenari-credential.

curl https://kenari.id/v1/agents \
  -H "x-api-key: $KENARI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "x-kenari-credential: $ANTHROPIC_KEY_ID"

Untuk mendapatkan id, buka Provider & Rute, tab Provider, buka menu di baris key Anthropic lalu pilih Salin ID kunci. Nilai yang bukan key Anthropic aktif milik akunmu mengembalikan 404 dan credential_not_found. Jika key yang kamu sebut sudah menghabiskan kredit Claude-nya saat berhenti otomatis menyala, request mengembalikan 409 dan credit_limit_reached. Naikkan kredit, matikan berhenti otomatis, atau tunggu tanggal pembaruan. kenari tidak pernah pindah ke key lain, karena agent, session, atau file yang dibuat di satu organisasi tidak bisa dipakai dari organisasi lain. Kalau kamu tidak mau mengirim header itu, sisakan satu key Anthropic yang aktif dan nonaktifkan yang lain di tab Provider.

Yang diteruskan

kenari hanya mengirim header request ini ke Anthropic: anthropic-version, anthropic-beta, content-type, accept, dan last-event-id. Key kn- tidak pernah dikirim. kenari menambahkan key Anthropic sendiri.

Dari jawaban Anthropic, kamu menerima status, body, dan header berikut: content-type, retry-after, cache-control, dan semua header anthropic-ratelimit-*. ID request Anthropic tiba sebagai anthropic-request-id. Header x-request-id dan request-id milik kenari sendiri.

Body mengalir ke dua arah tanpa buffer, jadi aliran server-sent event, seperti aliran event sebuah session, tiba persis seperti yang dikirim Anthropic.

Contoh

Daftar agent

curl https://kenari.id/v1/agents \
  -H "x-api-key: $KENARI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01"

Buat session

Buat agent dan environment lebih dulu. Lalu mulai session yang memakainya. Ganti id dengan id milikmu.

curl https://kenari.id/v1/sessions \
  -H "x-api-key: $KENARI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "agent": {"type": "agent", "id": "agent_abc123"},
    "environment_id": "env_abc123"
  }'

Response-nya milik Anthropic, dengan id session.

Batas

• Body request boleh sampai 100 MB. Yang lebih besar gagal dengan 413 dan request_too_large.
• Batas request per menit akunmu berlaku. Lihat Batas laju.
• kenari melayani sejumlah terbatas request passthrough pada saat yang sama untuk semua akun. Aliran event yang panjang menahan tempatnya sampai selesai. Saat kenari penuh, request gagal dengan 429 dan passthrough_busy. Coba lagi sebentar lagi.

Penagihan

kenari tidak menagih lalu lintas ini, dan tidak mencatat pemakaian token untuknya. Anthropic menagih organisasi di balik key, itulah sebabnya kredit API Max atau Team terpakai di sini. Spend limit yang kamu atur di Claude Console tetap berlaku seperti biasa.

Error

Error dari kenari memakai amplop Anthropic, yaitu objek dengan "type": "error" dan objek error yang memuat type, message, dan code. Saat Anthropic sendiri menjawab dengan error, kamu menerima status dan body-nya tanpa perubahan. Di sini hanya error yang khusus untuk halaman ini. Sisanya ada di Error.

Status	Kode	Kapan
400	invalid_path	Path memuat .., garis miring yang di-encode, atau backslash.
401	tidak ada	Key kn- tidak ada, salah, kedaluwarsa, atau dicabut. Body-nya teks biasa. Lihat Error.
403	subscription_required	Akun tidak punya Langganan aktif.
403	shared_key_not_allowed	Yang dipakai adalah API key dibagikan.
403	restricted_key_not_allowed	Key punya cakupan model, batas biaya, atau batas token.
404	credential_not_found	Nilai x-kenari-credential bukan key Anthropic aktif milik akunmu.
409	anthropic_credential_required	Belum ada API key Anthropic yang tersimpan, atau tidak ada yang aktif.
409	credential_required	Dua key Anthropic atau lebih aktif dan header x-kenari-credential tidak dikirim.
409	credit_limit_reached	Key yang disebut di x-kenari-credential sudah menghabiskan kredit Claude-nya, dan berhenti otomatis menyala.
413	request_too_large	Body request lebih dari 100 MB.
429	passthrough_busy	Terlalu banyak request passthrough yang sedang berjalan.
429	rate_limit_exceeded	Batas request per menit akun sudah terpakai.
503	upstream_error	kenari tidak bisa menjangkau Anthropic, atau Anthropic mengembalikan error gateway.

Lihat juga

• Provider
• Messages
• Autentikasi & API key
• Langganan