Agents

Connect BYOA Agent

Registers a bring-your-own-agent RSA public key (RS256, 2048 bits or larger) and mints a delegated grant. dryRun returns the planned registration without writing. Non-RSA keys are rejected.

post/agents/connect

Request

  • Base URL: https://synchronex.ai/api/v1
  • URL: https://synchronex.ai/api/v1/agents/connect
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://synchronex.ai/oauth/authorize, token URL https://synchronex.ai/api/oauth/token, scopes: read)

Request body

workspaceIdstring uuid nullable
namestring required
publicKeystring required

SPKI PEM of an RSA public key for RS256 proof-of-possession. Must be 2048 bits or larger. EC and other key types are rejected.

agentScopesstring[] required
proofKeyThumbprintstring required
expiresAtstring date-time required
tokenTtlSecondsinteger
maxSpendUsdnumber nullable
dryRunboolean

Response

Dry-run connection plan.

connectedfalse required
dryRuntrue required

Changes

No recorded changes to this operation across all 1 revision of this API.