---
title: Workflows
framework: appstoreconnectapi
role: collectionGroup
role_heading: API Collection
path: appstoreconnectapi/workflows
---

# Workflows

Manage Xcode Cloud workflows and view workflow details like actions and start conditions.

## Overview

Overview The ciWorkflows resource represents an Xcode Cloud workflow. Use it to: Read workflow information. Create a new workflow. Update an existing workflow. Delete a workflow you no longer need. To learn more about workflows, see Xcode Cloud workflow reference. important: Deleting a workflow also deletes associated build information and artifacts. Instead of deleting a workflow, consider deactivating it in Xcode or App Store Connect. To learn more about deactivating a workflow, see Developing a workflow strategy for Xcode Cloud. This resource supports JSON web tokens with a lifetime of up to six months. For more information, see Determine the Appropriate Token Lifetime.

## Topics

### Getting Xcode Cloud Workflows

- [Read xcode cloud workflow information](appstoreconnectapi/get-v1-ciworkflows-_id_.md)
- [List all xcode cloud builds for a workflow](appstoreconnectapi/get-v1-ciworkflows-_id_-buildruns.md)
- [Read the repository information for an xcode cloud workflow](appstoreconnectapi/get-v1-ciworkflows-_id_-repository.md)
- [List build run IDs for a CI workflow](appstoreconnectapi/get-v1-ciworkflows-_id_-relationships-buildruns.md)
- [Get the repository ID for a CI workflow](appstoreconnectapi/get-v1-ciworkflows-_id_-relationships-repository.md)

### Managing Xcode Cloud Workflows

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

### Objects and types

- [CiWorkflow](appstoreconnectapi/ciworkflow.md)
- [CiAction](appstoreconnectapi/ciaction.md)
- [CiWorkflowCreateRequest](appstoreconnectapi/ciworkflowcreaterequest.md)
- [CiWorkflowUpdateRequest](appstoreconnectapi/ciworkflowupdaterequest.md)
- [CiWorkflowResponse](appstoreconnectapi/ciworkflowresponse.md)
- [CiWorkflowsResponse](appstoreconnectapi/ciworkflowsresponse.md)
- [CiBuildRunsResponse](appstoreconnectapi/cibuildrunsresponse.md)
- [CiManualBranchStartCondition](appstoreconnectapi/cimanualbranchstartcondition.md)
- [CiManualPullRequestStartCondition](appstoreconnectapi/cimanualpullrequeststartcondition.md)
- [CiManualTagStartCondition](appstoreconnectapi/cimanualtagstartcondition.md)
- [CiWorkflowBuildRunsLinkagesResponse](appstoreconnectapi/ciworkflowbuildrunslinkagesresponse.md)
- [CiWorkflowRepositoryLinkageResponse](appstoreconnectapi/ciworkflowrepositorylinkageresponse.md)

## See Also

### Xcode Cloud Products and Workflows

- [Products](appstoreconnectapi/products.md)
- [macOS Versions](appstoreconnectapi/macos-versions.md)
- [Xcode Versions](appstoreconnectapi/xcode-versions.md)