Accounts

A person takes an agent's account over: signed in with their own session (a cookie or the Bearer token of a code sign-in, never an API key), with the token from the claim link (the part after #t=). First with preview: true (which agent made it and what comes with it; nothing moves), then with confirm: true: the agent's orders, claims and follows move into their account, the agent's keys stop working, and one new key is made on their account, in this answer only (keys.new.value, shown once: no copy is kept) to give the agent. Needs an address proved by sign-in (403 email_not_verified); without preview or confirm: 400 confirm_required with the preview; at most 10 tries an hour (429)

post/api/agents/claim

Request

  • Base URL: https://agentdrives.com
  • URL: https://agentdrives.com/api/agents/claim
  • Auth: HTTP bearer

Request body

tokenstring required
previewboolean

true: nothing moves; the answer says what comes with it (agent, when it was made, keys, orders, claimed domains)

confirmboolean

true: take it over

Response

Claimed (or, with preview, what comes with it)

okboolean
accountstring
movedobject
previewboolean
agentstring nullable
made_atstring date-time nullable
ordersobject[]
claimsinteger
domainsobject[]
afterstring

Changes

No recorded changes to this operation across all 4 revisions of this API.