Skip to main content

configuration

Overview

Nameconfiguration
TypeResource
Idvercel.integrations.configuration

Fields

NameDatatypeDescription
idstringThe unique identifier of the configuration
_completedAtnumberA timestamp that tells you when the configuration was installed successfully
_createdAtnumberA timestamp that tells you when the configuration was created
_deletedAtnumberA timestamp that tells you when the configuration was updated.
_disabledAtnumberA 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.
_disabledReasonstring
_idstringThe unique identifier of the configuration
_integrationIdstringThe unique identifier of the app the configuration was created for
_ownerIdstringThe user or team ID that owns the configuration
_projectsarrayWhen 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.
_removedLogDrainsAtnumber
_removedProjectEnvsAtnumber
_removedTokensAtnumber
_removedWebhooksAtnumber
_scopesarrayThe resources that are allowed to be accessed by the configuration.
_scopesQueuearray
_slugstringThe slug of the integration the configuration is created for.
_sourcestringSource defines where the configuration was installed from. It is used to analyze user engagement for integration installations in product metrics.
_teamIdstringWhen the configuration was created for a team, this will show the ID of the team.
_typestring
_updatedAtnumberA timestamp that tells you when the configuration was updated.
_userIdstringThe ID of the user that created the configuration.
canConfigureOpenTelemetryboolean
completedAtnumberA timestamp that tells you when the configuration was installed successfully
createdAtnumberA timestamp that tells you when the configuration was created
deletedAtnumberA timestamp that tells you when the configuration was updated.
disabledAtnumberA 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.
disabledReasonstring
integrationIdstringThe unique identifier of the app the configuration was created for
ownerIdstringThe user or team ID that owns the configuration
projectSelectionstringA string representing the permission for projects. Possible values are all or selected.
projectsarrayWhen 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.
removedLogDrainsAtnumber
removedProjectEnvsAtnumber
removedTokensAtnumber
removedWebhooksAtnumber
scopesarrayThe resources that are allowed to be accessed by the configuration.
scopesQueuearray
slugstringThe slug of the integration the configuration is created for.
sourcestringSource defines where the configuration was installed from. It is used to analyze user engagement for integration installations in product metrics.
teamIdstringWhen the configuration was created for a team, this will show the ID of the team.
typestring
updatedAtnumberA timestamp that tells you when the configuration was updated.
userIdstringThe ID of the user that created the configuration.

Methods

NameAccessible byRequired ParamsDescription
get_configurationSELECTid, teamIdAllows 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.
get_configurationsSELECTteamId, viewAllows 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.
delete_configurationDELETEid, teamIdAllows to remove the configuration with the id provided in the parameters. The configuration and all of its resources will be removed. This includes Webhooks, LogDrains and Project Env variables.