IntegrationResponseDto

May 13, 2026 ยท View on GitHub

Fields

FieldTypeRequiredDescription
idOptional<String>:heavy_minus_sign:The unique identifier of the integration record in the database. This is automatically generated.
environmentIdString:heavy_check_mark:The unique identifier for the environment associated with this integration. This links to the Environment collection.
organizationIdString:heavy_check_mark:The unique identifier for the organization that owns this integration. This links to the Organization collection.
nameString:heavy_check_mark:The name of the integration, which is used to identify it in the user interface.
identifierString:heavy_check_mark:A unique string identifier for the integration, often used for API calls or internal references.
providerIdString:heavy_check_mark:The identifier for the provider of the integration (e.g., "mailgun", "twilio").
channelOptional<IntegrationResponseDtoChannel>:heavy_minus_sign:The channel type for the integration, which defines how it communicates (e.g., email, SMS). Not set for agent-kind integrations.
kindOptional<IntegrationResponseDtoKind>:heavy_minus_sign:Distinguishes delivery integrations from agent-runtime integrations. Defaults to "delivery". Agent integrations do not have a channel.
credentialsOptional<CredentialsDto>:heavy_minus_sign:The decrypted credentials required for the integration to function (e.g. provider API keys, signing secrets). Only returned to dashboard/session-token callers; API-key authenticated callers receive the integration metadata without this field to avoid amplifying API-key leaks into provider-credential leaks.
configurationsOptional<ConfigurationsDto>:heavy_minus_sign:The configurations required for enabling the additional configurations of the integration.
activeboolean:heavy_check_mark:Indicates whether the integration is currently active. An active integration will process events and messages.
deletedboolean:heavy_check_mark:Indicates whether the integration has been marked as deleted (soft delete).
deletedAtOptional<String>:heavy_minus_sign:The timestamp indicating when the integration was deleted. This is set when the integration is soft deleted.
deletedByOptional<String>:heavy_minus_sign:The identifier of the user who performed the deletion of this integration. Useful for audit trails.
primaryboolean:heavy_check_mark:Indicates whether this integration is marked as primary. A primary integration is often the default choice for processing.
conditionsList<StepFilterDto>:heavy_minus_sign:An array of conditions associated with the integration that may influence its behavior or processing logic.