# List Connection Fields

See what connecting an app takes: each sign-in method, the app's default first, and the fields its form asks for. A method with requiresBrowser false is created with Create Connection; one with requiresBrowser true (OAuth) needs a person to sign in through Create Connect Link.

`GET https://connect.mindcloud.co/v2/connections/fields`

Permissions: `credential:view`.

## Parameters

### Headers

- `X-Company-Id` (string): Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. A key can also act in its child organizations, and, with "Use this key across all of your organizations" on, in every organization its creator can open in the app. List them with GET /v2/companies. Every response's X-Company-Id header names the organization it acted in. See [Organizations](https://mindcloud.co/docs/api/rest/introduction/organizations).

### Query

- `app` (string, required): Required. An app id or slug, from List Universal Apps.
  Required. The app, by its id or slug, from List Universal Apps.

## Example request

```bash
curl --request GET \
  --url 'https://connect.mindcloud.co/v2/connections/fields?app=openai' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN'
```

## Response fields

- `id` (string): The sign-in method id: authenticationId in Create Connection and Create Connect Link.
- `type` (string): How it signs in: oAuth2, oAuth1, apiKey, basic, custom, ftp or none.
- `name` (string): The method's name, as the app's connection form shows it.
- `requiresBrowser` (boolean): True when a person signs in at the provider in a browser (OAuth): use Create Connect Link. False when the fields are typed in: use Create Connection.
- `fields` (array of objects): What the connection form asks for, in its order. Send their values by key in credentials. Empty for a method that asks for nothing typed in.
  - `key` (string): The key to send the value under in credentials.
  - `label` (string): The label the form shows.
  - `type` (string): The kind of value.
    Allowed values:
      - `string`: Text.
      - `boolean`: true or false.
      - `number`: A number.
      - `date`: A date, as ISO 8601 text.
      - `list`: One of options, or an array of them.
  - `required` (boolean): True when a new connection needs it.
  - `isSecret` (boolean): True for a secret (an API key, a password, a token): the form hides it, and no MindCloud response ever answers it.
  - `description` (string): The app's help text for it.
  - `options` (array): The values it accepts, when it is a choice.
    - `value` (string): The value to send.
    - `label` (string): What the form shows for it.