> ## Documentation Index > Fetch the complete documentation index at: https://integration.delogue.com/llms.txt > Use this file to discover all available pages before exploring further. # Cancel the organization's migration request > Withdraws a migration request that Customer Success has not approved yet, returning the organization to status=legacy -- fully unblocked on the legacy platform -- and freeing it to request a new run time whenever it likes. Available from status=requested only: approval commits a night's migration capacity to the slot, so from status=csApproved onwards this is refused with 422 unprocessable_error.not_cancellable and withdrawing becomes a Customer Success decision. Returns the organization's refreshed migration status, whose requestId is null because the cancelled request is retired. Authorized server-side for the organization's own admins only. ## OpenAPI ````yaml https://service.my.delogue.com/openapi/external.json delete /api/organizations/{organizationId}/migration-requests/{requestId} openapi: 3.1.1 info: title: Delogue External API - (Production) description: Integration endpoints for Delogue API version: 1.0.0 servers: - url: / description: The Delogue environment serving this document. - url: https://{host} description: Per-customer Delogue API host. variables: host: default: service.my.delogue.com description: >- The API host for your Delogue environment, e.g. service..delogue.com. security: [] tags: - name: Barcodes - name: Brands - name: CareInstructionIcons - name: CareInstructionLayers - name: CareInstructionMaterials - name: CareInstructions - name: Color Groups - name: Colors - name: ComplianceCategories - name: ComplianceCustomFields - name: Facilities - name: Groups - name: ItemCategories - name: Items - name: MeasurementCharts - name: MigrationApproval - name: MigrationVerification - name: OrganizationMigration - name: Organizations - name: SampleRequests - name: SampleTypes - name: Seasons - name: SizeRanges - name: Style Prices - name: StyleCareInstructions - name: StyleCategories - name: StyleColors - name: StyleContacts - name: StyleCustomFields - name: StyleFiles - name: StyleItems - name: StyleRelations - name: Styles - name: StyleSkus - name: StyleSupplierFacilities - name: SubSuppliers - name: Suppliers paths: /api/organizations/{organizationId}/migration-requests/{requestId}: delete: tags: - OrganizationMigration summary: Cancel the organization's migration request description: >- Withdraws a migration request that Customer Success has not approved yet, returning the organization to status=legacy -- fully unblocked on the legacy platform -- and freeing it to request a new run time whenever it likes. Available from status=requested only: approval commits a night's migration capacity to the slot, so from status=csApproved onwards this is refused with 422 unprocessable_error.not_cancellable and withdrawing becomes a Customer Success decision. Returns the organization's refreshed migration status, whose requestId is null because the cancelled request is retired. Authorized server-side for the organization's own admins only. operationId: OrganizationMigration_CancelMigrationRequest parameters: - name: organizationId in: path description: >- Identifier of the organization whose migration request is being cancelled. required: true schema: pattern: ^-?(?:0|[1-9]\d*)$ type: integer format: int32 - name: requestId in: path description: Identifier of the migration request to cancel. required: true schema: type: integer format: int64 responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/ApiResponseOfOrganizationMigrationStatusDto '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '401': description: Unauthorized content: application/problem+json: schema: $ref: '#/components/schemas/ApiErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '500': description: Internal Server Error content: application/problem+json: schema: $ref: '#/components/schemas/ApiErrorResponse' security: - {} components: schemas: ApiResponseOfOrganizationMigrationStatusDto: required: - status - code - data type: object properties: status: $ref: '#/components/schemas/ApiResponseStatus' description: >- The coarse outcome of the request, indicating whether it succeeded or failed. code: type: string description: >- The specific machine-readable outcome code, such as ok on success or the most specific error code on failure. Always lowercase on the wire. data: oneOf: - type: 'null' - $ref: '#/components/schemas/OrganizationMigrationStatusDto' description: >- The response payload, either a single object for a by-id read or an array for a bulk operation. Omitted from the body when there is no value. description: >- The response payload, either a single object for a by-id read or an array for a bulk operation. Omitted from the body when there is no value. additionalProperties: false ApiErrorResponse: type: object properties: status: $ref: '#/components/schemas/ApiResponseStatus' description: >- The coarse outcome of the request, indicating whether it succeeded or failed. code: type: string description: >- The specific machine-readable outcome code, such as ok on success or the most specific error code on failure. Always lowercase on the wire. error: $ref: '#/components/schemas/ErrorWrapper' description: >- The error payload, present instead of data on a failed response. It wraps the list of detail rows describing what went wrong. additionalProperties: false ApiResponseStatus: enum: - success - error type: string description: >- The coarse outcome of the request, indicating whether it succeeded or failed. OrganizationMigrationStatusDto: type: object properties: organizationId: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string description: >- Identifier of the organization whose migration status this describes. format: int32 status: $ref: '#/components/schemas/MigrationRequestStatus' description: >- The current lifecycle status of the organization's migration, in the shared migration status vocabulary. requestId: type: - 'null' - integer description: >- Identifier of the current migration request, or null when none has ever been submitted. format: int64 requestedRunTimeUtc: type: - 'null' - string description: >- The UTC run time the organization requested, or null when none has been requested. format: date-time scheduledRunTimeUtc: type: - 'null' - string description: >- The UTC slot the migration job was actually armed for, or null before it has been scheduled. format: date-time csApprovedOnUtc: type: - 'null' - string description: >- UTC time Customer Success approved the request, or null when it has not been approved. format: date-time failureReason: type: - 'null' - string description: >- The recorded reason the run stopped, present when the migration has failed. rejectionFeedback: type: - 'null' - string description: >- The organization's own feedback when it rejected its migrated data, or null when it did not. properties: type: array items: type: string description: >- Zero or more flags that are currently true of the request, such as needs-reschedule when the requested time has passed while still awaiting approval, as an additive string array rather than one boolean per flag. additionalProperties: false description: >- The response payload, either a single object for a by-id read or an array for a bulk operation. Omitted from the body when there is no value. ErrorWrapper: type: object properties: details: type: array items: $ref: '#/components/schemas/ErrorDetailDto' description: >- The list of individual error detail rows for this failure, one per field or rule that failed. additionalProperties: false description: >- The error payload, present instead of data on a failed response. It wraps the list of detail rows describing what went wrong. MigrationRequestStatus: enum: - legacy - requested - csApproved - techApproved - scheduled - running - completed - confirmed - rejected - failed type: string description: >- The current lifecycle status of the organization's migration request, in the shared migration status vocabulary. ErrorDetailDto: required: - type - field - value type: object properties: type: type: string description: >- The hierarchical error code identifying the specific failure, such as validation_error.required_field. Consumers branch on this rather than on the message text. field: type: - 'null' - string description: >- The input field that caused the failure. Omitted when no specific field is at fault, such as an authorization denial or a server error. value: type: - 'null' - string description: >- A human-readable message describing the failure, or the offending value or limit that triggered it. additionalProperties: false ````