Bot templates
Import a curated Cluster Bot template into an ordinary saved Computer session, with authored instructions and pinned skills.
The catalog under Plugins → Bots is a curated discovery surface. Importing a template creates an ordinary, actor-private, organization-pinned Computer session ("bot") — it does not create an agent definition, project, plugin installation, connection, or running job.
The catalog currently includes Marketing Analyst, Meeting Notes, Voice-Matched Drafts, Sales Prospector and Research Assistant, adapted from botdirectory.ai with source attribution. Each template pins authored standing instructions and a set of immutable, versioned skills; some also ship optional routine presets that you must explicitly review and enable — nothing is scheduled automatically.
What import does not do
Importing a template copies no credentials, connections, shared stores, or personal memories, and it enables no routine. You can freely edit the bot's standing instructions afterward; catalog changes never overwrite your edits or the skill versions your bot already has pinned.
API
| Method | Path | Description |
|---|---|---|
GET | /v1/bot-templates | List the template catalog. |
POST | /v1/bot-templates/import | Import a template (org_id, template_id, revision, and a bounded request_id of 1-128 letters, digits or hyphens). Returns 201 with the new Session the first time, 200 with the same Session on replay. |
import is human-only — it requires a Bearer JWT with the compute:use
scope, not an organization API key. Repeating the same actor/organization/
request_id returns the original bot instead of creating a duplicate;
resending it with different inputs conflicts with 409. A receipt survives
deleting the imported bot, so replaying a request_id after deletion never
resurrects it — import a fresh template instead.
The imported session gets its own owned environment
and files folder, so its files are available the first time it opens. Opening
the bot starts its first conversation (POST /v1/sessions/{id}/setup/start),
which has the bot introduce itself using its template and skills. Connecting an account or
installing a plugin it suggests always goes through an explicit approval card.
Bots imported before October 17, 2026 that were never opened have no files folder, and none is added later. Delete and re-import them to get one.
See API reference for authentication and error conventions shared across the API.