Skip to content

Interface: SetEndpoint

core.SetEndpoint

Configuration for a step that will run after the user sets up a new account that fetches a set of endpoint domains that the user has access to and prompts the user to select the one that should apply to this account.

The selected endpoint domain is bound to this account and used as the root domain of HTTP requests made by the fetcher. (Whenever an endpoint is associated with an account, it is available at execution time as context.endpoint, and alternatively can make fetcher requests using relative URLs and the fetcher will apply the endpoint to the URL automatically.)

As an example, we use this in the Jira pack to set up the Jira instance endpoint to use with the user's account. A Jira account may have access to multiple Jira instances; after authorizing the user account, this step makes an API call to fetch all of the Jira instances that the user has access to, which are rendered as options for the user, and the endpoint domain of the select option (of the form .atlassian.net) is stored along with this account.

Properties

description

description: string

A description to render to the user describing the selection they should be making, for example, "Choose an instance to use with this account".

Defined in

types.ts:190


getOptions

Optional getOptions: MetadataFormula

The formula that fetches endpoints for the user to select from. Like any MetadataFormula, this formula should return an array of options, either strings or objects of the form {display: '<display name>', value: '<endpoint>'} if wanting to render a display label to the user rather than rendering the underlying value directly.

Defined in

types.ts:198


getOptionsFormula

Optional getOptionsFormula: MetadataFormula

Deprecated

Use getOptions

Defined in

types.ts:200


name

name: string

An arbitrary name for this step, to distinguish from other steps of the same type (exceedingly rare).

Defined in

types.ts:185


type

type: SetEndpoint

Identifies this as a SetEndpoint step.

Defined in

types.ts:180