Start an Observe authtoken creation flow

This endpoint starts an authorization flow that lets an Observe user generate an authorization token to use for external tools and scripts. This token will have the same powers as the user authorizing, and can be passed in the Authorization: Bearer <customerid> <apitoken> header of requqests. This endpoint will return with a URL that the user should visit in a web browser to allow the token creation; that URL will lead to a page that requires the user to be logged in (through whatever password or SSO mechanism the user normally uses.) The response from this endpoint also includes a "serverToken" field, which is a token that can be used to poll the tenant for the status of the token creation, and if successful, will return the issued access key.

Essentially, this endpoint implements the Oauth "device" authorization flow.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

The credentials to authorize as.

string
required

The email address of the user to mint credentials for.

string
required

A token generated by the client to identify this particular request. We recommend a random alphanumeric string of length 24 characters or more to avoid collisions. There is no power or security imbued into this token, other than to tell different simultaneous authorization requests for the same user apart.

string
required

The identifier of the particular integration making this request. Integration should be configured in the Observe back-end, but there is currently no UI for this, so you can use the ID of the Observe command-line tool observe-tool-abdaf0.

Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json