---
title: Delete a workflow
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/delete-v1-ciworkflows-_id_
---

# Delete a workflow

Delete an Xcode Cloud workflow and all of its associated data.

## URL

DELETE https://api.appstoreconnect.apple.com/v1/ciWorkflows/{id}

## Path Parameters

id: The opaque resource ID that uniquely identifies the Workflows resource.

## Response Codes

204 No Content: The request completed successfully and the specific Workflows resource was deleted. 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 404 Not Found: Resource not found. 429 :

## Discussion

Discussion To delete an Xcode Cloud workflow, call this endpoint using the HTTP DELETE method like this: https://api.appstoreconnect.apple.com/v1/ciWorkflows/9ad354b0-f380-40d3-b94f-dd5225b8b3d5 App Store Connect confirms the deletion by responding with the HTTP/1.1 204 No Content HTTP status code. important: Deleting an Xcode Cloud workflow permanently deletes its build history and artifacts. Only delete an Xcode Cloud workflow when you’re confident that you no longer need it and its build history or artifacts. Instead of deleting a workflow, deactivate it to preserve its build history and artifacts. To deactivate a workflow, use the Update an xcode cloud workflow endpoint to set the workflow’s isEnabled attribute to false or deactivate it in the Xcode or App Store Connect. For more information about deactivating a workflow using Xcode or App Store Connect, see Developing a workflow strategy for Xcode Cloud.

## See Also

### Managing Xcode Cloud Workflows

- [Create a workflow](appstoreconnectapi/post-v1-ciworkflows.md)
- [Update an xcode cloud workflow](appstoreconnectapi/patch-v1-ciworkflows-_id_.md)