Skip to content
Docs

Retrieve an integration configuration

GET/__remote/api.vercel.com/v1/integrations/configuration/{id}
Allows to retrieve a the configuration with the provided id in case it exists. The authenticated user or team must be the owner of the config in order to access it.
Request
import { Edgenivo } from "@vercel/sdk";


const vercel = new Edgenivo({
  bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});


async function run() {
  const result = await vercel.integrations.getConfiguration({
    id: "icfg_cuwj0AdCdH3BwWT4LPijCC7t",
    teamId: "team_1a2b3c4d5e6f7g8h9i0j1k2l",
    slug: "my-team-url-slug",
  });


  console.log(result);
}


run();
Response
{
  "acceptedPoliciesInheritedFromInstallationId": "example_id",
  "canConfigureOpenTelemetry": "false",
  "completedAt": "1558531915505",
  "createdAt": "1558531915505",
  "customerDeleteRequestedAt": "123",
  "deletedAt": "1558531915505",
  "deleteRequestedAt": "1558531915505",
  "disabledAt": "1558531915505",
  "disabledReason": "account-plan-downgrade",
  "externalId": "example_id",
  "id": "icfg_3bwCLgxL8qt5kjRLcv2Dit7F",
  "installationType": "external",
  "integrationId": "oac_xzpVzcUOgcB1nrVlirtKhbWV",
  "notification": {
    "href": "string",
    "level": "error",
    "message": "string",
    "title": "string"
  },
  "ownerId": "kr1PsOIzqEL5Xg6M4VZcZosf",
  "projects": [],
  "projectSelection": "all",
  "scopes": [],
  "slug": "slack",
  "source": "marketplace",
  "status": "error",
  "teamId": "team_nLlpyC6RE1qxydlFKbrxDlud",
  "transferRequest": {
    "approvedAt": "123",
    "approvedBy": "string",
    "authorizationId": "example_id",
    "billingPlan": {
      "description": "string",
      "id": "icfg_1234567890",
      "name": "Example Name",
      "paymentMethodRequired": "false",
      "preauthorizationAmount": "123",
      "scope": "installation",
      "type": "prepayment"
    },
    "createdAt": "123",
    "discardedAt": "123",
    "discardedBy": "string",
    "expiresAt": "123",
    "kind": "transfer-to-marketplace",
    "metadata": "value",
    "requester": {
      "email": "user@example.com",
      "name": "Example Name"
    },
    "requestId": "example_id",
    "transferId": "example_id"
  },
  "type": "integration-configuration",
  "updatedAt": "1558531915505",
  "userId": "kr1PsOIzqEL5Xg6M4VZcZosf"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

idstringRequired
ID of the configuration to check

Query parameters

teamIdstringOptional
The Team identifier to perform the request on behalf of.
slugstringOptional
The Team slug to perform the request on behalf of.

Response

200The configuration with the provided id
acceptedPoliciesInheritedFromInstallationIdstringOptional
Historical parent installation from which acceptedPolicies were inherited. This is immutable provenance, not current authorization or relationship truth.
canConfigureOpenTelemetrybooleanOptional
completedAtnumberOptional
A timestamp that tells you when the configuration was installed successfully
createdAtnumberRequired
A timestamp that tells you when the configuration was created
customerDeleteRequestedAtnumberOptional
Record when the customer initited deletion, independent of whether deleteRequestedAt gets set.
deletedAtnumberOptional
A timestamp that tells you when the configuration was deleted.
deleteRequestedAtnumberOptional
A timestamp that tells you when the configuration deletion has been started for cases when the deletion needs to be settled/approved by partners, such as when marketplace invoices have been paid.
disabledAtnumberOptional
A timestamp that tells you when the configuration was disabled. Note: Configurations can be disabled when the associated user loses access to a team. They do not function during this time until the configuration is 'transferred', meaning the associated user is changed to one with access to the team.
disabledReasonstringOptional
externalIdstringOptional
An external identifier defined by the integration vendor.
idstringRequired
The unique identifier of the configuration
installationTypestringOptional
Defines the installation type. - 'external' integrations are installed via the existing integrations flow - 'marketplace' integrations are natively installed: - when accepting the TOS of a partner during the store creation process - if undefined, assume 'external'
integrationIdstringRequired
The unique identifier of the app the configuration was created for
notificationobjectRequired
ownerIdstringRequired
The user or team ID that owns the configuration
projectsarrayOptional
When a configuration is limited to access certain projects, this will contain each of the project ID it is allowed to access. If it is not defined, the configuration has full access.
projectSelectionstringRequired
A string representing the permission for projects. Possible values are all or selected.
scopesarrayRequired
The resources that are allowed to be accessed by the configuration.
slugstringRequired
The slug of the integration the configuration is created for.
sourcestringOptional
Source defines where the configuration was installed from. It is used to analyze user engagement for integration installations in product metrics.
statusstringOptional
The configuration status. Optional. If not defined, assume 'ready'.
teamIdstringOptional
When the configuration was created for a team, this will show the ID of the team.
transferRequestobjectRequired2 variants
typestringRequired
updatedAtnumberRequired
A timestamp that tells you when the configuration was updated.
userIdstringRequired
The ID of the user that created the configuration.

Errors

400One of the provided values in the request query is invalid.
401The request is not authorized.
403You do not have permission to access this resource.
404The configuration was not found
410Error