integrations

Get configurations for the authenticated user or team

Changed on

Allows to retrieve all configurations for an authenticated integration. When the project view is used, configurations generated for the authorization flow will be filtered out of the results.

get/v1/integrations/configurations

Request

  • Base URL
    https://api.vercel.com
  • URL
    https://api.vercel.com/v1/integrations/configurations
  • Auth
    HTTP bearer

Query parameters

view'account' | 'project' required
installationType'marketplace' | 'external' | 'provisioning'
integrationIdOrSlugstring

ID of the integration

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Response

The list of configurations for the authenticated user

OR

Example response

[
  {
    "completedAt": 1558531915505,
    "createdAt": 1558531915505,
    "deletedAt": 1558531915505,
    "deleteRequestedAt": 1558531915505,
    "disabledAt": 1558531915505,
    "id": "icfg_3bwCLgxL8qt5kjRLcv2Dit7F",
    "integrationId": "oac_xzpVzcUOgcB1nrVlirtKhbWV",
    "ownerId": "kr1PsOIzqEL5Xg6M4VZcZosf",
    "projects": [
      "prj_xQxbutw1HpL6HLYPAzt5h75m8NjO"
    ],
    "scopes": [
      "read:project",
      "read-write:log-drain"
    ],
    "slug": "slack",
    "source": "marketplace",
    "teamId": "team_nLlpyC6RE1qxydlFKbrxDlud",
    "updatedAt": 1558531915505,
    "userId": "kr1PsOIzqEL5Xg6M4VZcZosf"
  }
]

Changes

    • breaking

      added subschema #1 subschema #2 to the response body oneOf list for the response status

    • info

      removed subschema #1 subschema #2 from the response body oneOf list for the response status

    • info

      added the non-success response with the status