XQxquik-dev
Agent Discovery

Register an agent identity

Changed on

Register an agent for a user's verified email. The user claims it at claim.verification_uri with claim.user_code. Poll the token endpoint with claim_token until then. Keep every token secret.

post/agent/identity

Request

  • Base URL
    https://xquik.com
  • URL
    https://xquik.com/agent/identity
  • Auth
    none required

Request body

type'service_auth' required
login_hintstring email required

The user's verified email. The user must sign in with it to claim the agent.

Example request

{
  "login_hint": "user@example.com"
}

Response

The registration & the code the user enters to claim it.

claim_tokenstring required

Poll the token endpoint with it & refresh the user code with it. Keep it secret.

claim_token_expiresstring date-time required

When claim_token expires, 24 hours after registration.

claim_urlstring uri required

Where to refresh an expired user code.

post_claim_scopesstring[] required

The scopes the access token gets once claimed.

registration_idstring required
registration_type'service_auth' required

Example response

{
  "claim": {
    "user_code": "042137",
    "verification_uri": "https://xquik.com/agent/identity/claim/view?claim_attempt_token=CLAIM_ATTEMPT_TOKEN"
  },
  "claim_token": "clm_0000000000000000000000000000000000000000000000000000000000000000",
  "claim_token_expires": "2026-12-02T12:00:00.000Z",
  "claim_url": "https://xquik.com/agent/identity/claim",
  "post_claim_scopes": [
    "mcp:tools"
  ],
  "registration_id": "reg_6f1c2a7e-8d4b-4c1a-9e2f-3b5d7a9c1e0f"
}

Changes

  • 20d4bcaa8f4eRevision changes
    • breaking

      the / response's property format changed from int64 to no format for status

    • breaking

      the / response's property format changed from int64 to no format for status

    • info

      removed the non-success response with the status

  • 48f2012c62b3Revision changes
    • info

      added the non-success response with the status