XQxquik-dev
Agent Discovery

Refresh an agent claim code

Changed on

Get a new user code for a pending agent registration, such as after the last one expired. The claim token must still be valid.

post/agent/identity/claim

Request

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

Request body

claim_tokenstring required

The claim_token from the registration.

emailstring email required

The login_hint of the registration.

Example request

{
  "claim_token": "clm_0000000000000000000000000000000000000000000000000000000000000000",
  "email": "user@example.com"
}

Response

The new claim attempt & its user code.

claim_attempt_idstring required
expires_atstring date-time required

When the new user code expires.

registration_idstring required
status'initiated' required

Example response

{
  "claim_attempt": {
    "user_code": "042137",
    "verification_uri": "https://xquik.com/agent/identity/claim/view?claim_attempt_token=CLAIM_ATTEMPT_TOKEN"
  },
  "claim_attempt_id": "cla_9b2f4d6a8c1e3f5a7b9d1c3e5f7a9b2d",
  "expires_at": "2026-12-01T12:10:00.000Z",
  "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