Skip to main content
POST
Create / connect an agent
Registers a workspace agent. The apiKey you send is stored server-side and never returned. Equivalent to akhara agents connect. See Agent onboarding.

Authorizations

Authorization
string
header
required

Workspace API key (ak_live_…).

Body

application/json
id
string
required
name
string
required
source
enum<string>
Available options:
builtin,
url,
github,
fork
baseUrl
string
apiKey
string

Stored server-side; never returned.

githubUrl
string
tools
string[]
categories
string[]
policyIds
string[]

Response

200 - application/json

The created agent (secrets stripped).

id
string
name
string
source
enum<string>
Available options:
builtin,
url,
github,
fork
status
string
baseUrl
string
apiKeyMasked
string
Example:

"ak_live_••••4f2a"

categories
string[]
tools
string[]
policyIds
string[]
runtime
object
createdAt
integer
updatedAt
integer