Skip to main content
POST
Create a new toolkit

Authorizations

Authorization
string
header
required

JWT authentication token

Body

application/json
name
string
required
toolkit_id
string
required

Stable kebab-case slug identifying the toolkit, unique per user (e.g. "github", "aws-s3"). Lowercase letters, digits, and hyphens only; must start with a letter; 1-63 characters. Underscores are NOT allowed in toolkit IDs (unlike tool IDs) — use hyphens. The reserved value "global" is the auto-managed default toolkit and cannot be created.

Pattern: ^[a-z][a-z0-9-]{0,62}$
Example:

"github"

dependencies
object

npm dep map (e.g. {"@octokit/rest": "^20.0.0"})

description
string
env_vars
string[]
init_code
string

TS module-level init code; runs once per (re)load.

pinned
boolean

When true, full schemas are inlined for every agent.

tags
string[]

Response

Toolkit created

created_at
string<date-time>
required
id
string<uuid>
required
installation_status
enum<string>
required
Available options:
not_started,
installing,
installed,
failed
is_system_global
boolean
required
language
enum<string>
required
Available options:
ts,
python,
go
name
string
required
pinned
boolean
required
toolkit_id
string
required
config_hash
string
dependencies
object
description
string
env_vars
string[]
init_code
string
installation_error
string
tags
string[]
updated_at
string<date-time>