Skip to main content
POST
/
api
/
agent
/
consent
/
poll
Post Consent Poll
curl --request POST \
  --url https://api.example.com/api/agent/consent/poll \
  --header 'Content-Type: application/json' \
  --header 'X-Site-ID: <x-site-id>' \
  --data '
{
  "device_code": "<string>"
}
'
{
  "access_token": "<string>",
  "expires_in": 123,
  "scope": "<string>",
  "agent_name": "<string>",
  "budget_cents": 123,
  "token_type": "Bearer"
}

Documentation Index

Fetch the complete documentation index at: https://docs.stella-commerce.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
X-Site-ID
string
required

Body

application/json

Agent → Stella: poll for consent decision.

​
device_code
string
required
Required string length: 8 - 200

Response

Successful Response

Stella → agent: HTTP 200 success body per RFC 6749 §5.1.

scope is space-separated (NOT a JSON array) per spec. expires_in is relative seconds (NOT a timestamp). Stella-specific extension fields agent_name and budget_cents carry the consent shape so the agent doesn't need a second call.

​
access_token
string
required
​
expires_in
integer
required

Seconds remaining on the agt_ token's lifetime.

​
scope
string
required

Space-separated list of approved scopes per RFC 6749 §3.3.

​
agent_name
string
required
​
budget_cents
integer
required
​
token_type
string
default:Bearer