n8n 2.45.3 → 2.46.0

package/dist/public-api/v1/controllers/promotions.public.controller.js

@@ -65,13 +65,14 @@ let PromotionsPublicController = class PromotionsPublicController {
                 : null,
         };
     }
-    async createPromotionConnection(_req, _res, input) {
-        return await (await this.connectionsService()).create(input);
+    async createPromotionEnvironment(_req, _res, input) {
+        return await (await this.environmentsService()).create(input);
     }
-    async getPromotionConnections(_req, _res, query) {
+    async getPromotionEnvironments(_req, _res, query) {
         const { offset, limit } = this.resolvePage(query);
-        const { data, count } = await (await this.connectionsService()).list(offset, limit, {
+        const { data, count } = await (await this.environmentsService()).list(offset, limit, {
             scope: query.scope,
+            direction: query.direction,
             providerId: query.providerId,
         });
         return {
@@ -79,64 +80,49 @@ let PromotionsPublicController = class PromotionsPublicController {
             nextCursor: limit === 0 ? null : (0, pagination_service_1.encodeNextCursor)({ offset, limit, numberOfTotalRecords: count }),
         };
     }
-    async getPromotionConnection(_req, _res, promotionConnectionId) {
-        return await (await this.connectionsService()).findOne(promotionConnectionId);
+    async getPromotionEnvironment(_req, _res, promotionEnvironmentId) {
+        return await (await this.environmentsService()).findOne(promotionEnvironmentId);
     }
-    async updatePromotionConnection(_req, _res, promotionConnectionId, input) {
-        return await (await this.connectionsService()).update(promotionConnectionId, input);
+    async updatePromotionEnvironment(_req, _res, promotionEnvironmentId, input) {
+        return await (await this.environmentsService()).update(promotionEnvironmentId, input);
     }
-    async deletePromotionConnection(_req, _res, promotionConnectionId) {
-        await (await this.connectionsService()).delete(promotionConnectionId);
+    async deletePromotionEnvironment(_req, _res, promotionEnvironmentId) {
+        await (await this.environmentsService()).delete(promotionEnvironmentId);
     }
-    async upsertPromotionApplyConfig(_req, _res, promotionConnectionId, input) {
-        return await (await this.connectionsService()).upsertConfig(promotionConnectionId, {
-            config: { direction: 'apply', settings: input.settings },
-            name: input.name,
-        });
-    }
-    async upsertPromotionPromoteConfig(_req, _res, promotionConnectionId, input) {
-        return await (await this.connectionsService()).upsertConfig(promotionConnectionId, {
-            config: { direction: 'promote', settings: input.settings },
-            name: input.name,
-        });
+    async connectPromotionCheckout(_req, _res, promotionEnvironmentId) {
+        return await (await this.promotionsService()).clone(promotionEnvironmentId);
     }
-    async deletePromotionConfig(_req, _res, promotionConnectionId, direction) {
-        await (await this.connectionsService()).deleteConfig(promotionConnectionId, parseDirection(direction));
+    async disconnectPromotionCheckout(_req, _res, promotionEnvironmentId) {
+        return await (await this.promotionsService()).disconnect(promotionEnvironmentId);
     }
-    async clonePromotionCheckout(_req, _res, promotionConnectionId, direction) {
-        return await (await this.promotionsService()).clone(promotionConnectionId, parseDirection(direction));
+    async getPromotionEnvironmentProjects(_req, _res, promotionEnvironmentId) {
+        return await (await this.environmentsService()).listProjects(promotionEnvironmentId);
     }
-    async disconnectPromotionCheckout(_req, _res, promotionConnectionId, direction) {
-        return await (await this.promotionsService()).disconnect(promotionConnectionId, parseDirection(direction));
-    }
-    async getPromotionConnectionProjects(_req, _res, promotionConnectionId) {
-        return await (await this.connectionsService()).listProjects(promotionConnectionId);
-    }
-    async addProjectToPromotionConnection(req, _res, promotionConnectionId, projectId) {
-        return await (await this.connectionsService()).addProject({
+    async addProjectToPromotionEnvironment(req, _res, promotionEnvironmentId, projectId) {
+        return await (await this.environmentsService()).addProject({
             user: req.user,
-            connectionId: promotionConnectionId,
+            environmentId: promotionEnvironmentId,
             projectId,
         });
     }
-    async removeProjectFromPromotionConnection(req, _res, promotionConnectionId, projectId) {
-        await (await this.connectionsService()).removeProject({
+    async removeProjectFromPromotionEnvironment(req, _res, promotionEnvironmentId, projectId) {
+        await (await this.environmentsService()).removeProject({
             user: req.user,
-            connectionId: promotionConnectionId,
+            environmentId: promotionEnvironmentId,
             projectId,
         });
     }
-    async promotePackage(req, _res, promotionConnectionId, input) {
-        return await (await this.promotionsService()).promote(promotionConnectionId, req.user, {
+    async promotePackage(req, _res, promotionEnvironmentId, input) {
+        return await (await this.promotionsService()).promote(promotionEnvironmentId, req.user, {
             ...input,
             canExportVariableValues: req.tokenGrant?.apiKeyScopes?.includes('variable:list') ?? false,
         });
     }
-    async applyPackage(req, _res, promotionConnectionId, input) {
-        return await (await this.promotionsService()).apply(promotionConnectionId, req.user, input.expectedSource);
+    async applyPackage(req, _res, promotionEnvironmentId, input) {
+        return await (await this.promotionsService()).apply(promotionEnvironmentId, req.user, input.expectedSource);
     }
-    async continueApplyPackage(req, _res, promotionConnectionId, input) {
-        return await (await this.promotionsService()).continueApply(promotionConnectionId, req.user, input);
+    async continueApplyPackage(req, _res, promotionEnvironmentId, input) {
+        return await (await this.promotionsService()).continueApply(promotionEnvironmentId, req.user, input);
     }
     async getPromotionChanges(req, _res, projectId, direction, query) {
         const parsedDirection = parseDirection(direction);
@@ -168,10 +154,10 @@ let PromotionsPublicController = class PromotionsPublicController {
         const { PromotionProvidersService } = await import('../../../modules/promotions.ee/promotion-providers.service.js');
         return di_1.Container.get(PromotionProvidersService);
     }
-    async connectionsService() {
+    async environmentsService() {
         this.assertModuleActive();
-        const { PromotionConnectionsService } = await import('../../../modules/promotions.ee/promotion-connections.service.js');
-        return di_1.Container.get(PromotionConnectionsService);
+        const { PromotionEnvironmentsService } = await import('../../../modules/promotions.ee/promotion-environments.service.js');
+        return di_1.Container.get(PromotionEnvironmentsService);
     }
     async promotionsService() {
         this.assertModuleActive();
@@ -259,7 +245,7 @@ __decorate([
     (0, decorators_1.ApiKeyScope)('gitConnection:update'),
     (0, decorators_1.GlobalScope)('gitConnection:update'),
     (0, decorators_1.ApiSummary)('Update a promotion provider'),
-    (0, decorators_1.ApiDescription)('Renames the provider, and replaces its credentials when `auth` is sent. A Git host provider can also update its base URL. A different API destination requires `auth` in the same request. Changed credentials and host settings are validated before they save. If another request changes the credentials or configuration before this update saves, the update returns 409. Reload the provider and try again. For GitLab, the service uses n8n as the Git transport username. Its auth.username is optional. The service ignores any supplied username. Plain Git token authentication requires auth.username. New credentials apply to every connection that uses this provider. The authentication method cannot change.'),
+    (0, decorators_1.ApiDescription)('Renames the provider, and replaces its credentials when `auth` is sent. A Git host provider can also update its base URL. A different API destination requires `auth` in the same request. Changed credentials and host settings are validated before they save. If another request changes the credentials or configuration before this update saves, the update returns 409. Reload the provider and try again. For GitLab, the service uses n8n as the Git transport username. Its auth.username is optional. The service ignores any supplied username. Plain Git token authentication requires auth.username. New credentials apply to every environment that uses this provider. The authentication method cannot change.'),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.PromotionProviderPublicDto),
     (0, decorators_1.ApiErrorResponse)(404),
@@ -277,7 +263,7 @@ __decorate([
     (0, decorators_1.ApiKeyScope)('gitConnection:delete'),
     (0, decorators_1.GlobalScope)('gitConnection:delete'),
     (0, decorators_1.ApiSummary)('Delete a promotion provider'),
-    (0, decorators_1.ApiDescription)('A provider used by a connection cannot be deleted.'),
+    (0, decorators_1.ApiDescription)('A provider used by an environment cannot be deleted.'),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(204),
     (0, decorators_1.ApiErrorResponse)(404),
@@ -294,7 +280,7 @@ __decorate([
     (0, decorators_1.ApiKeyScope)('gitConnection:discover'),
     (0, decorators_1.GlobalScope)('gitConnection:discover'),
     (0, decorators_1.ApiSummary)('List repositories of a promotion provider'),
-    (0, decorators_1.ApiDescription)('Lists repositories where the GitLab token identity has at least the Developer role. The token also needs Git write scope for promotions. Protected branches can restrict pushes. Use remoteUrl as a connection target. Search matches names and namespaces in similarity order. Unfiltered results use ascending repository ID order. The limit is an upper bound. GitLab returns at most 100 items per page. Follow nextCursor even when a page has fewer items than the requested limit. A saved connection is not required. Invalid credentials return an error, not an empty list. If a response is too large, restart the list with a smaller limit and no cursor.'),
+    (0, decorators_1.ApiDescription)('Lists repositories where the GitLab token identity has at least the Developer role. The token also needs Git write scope for promotions. Protected branches can restrict pushes. Use remoteUrl as an environment remote. Search matches names and namespaces in similarity order. Unfiltered results use ascending repository ID order. The limit is an upper bound. GitLab returns at most 100 items per page. Follow nextCursor even when a page has fewer items than the requested limit. A saved environment is not required. Invalid credentials return an error, not an empty list. If a response is too large, restart the list with a smaller limit and no cursor.'),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.PromotionRepositoryListPublicDto),
     (0, decorators_1.ApiErrorResponse)(404),
@@ -311,7 +297,7 @@ __decorate([
     (0, decorators_1.ApiKeyScope)('gitConnection:discover'),
     (0, decorators_1.GlobalScope)('gitConnection:discover'),
     (0, decorators_1.ApiSummary)('List branches of a promotion repository'),
-    (0, decorators_1.ApiDescription)('Lists branches of the selected GitLab repository and identifies its default branch. Pass the URL-encoded fullPath from repository discovery, or the repositoryPath of a saved GitLab connection, as repositoryId. GitLab project IDs are also accepted, but connections do not store them. Supports branch search and cursor pagination. The limit is an upper bound. GitLab returns at most 100 items per page. Follow nextCursor even when a page has fewer items than the requested limit. A saved connection is not required. Invalid credentials and inaccessible repositories return errors, not empty lists. If a response is too large, restart the list with a smaller limit and no cursor.'),
+    (0, decorators_1.ApiDescription)('Lists branches of the selected GitLab repository and identifies its default branch. Pass the URL-encoded fullPath from repository discovery, or the repositoryPath of a saved GitLab environment, as repositoryId. GitLab project IDs are also accepted, but environments do not store them. Supports branch search and cursor pagination. The limit is an upper bound. GitLab returns at most 100 items per page. Follow nextCursor even when a page has fewer items than the requested limit. A saved environment is not required. Invalid credentials and inaccessible repositories return errors, not empty lists. If a response is too large, restart the list with a smaller limit and no cursor.'),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.PromotionBranchListPublicDto),
     (0, decorators_1.ApiErrorResponse)(404),
@@ -324,253 +310,198 @@ __decorate([
     __metadata("design:returntype", Promise)
 ], PromotionsPublicController.prototype, "getPromotionProviderRepositoryBranches", null);
 __decorate([
-    (0, decorators_1.Post)('/connections'),
+    (0, decorators_1.Post)('/environments'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:create'),
     (0, decorators_1.GlobalScope)('gitConnection:create'),
-    (0, decorators_1.ApiSummary)('Create a promotion connection'),
-    (0, decorators_1.ApiDescription)('Creates a connection on an existing provider, with up to one initial configuration for each direction. A GitLab target URL must belong to the saved provider. The connection stores only the repository path and derives remoteUrl from the current provider base URL. Plain Git connections keep the full remote URL. Only one instance connection can exist.'),
+    (0, decorators_1.ApiSummary)('Create a promotion environment'),
+    (0, decorators_1.ApiDescription)('Creates an environment for one direction on an existing provider. The settings must match the direction. A GitLab remote URL must belong to the saved provider. The environment stores only the repository path and derives remoteUrl from the current provider base URL. Plain Git environments keep the full remote URL. The instance can have one environment for each direction.'),
     (0, decorators_1.ApiTags)(tags),
-    (0, decorators_1.ApiResponse)(201, api_types_1.PromotionConnectionPublicDto),
+    (0, decorators_1.ApiResponse)(201, api_types_1.PromotionEnvironmentPublicDto),
     (0, decorators_1.ApiErrorResponse)(404),
     (0, decorators_1.ApiErrorResponse)(409),
     (0, decorators_1.ApiErrorResponse)(503),
     __param(2, decorators_1.Body),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object, api_types_1.CreatePromotionConnectionDto]),
+    __metadata("design:paramtypes", [Object, Object, api_types_1.CreatePromotionEnvironmentDto]),
     __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "createPromotionConnection", null);
+], PromotionsPublicController.prototype, "createPromotionEnvironment", null);
 __decorate([
-    (0, decorators_1.Get)('/connections'),
+    (0, decorators_1.Get)('/environments'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:list'),
     (0, decorators_1.GlobalScope)('gitConnection:list'),
-    (0, decorators_1.ApiSummary)('List promotion connections'),
-    (0, decorators_1.ApiDescription)('Returns a cursor-paginated list of connections with their configurations. Filter by `scope` for the instance connection, or by `providerId` to see which connections a provider edit affects.'),
+    (0, decorators_1.ApiSummary)('List promotion environments'),
+    (0, decorators_1.ApiDescription)('Returns a cursor-paginated list of environments. Filter by `scope` and `direction` for the instance environments, or by `providerId` to see which environments a provider edit affects.'),
     (0, decorators_1.ApiTags)(tags),
-    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionConnectionListPublicDto),
+    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionEnvironmentListPublicDto),
     (0, decorators_1.ApiErrorResponse)(503),
     __param(2, decorators_1.Query),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object, api_types_1.ListPromotionConnectionsQueryDto]),
+    __metadata("design:paramtypes", [Object, Object, api_types_1.ListPromotionEnvironmentsQueryDto]),
     __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "getPromotionConnections", null);
+], PromotionsPublicController.prototype, "getPromotionEnvironments", null);
 __decorate([
-    (0, decorators_1.Get)('/connections/:promotionConnectionId'),
+    (0, decorators_1.Get)('/environments/:promotionEnvironmentId'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:read'),
     (0, decorators_1.GlobalScope)('gitConnection:read'),
-    (0, decorators_1.ApiSummary)('Retrieve a promotion connection'),
-    (0, decorators_1.ApiDescription)('Returns the connection with its provider summary and its configurations.'),
+    (0, decorators_1.ApiSummary)('Retrieve a promotion environment'),
+    (0, decorators_1.ApiDescription)('Returns the environment with its provider summary and the state of its local checkout.'),
     (0, decorators_1.ApiTags)(tags),
-    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionConnectionPublicDto),
+    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionEnvironmentPublicDto),
     (0, decorators_1.ApiErrorResponse)(404),
     (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
+    __param(2, (0, decorators_1.Param)('promotionEnvironmentId', api_types_1.promotionEnvironmentIdParamSchema)),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, String]),
     __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "getPromotionConnection", null);
+], PromotionsPublicController.prototype, "getPromotionEnvironment", null);
 __decorate([
-    (0, decorators_1.Put)('/connections/:promotionConnectionId'),
+    (0, decorators_1.Put)('/environments/:promotionEnvironmentId'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:update'),
     (0, decorators_1.GlobalScope)('gitConnection:update'),
-    (0, decorators_1.ApiSummary)('Update a promotion connection'),
-    (0, decorators_1.ApiDescription)('Updates the name, target, or provider. A target replaces the whole saved target. GitLab connections store a repository path and derive remoteUrl from the provider. Plain Git connections keep the full remote URL. If the provider changes during a target or provider update, the update returns 409. Reload the connection and try again. Scope cannot change, and configurations have their own routes.'),
+    (0, decorators_1.ApiSummary)('Update a promotion environment'),
+    (0, decorators_1.ApiDescription)('Updates the name, provider, remote, or settings. A remote replaces the whole saved remote, and settings replace the whole saved settings. The settings must match the direction of the environment, so `createBranchOnPromotion` is always required for Promote. GitLab environments store a repository path and derive remoteUrl from the provider. Plain Git environments keep the full remote URL. If the provider changes during the update, the update returns 409. Reload the environment and try again. Direction and scope cannot change.'),
     (0, decorators_1.ApiTags)(tags),
-    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionConnectionPublicDto),
+    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionEnvironmentPublicDto),
     (0, decorators_1.ApiErrorResponse)(404),
     (0, decorators_1.ApiErrorResponse)(409),
     (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
+    __param(2, (0, decorators_1.Param)('promotionEnvironmentId', api_types_1.promotionEnvironmentIdParamSchema)),
     __param(3, decorators_1.Body),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object, String, api_types_1.UpdatePromotionConnectionDto]),
+    __metadata("design:paramtypes", [Object, Object, String, api_types_1.UpdatePromotionEnvironmentDto]),
     __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "updatePromotionConnection", null);
+], PromotionsPublicController.prototype, "updatePromotionEnvironment", null);
 __decorate([
-    (0, decorators_1.Delete)('/connections/:promotionConnectionId'),
+    (0, decorators_1.Delete)('/environments/:promotionEnvironmentId'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:delete'),
     (0, decorators_1.GlobalScope)('gitConnection:delete'),
-    (0, decorators_1.ApiSummary)('Delete a promotion connection'),
-    (0, decorators_1.ApiDescription)('Deletes the connection with its configurations, project links, and local checkouts. Its provider is kept.'),
+    (0, decorators_1.ApiSummary)('Delete a promotion environment'),
+    (0, decorators_1.ApiDescription)('Deletes the environment with its project links and local checkout. Its provider is kept. Nothing in Git changes.'),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(204),
     (0, decorators_1.ApiErrorResponse)(404),
     (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
+    __param(2, (0, decorators_1.Param)('promotionEnvironmentId', api_types_1.promotionEnvironmentIdParamSchema)),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, String]),
     __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "deletePromotionConnection", null);
+], PromotionsPublicController.prototype, "deletePromotionEnvironment", null);
 __decorate([
-    (0, decorators_1.Put)('/connections/:promotionConnectionId/configs/apply'),
-    (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
-    (0, decorators_1.ApiKeyScope)('gitConnection:update'),
-    (0, decorators_1.GlobalScope)('gitConnection:update'),
-    (0, decorators_1.ApiSummary)('Create or replace the Apply configuration'),
-    (0, decorators_1.ApiDescription)('Replaces the whole configuration, so an omitted name resets it to "Apply". Answers 200 whether it created or replaced.'),
-    (0, decorators_1.ApiTags)(tags),
-    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionApplyConfigPublicDto),
-    (0, decorators_1.ApiErrorResponse)(404),
-    (0, decorators_1.ApiErrorResponse)(409),
-    (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
-    __param(3, decorators_1.Body),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object, String, api_types_1.UpsertPromotionApplyConfigDto]),
-    __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "upsertPromotionApplyConfig", null);
-__decorate([
-    (0, decorators_1.Put)('/connections/:promotionConnectionId/configs/promote'),
-    (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
-    (0, decorators_1.ApiKeyScope)('gitConnection:update'),
-    (0, decorators_1.GlobalScope)('gitConnection:update'),
-    (0, decorators_1.ApiSummary)('Create or replace the Promote configuration'),
-    (0, decorators_1.ApiDescription)('Replaces the whole configuration, so an omitted name resets it to "Promote" and `createBranchOnPromotion` is always required. Answers 200 whether it created or replaced.'),
-    (0, decorators_1.ApiTags)(tags),
-    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionPromoteConfigPublicDto),
-    (0, decorators_1.ApiErrorResponse)(404),
-    (0, decorators_1.ApiErrorResponse)(409),
-    (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
-    __param(3, decorators_1.Body),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object, String, api_types_1.UpsertPromotionPromoteConfigDto]),
-    __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "upsertPromotionPromoteConfig", null);
-__decorate([
-    (0, decorators_1.Delete)('/connections/:promotionConnectionId/configs/:direction'),
-    (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
-    (0, decorators_1.ApiKeyScope)('gitConnection:update'),
-    (0, decorators_1.GlobalScope)('gitConnection:update'),
-    (0, decorators_1.ApiSummary)('Remove one direction'),
-    (0, decorators_1.ApiDescription)('Deletes the configuration and its local checkout. Nothing in Git changes.'),
-    (0, decorators_1.ApiTags)(tags),
-    (0, decorators_1.ApiResponse)(204),
-    (0, decorators_1.ApiErrorResponse)(404),
-    (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
-    __param(3, (0, decorators_1.Param)('direction', api_types_1.promotionDirectionParamSchema)),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object, String, String]),
-    __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "deletePromotionConfig", null);
-__decorate([
-    (0, decorators_1.Post)('/connections/:promotionConnectionId/:direction/clone'),
+    (0, decorators_1.Post)('/environments/:promotionEnvironmentId/connect'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:clone'),
     (0, decorators_1.GlobalScope)('gitConnection:clone'),
-    (0, decorators_1.ApiSummary)("Clone one direction's repository"),
-    (0, decorators_1.ApiDescription)('Clones the configured branch into local storage on the instance that handles the request. Safe to call repeatedly. Cloning one direction does not make the other ready.'),
+    (0, decorators_1.ApiSummary)('Connect an environment'),
+    (0, decorators_1.ApiDescription)('Prepares the environment on the instance that handles the request. For a Git provider, this clones the configured branch into local storage. Safe to call repeatedly. Connecting one environment does not make another ready.'),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.PromotionCheckoutPublicDto),
     (0, decorators_1.ApiErrorResponse)(400),
     (0, decorators_1.ApiErrorResponse)(404),
     (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
-    __param(3, (0, decorators_1.Param)('direction', api_types_1.promotionDirectionParamSchema)),
+    __param(2, (0, decorators_1.Param)('promotionEnvironmentId', api_types_1.promotionEnvironmentIdParamSchema)),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object, String, String]),
+    __metadata("design:paramtypes", [Object, Object, String]),
     __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "clonePromotionCheckout", null);
+], PromotionsPublicController.prototype, "connectPromotionCheckout", null);
 __decorate([
-    (0, decorators_1.Post)('/connections/:promotionConnectionId/:direction/disconnect'),
+    (0, decorators_1.Post)('/environments/:promotionEnvironmentId/disconnect'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:clone'),
     (0, decorators_1.GlobalScope)('gitConnection:clone'),
-    (0, decorators_1.ApiSummary)("Remove one direction's local checkout"),
-    (0, decorators_1.ApiDescription)('Removes the local checkout and keeps the configuration, its credentials, and the trusted SSH host keys.'),
+    (0, decorators_1.ApiSummary)("Remove an environment's local checkout"),
+    (0, decorators_1.ApiDescription)('Removes the local checkout and keeps the environment, its credentials, and the trusted SSH host keys.'),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.PromotionCheckoutPublicDto),
     (0, decorators_1.ApiErrorResponse)(404),
     (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
-    __param(3, (0, decorators_1.Param)('direction', api_types_1.promotionDirectionParamSchema)),
+    __param(2, (0, decorators_1.Param)('promotionEnvironmentId', api_types_1.promotionEnvironmentIdParamSchema)),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object, String, String]),
+    __metadata("design:paramtypes", [Object, Object, String]),
     __metadata("design:returntype", Promise)
 ], PromotionsPublicController.prototype, "disconnectPromotionCheckout", null);
 __decorate([
-    (0, decorators_1.Get)('/connections/:promotionConnectionId/projects'),
+    (0, decorators_1.Get)('/environments/:promotionEnvironmentId/projects'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:read'),
     (0, decorators_1.GlobalScope)('gitConnection:read'),
-    (0, decorators_1.ApiSummary)('List projects linked to a promotion connection'),
+    (0, decorators_1.ApiSummary)('List projects linked to a promotion environment'),
     (0, decorators_1.ApiTags)(tags),
-    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionConnectionProjectListPublicDto),
+    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionEnvironmentProjectListPublicDto),
     (0, decorators_1.ApiErrorResponse)(404),
     (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
+    __param(2, (0, decorators_1.Param)('promotionEnvironmentId', api_types_1.promotionEnvironmentIdParamSchema)),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, String]),
     __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "getPromotionConnectionProjects", null);
+], PromotionsPublicController.prototype, "getPromotionEnvironmentProjects", null);
 __decorate([
-    (0, decorators_1.Post)('/connections/:promotionConnectionId/projects/:projectId'),
+    (0, decorators_1.Post)('/environments/:promotionEnvironmentId/projects/:projectId'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:manageProjects'),
     (0, decorators_1.GlobalScope)('gitConnection:manageProjects'),
-    (0, decorators_1.ApiSummary)('Link a project to a promotion connection'),
-    (0, decorators_1.ApiDescription)('Links a team project to a project-scoped connection. A project can be linked to only one connection.'),
+    (0, decorators_1.ApiSummary)('Link a project to a promotion environment'),
+    (0, decorators_1.ApiDescription)('Links a team project to a project-scoped environment. A project can have one environment for each direction. A direction without a project environment uses the instance environment.'),
     (0, decorators_1.ApiTags)(tags),
-    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionConnectionProjectPublicDto),
+    (0, decorators_1.ApiResponse)(200, api_types_1.PromotionEnvironmentProjectPublicDto),
     (0, decorators_1.ApiErrorResponse)(400),
     (0, decorators_1.ApiErrorResponse)(403),
     (0, decorators_1.ApiErrorResponse)(404),
     (0, decorators_1.ApiErrorResponse)(409),
     (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
+    __param(2, (0, decorators_1.Param)('promotionEnvironmentId', api_types_1.promotionEnvironmentIdParamSchema)),
     __param(3, (0, decorators_1.Param)('projectId', api_types_1.projectIdParamSchema)),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, String, String]),
     __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "addProjectToPromotionConnection", null);
+], PromotionsPublicController.prototype, "addProjectToPromotionEnvironment", null);
 __decorate([
-    (0, decorators_1.Delete)('/connections/:promotionConnectionId/projects/:projectId'),
+    (0, decorators_1.Delete)('/environments/:promotionEnvironmentId/projects/:projectId'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:manageProjects'),
     (0, decorators_1.GlobalScope)('gitConnection:manageProjects'),
-    (0, decorators_1.ApiSummary)('Unlink a project from a promotion connection'),
+    (0, decorators_1.ApiSummary)('Unlink a project from a promotion environment'),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(204),
     (0, decorators_1.ApiErrorResponse)(403),
     (0, decorators_1.ApiErrorResponse)(404),
     (0, decorators_1.ApiErrorResponse)(409),
     (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
+    __param(2, (0, decorators_1.Param)('promotionEnvironmentId', api_types_1.promotionEnvironmentIdParamSchema)),
     __param(3, (0, decorators_1.Param)('projectId', api_types_1.projectIdParamSchema)),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, String, String]),
     __metadata("design:returntype", Promise)
-], PromotionsPublicController.prototype, "removeProjectFromPromotionConnection", null);
+], PromotionsPublicController.prototype, "removeProjectFromPromotionEnvironment", null);
 __decorate([
-    (0, decorators_1.Post)('/connections/:promotionConnectionId/promote'),
+    (0, decorators_1.Post)('/environments/:promotionEnvironmentId/promote'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:push'),
     (0, decorators_1.GlobalScope)('gitConnection:push'),
     (0, decorators_1.ApiSummary)('Promote all team projects'),
-    (0, decorators_1.ApiDescription)('Exports every team project, commits it, and pushes to the configured base branch or a new timestamped branch. The response reports the target branch in `git.branchName`. Personal projects are ignored. Requires the Promote direction to be cloned first, and is available on the instance connection only. The API key also needs variable:list when the workflows reference variables.'),
+    (0, decorators_1.ApiDescription)("Exports every team project, commits it, and pushes to the configured base branch or a new timestamped branch. The response reports the target branch in `git.branchName`. Personal projects are ignored. A workflow on the branch that moved to a personal project is refused with 400, because the destination would delete it. A workflow or folder on the branch that moved to another team project is refused with 400 while its old project still exists, because Apply can't move it between projects. Requires a connected Promote environment with instance scope. The API key also needs variable:list when the workflows reference variables."),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.PromotePackageResultDto),
     (0, decorators_1.ApiErrorResponse)(400),
     (0, decorators_1.ApiErrorResponse)(404),
     (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
+    __param(2, (0, decorators_1.Param)('promotionEnvironmentId', api_types_1.promotionEnvironmentIdParamSchema)),
     __param(3, decorators_1.Body),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, String, api_types_1.PromotePackageDto]),
     __metadata("design:returntype", Promise)
 ], PromotionsPublicController.prototype, "promotePackage", null);
 __decorate([
-    (0, decorators_1.Post)('/connections/:promotionConnectionId/apply'),
+    (0, decorators_1.Post)('/environments/:promotionEnvironmentId/apply'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:pull'),
     (0, decorators_1.GlobalScope)('gitConnection:pull'),
     (0, decorators_1.ApiSummary)('Apply a package to the instance'),
-    (0, decorators_1.ApiDescription)('Checks the full package at the configured branch tip. Optionally send expectedSource with the configId, branchName, and full commitSha from the reviewed change preview; status `source-changed` means the branch moved since that review and nothing was imported. Returns status `blocked` before import writes if bindings need setup or if the apply would delete team projects that the package does not hold. Retain configId and git for Continue. Status `applied` includes counts and warnings. Inspect status before reading counts. Existing target variable values, including empty strings, are preserved. Requires a cloned Apply direction on an instance connection. The API key needs the gitConnection:pull scope. The importer checks user write permissions; granular API-key write scopes are not passed to it.'),
+    (0, decorators_1.ApiDescription)('Checks the full package at the configured branch tip. Optionally send expectedSource with the environmentId, branchName, and full commitSha from the reviewed change preview; status `source-changed` means the branch moved since that review and nothing was imported. Returns status `blocked` before import writes if bindings need setup or if the apply would delete team projects that the package does not hold. Retain environmentId and git for Continue. Status `applied` includes counts and warnings. Inspect status before reading counts. Existing target variable values, including empty strings, are preserved. Workflows and folders move within their project to match the branch, and folders take the name on the branch; a workflow or folder that the branch and the instance hold in different projects is refused with 409 before any write. Requires a connected Apply environment with instance scope. The API key needs the gitConnection:pull scope. The importer checks user write permissions; granular API-key write scopes are not passed to it.'),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.ApplyPackageResultDto),
     (0, decorators_1.ApiErrorResponse)(400),
@@ -578,26 +509,26 @@ __decorate([
     (0, decorators_1.ApiErrorResponse)(409),
     (0, decorators_1.ApiErrorResponse)(422),
     (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
+    __param(2, (0, decorators_1.Param)('promotionEnvironmentId', api_types_1.promotionEnvironmentIdParamSchema)),
     __param(3, decorators_1.Body),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, String, api_types_1.ApplyPackageDto]),
     __metadata("design:returntype", Promise)
 ], PromotionsPublicController.prototype, "applyPackage", null);
 __decorate([
-    (0, decorators_1.Post)('/connections/:promotionConnectionId/apply/continue'),
+    (0, decorators_1.Post)('/environments/:promotionEnvironmentId/apply/continue'),
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)('gitConnection:pull'),
     (0, decorators_1.GlobalScope)('gitConnection:pull'),
     (0, decorators_1.ApiSummary)('Continue Apply after binding setup'),
-    (0, decorators_1.ApiDescription)('Rechecks the configured source and current target bindings. Send expectedSource with the configId, branchName, and full commitSha from the reviewed Apply result. Send `confirmDestructiveChanges: true` to also apply destructive data table changes and delete the reported team projects. Status `source-changed` requires a new Apply review. Status `blocked` returns fresh binding details without import writes. Status `applied` includes counts and warnings. Inspect status before reading counts. Existing target variable values are preserved. Requires the same cloned instance connection and permissions as Apply. The importer checks user write permissions; granular API-key write scopes are not passed to it. No server session or exactly-once guarantee is provided.'),
+    (0, decorators_1.ApiDescription)('Rechecks the configured source and current target bindings. Send expectedSource with the environmentId, branchName, and full commitSha from the reviewed Apply result. Send `confirmDestructiveChanges: true` to also apply destructive data table changes and delete the reported team projects. Status `source-changed` requires a new Apply review. Status `blocked` returns fresh binding details without import writes. Status `applied` includes counts and warnings. Inspect status before reading counts. Existing target variable values are preserved. Requires the same connected instance environment and permissions as Apply. The importer checks user write permissions; granular API-key write scopes are not passed to it. No server session or exactly-once guarantee is provided.'),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.ApplyPackageResultDto),
     (0, decorators_1.ApiErrorResponse)(404),
     (0, decorators_1.ApiErrorResponse)(409),
     (0, decorators_1.ApiErrorResponse)(422),
     (0, decorators_1.ApiErrorResponse)(503),
-    __param(2, (0, decorators_1.Param)('promotionConnectionId', api_types_1.promotionConnectionIdParamSchema)),
+    __param(2, (0, decorators_1.Param)('promotionEnvironmentId', api_types_1.promotionEnvironmentIdParamSchema)),
     __param(3, decorators_1.Body),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, String, api_types_1.ContinueApplyPackageDto]),
@@ -608,7 +539,7 @@ __decorate([
     (0, decorators_1.Licensed)(constants_1.LICENSE_FEATURES.GIT_CONNECTIONS),
     (0, decorators_1.ApiKeyScope)({ anyOf: ['gitConnection:push', 'gitConnection:pull'] }),
     (0, decorators_1.ApiSummary)('List the changes of a project in one direction'),
-    (0, decorators_1.ApiDescription)('Compares a team project on this instance with the branch of its promotion configuration and lists the workflows that differ. For `promote` the rows are what a promotion sends to the branch, and the key needs the gitConnection:push scope. For `apply` the rows are what applying the branch changes on this instance, and the key needs the gitConnection:pull scope. `commitSha` is the commit the rows were read from. Requires the direction to be cloned first.'),
+    (0, decorators_1.ApiDescription)('Compares a team project on this instance with the branch of its promotion environment for that direction and lists the workflows that differ. For `promote` the rows are what a promotion sends to the branch, and the key needs the gitConnection:push scope. A `deleted` or `new` promote row can be a workflow that moved between projects; promoting it is refused until it moves back. For `apply` the rows are what applying the branch changes on this instance, and the key needs the gitConnection:pull scope. `commitSha` is the commit the rows were read from. Requires the environment to be connected first.'),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.PromotionChangesDto),
     (0, decorators_1.ApiErrorResponse)(400),
@@ -627,7 +558,7 @@ __decorate([
     (0, decorators_1.ApiKeyScope)('gitConnection:push'),
     (0, decorators_1.GlobalScope)('gitConnection:push'),
     (0, decorators_1.ApiSummary)("Promote a selection of a project's workflows"),
-    (0, decorators_1.ApiDescription)("Promotes a chosen set of a team project's workflows to the Promote branch of the project's promotion configuration. Send workflow ids only; the server reads each one now, so the push carries the current state. Live and archived workflows the project owns are exported, so an archived id stays on the branch as archived; an id the project no longer owns (its workflow is gone, or moved to another project) leaves the branch, matching the project's change list. A deletion the branch does not hold under this project rejects the whole request before any write. Requires the Promote direction to be cloned first, and a promotion connection to resolve for the project (its own connection, otherwise the instance connection). The API key also needs variable:list when the workflows reference variables."),
+    (0, decorators_1.ApiDescription)("Promotes a chosen set of a team project's workflows to the branch of the project's Promote environment. Send workflow ids only; the server reads each one now, so the push carries the current state. Live and archived workflows the project owns are exported, so an archived id stays on the branch as archived; an id whose workflow is gone from the instance leaves the branch, matching the project's change list. A workflow that moved into or out of the project since the branch was written is refused with 400; move it back first. A deletion the branch does not hold under this project rejects the whole request before any write. Requires a Promote environment to resolve for the project (its own Promote environment, otherwise the instance Promote environment), and requires it to be connected first. The API key also needs variable:list when the workflows reference variables."),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.PromotePackageResultDto),
     (0, decorators_1.ApiErrorResponse)(400),
@@ -645,7 +576,7 @@ __decorate([
     (0, decorators_1.ApiKeyScope)('gitConnection:pull'),
     (0, decorators_1.GlobalScope)('gitConnection:pull'),
     (0, decorators_1.ApiSummary)("Apply a selection of a project's workflows"),
-    (0, decorators_1.ApiDescription)("Applies selected workflow changes from the project's Apply branch. Send the selected change-list IDs in workflowIds. The server imports IDs present on the branch for this project. It removes instance workflows owned by this project when their IDs are absent from the branch. Duplicate or invalid IDs reject the whole request. Unselected content stays unchanged. Optionally send expectedSource with the configId, branchName, and full commitSha from the reviewed change preview. Status `source-changed` means the source changed since that review and nothing was imported. Status `blocked` returns binding details before import writes when the selection needs binding setup. Retain configId and git for Continue. Status `applied` includes counts and warnings. Inspect status before reading counts. Requires a cloned Apply direction for the project's resolved promotion connection. The API key needs the gitConnection:pull scope. The importer checks user write permissions."),
+    (0, decorators_1.ApiDescription)("Applies selected workflow changes from the project's Apply branch. Send the selected change-list IDs in workflowIds. The server imports IDs present on the branch for this project. It removes instance workflows owned by this project when their IDs are absent from the branch. Duplicate or invalid IDs reject the whole request. Unselected content stays unchanged. A selected workflow moves within the project to match the branch, together with the folders that hold it, and those folders take the name on the branch; other folders stay as they are. A selected workflow, or a folder the branch holds in this project, that the branch and the instance hold in different projects is refused with 409 before any write. Optionally send expectedSource with the environmentId, branchName, and full commitSha from the reviewed change preview. Status `source-changed` means the source changed since that review and nothing was imported. Status `blocked` returns binding details before import writes when the selection needs binding setup. Retain environmentId and git for Continue. Status `applied` includes counts and warnings. Inspect status before reading counts. Requires a connected Apply environment for the project: its own Apply environment, otherwise the instance Apply environment. The API key needs the gitConnection:pull scope. The importer checks user write permissions."),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.ApplyPackageResultDto),
     (0, decorators_1.ApiErrorResponse)(400),
@@ -665,7 +596,7 @@ __decorate([
     (0, decorators_1.ApiKeyScope)('gitConnection:pull'),
     (0, decorators_1.GlobalScope)('gitConnection:pull'),
     (0, decorators_1.ApiSummary)('Continue applying a selection after binding setup'),
-    (0, decorators_1.ApiDescription)("Rechecks the project's Apply source and the current bindings for the selection. Resend the full selection in workflowIds. Send the required expectedSource with the configId, branchName, and full commitSha from the reviewed Apply result. Send `confirmDestructiveChanges: true` to also apply destructive data table changes. The server does not keep a session. Status `source-changed` requires a new Apply review. Status `blocked` returns fresh binding details before import writes. Status `applied` includes counts and warnings. Inspect status before reading counts. Unselected content stays unchanged. Requires the same cloned Apply direction and permissions as the initial selection apply. The API key needs the gitConnection:pull scope. The importer checks user write permissions."),
+    (0, decorators_1.ApiDescription)("Rechecks the project's Apply source and the current bindings for the selection. Resend the full selection in workflowIds. Send the required expectedSource with the environmentId, branchName, and full commitSha from the reviewed Apply result. Send `confirmDestructiveChanges: true` to also apply destructive data table changes. The server does not keep a session. Status `source-changed` requires a new Apply review. Status `blocked` returns fresh binding details before import writes. Status `applied` includes counts and warnings. Inspect status before reading counts. Unselected content stays unchanged. Requires the same connected Apply environment and permissions as the initial selection apply. The API key needs the gitConnection:pull scope. The importer checks user write permissions."),
     (0, decorators_1.ApiTags)(tags),
     (0, decorators_1.ApiResponse)(200, api_types_1.ApplyPackageResultDto),
     (0, decorators_1.ApiErrorResponse)(404),