Hanzo
OpenapiIntegrations

Advances a device sign-in.

Advances a device sign-in. Terminal outcomes are DATA, not errors (verifyConn {active:false} discipline) — the status set is closed:…

POST /v1/integrations/connectors/{provider}/device/{flow}/poll

Addresshttps://api.hanzo.ai/v1/integrations/connectors/{provider}/device/{flow}/poll
MethodPOST
Operationpost_integrations_connectors_by_provider_device_by_flow_poll
AuthAuthorization: Bearer $HANZO_API_KEY

Advances a device sign-in. Terminal outcomes are DATA, not errors (verifyConn {active:false} discipline) — the status set is closed: pending|connected|denied|expired. pollSlow collapses to "pending" on the wire; the raised cadence rides interval.

Request

2 fields.

FieldInTypeRequiredDescription
providerpathstringyesProvider is the user-scoped provider's registry id, from the path.
flowpathstringyesFlow is the id deviceStartOut returned.

Response

StatusBodyMeaning
200devicePollOutok

200 body — 11 fields.

FieldInTypeAlwaysDescription
connectorbodyconnView
connector.accountbodystringAccount is the provider's label for the connected account.
connector.connectedAtbodystringConnectedAt is when the connector was last (re)established, RFC 3339 UTC.
connector.expiresAtbodystringExpiresAt is when the access token expires, RFC 3339 UTC; empty for a non-expiring credential.
connector.externalIdbodystringExternalID is the provider's own id for that account.
connector.idbodystringID is provider + ":" + label — what every other connector route addresses.
connector.labelbodystringLabel is the caller's name for this connection ("default", "work").
connector.providerbodystringProvider is the user-scoped provider's registry id.
connector.scopesbodystring[]Scopes are the permissions the credential carries.
intervalbodyintegerInterval is the seconds to wait before the next poll.
statusbodystringStatus is the flow's state.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


Integrations API · All Hanzo APIs · Interactive reference

How is this guide?

On this page