agent-auth

Register an agent (Auth.md)

An agent registers itself: anonymous (no user yet), service_auth (the user's email, confirmed by the user on the console) or identity_assertion (an ID-JAG from a trusted provider). Returns a service-signed identity_assertion or a claim ceremony, never a credential. Read https://letsship.ai/auth.md for the whole flow.

post/agent/identity

Request

  • Base URL: https://api.letsship.ai/v1
  • URL: https://api.letsship.ai/v1/agent/identity
  • Auth: none declared

Request body

OR
OR

Example request

{
  "agent_name": "Release notes agent"
}

Response

Registered.

registration_idstring required
registration_type'anonymous' | 'service_auth' | 'identity_assertion' required
identity_assertionstring
assertion_expiresstring
pre_claim_scopesstring[]
scopesstring[]
claim_urlstring
claim_tokenstring

Returned once. Keep it in memory for the claim, never longer.

claim_token_expiresstring
post_claim_scopesstring[]

Example response

{
  "registration_id": "reg_4kQ2...",
  "claim": {
    "user_code": "482913",
    "verification_uri": "https://letsship.ai/claim?claim_attempt_token=cat_...",
    "expires_in": 600,
    "interval": 5
  }
}

Changes

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