onboarding

Poll for approval and collect the scoped key exactly once

On the first poll after approval this returns a SCOPED CHILD key: proxy + reads only. It is never the account root key, and it is shown exactly once. Subsequent polls return status "consumed".

post/api/agent-onboarding/poll

Request

  • Base URL: https://www.spendline.ai
  • URL: https://www.spendline.ai/api/agent-onboarding/poll
  • Auth: none required

Request body

request_idstring uuid required
device_codestring required

Response

Current state. status is one of pending_human_authorization, approved, denied, expired, consumed. api_key is present only on the single approved response.

request_idstring
status'pending_human_authorization' | 'approved' | 'denied' | 'expired' | 'consumed'
api_keystring

Present once, on approval. Store as SPENDLINE_API_KEY.

key_typestring
scopeobject
initial_budgetobject

Example response

{
  "key_type": "scoped_child"
}

Changes

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