Skip to main content
POST
Register an agent

Authorizations

Authorization
string
header
required

Bearer token in the Authorization header. Management routes accept a session token or a personal API key (abu_). Agent-facing access.* routes require an agent session token (abs_).

Headers

X-Abadge-Org-Id
string

Active organization. Required when the caller belongs to more than one org; otherwise resolved automatically.

Body

application/json
kind
enum<string>
required
Available options:
local_cli,
local_mcp,
remote
name
string
required
Minimum string length: 1
authMethod
enum<string>
Available options:
public_key_session
publicKey
string

Ed25519 public key in JWK format. Provide this OR issueBootstrapToken, not both.

issueBootstrapToken
boolean

Issue a one-time abe_ enrollment token instead of supplying a key now.

metadata
object

Free-form metadata (description, owner tags, etc.).

Response

Agent registered

agent
object
required
bootstrapToken
string | null

Present only when issueBootstrapToken was true. Shown once.

bootstrapExpiresAt
string<date-time> | null