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.
name
capabilities
reason
mode
Allowed values:
preferred_method
Allowed values:
host_name
login_hint
binding_message
force_approval
Response
Protocol response.
agent_id
host_id
name
mode
Allowed values:
status
agent_capability_grants
approval
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
503
Service Unavailable Error