Skip to navigation

Register agent

Start a delegated connection using a host-signed JWT. The SDK manages host and agent keys. Open approval.verification_uri_complete in a browser and poll status after human approval. Kuudo supports only delegated mode and device_authorization. Approval links expire after 900 seconds. Registration is limited to 10 requests per IP per hour and returns 503 if its abuse limiter is unavailable. See the AI-agents guide. Agent Auth JWTs are not API-key exchange tokens.

Request

This endpoint expects an object.
namestringRequired>=1 character
capabilitieslist of strings or objectsOptional
reasonstringOptional
modeenumOptional
Allowed values:
preferred_methodenumOptional
Allowed values:
host_namestringOptional
login_hintstringOptional
binding_messagestringOptional
force_approvalbooleanOptional

Response

Protocol response.
agent_idstring
host_idstring or null
namestring
modeenum
Allowed values:
statusstring
agent_capability_grantslist of objects
approvalobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
503
Service Unavailable Error