Get

Overview

Performs an HTTP GET request, returning the result of this request and the response headers. On input, takes a required URL input and optional auth, header, and query inputs. Each optional input can either be modeled by a singular object-typed input or by multiple keys with the appropriate group attribute. On output, returns an object with two keys, headers and output. The output key contains the response body, and the headers key contains the response header. More detailed information can be accessed about these by using multiple keys with the appropriate grouping. NOTE:

  • If you are looking to submit data to a URL and then get data back, use the POST card instead as GET does not allow for body inputs.

  • The 'Content-Type' header is implicitly set to 'application/json' for all HTTP functions (excluding Raw Request).

Input Fields

  • URL(text): required URL for HTTP GET request

  • headers (Section): If required for the HTTP GET request to the specified URL, create headers by specifying an input name equal to the key (e.g. "Authentication") and then specifying a value for the input. Information on headers required for your HTTP GET request should be specified by the provider of the URL.

  • query (Section): If necessary for the HTTP GET request to the specified URL, create query string parameters by specifying an input name equal to the key (e.g. "page") and then specifying a value for the input (e.g. "1"). Information on the query string parameters available for your HTTP GET request should be specified by the provider of the URL.

Output Fields

  • statusCode (Number): the status (200, 404, etc) associated with the GET request

  • body(Section): using syntax similar to the outputs for Get Multiple, specify optional paths that allow retrieving values from the response body directly on the HTTP GET action without using additional functions

  • headers(Section): specify optional keys that allow retrieving values from the response headers directly on the HTTP GET action without using additional functions

See Also

Functions in Workflows

About the elements of Okta Workflows