Start device flow (with appIdentifier)
GET {{authPath}}/{{envID}}/device/{{appIdentifier}}
The GET /{{envID}}/device/{{appIdentifier}}
operation returns a 302
message with a flowID
embedded in the Location
header for applications that specify a device auth grant. The Location
header looks like this:
https://apps.pingone.com/934dba65-d14e-413e-21b4-ee699a5cea21/signon/?flowId=032150b5-44a3-4b2f-8b3b-126aabb3e89f
The endpoint's {{appIdentifier}}
value is set on the application configuration. The ID can be the PingOne application ID (clientId
) or the device path ID (devicePathId
), which is configured on the application and is used only with the /device
endpoint.
This request supports the user_code
query parameter. If the request URL includes the user_code
query parameter, GET /{{envID}}/device/{{appIdentifier}}?user_code={{userCode}}
, the sign-on flow pre-populates the activation input field with the user_code
value returned by the POST {{authPath}}/{{envID}}/as/device_authorization
request.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
user_code | string | Pre-populates the activation input field with the user_code value returned by the POST {{authPath}}/{{envID}}/as/device_authorization request. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Cookie | string |