# Cloud Foundry Routes API

**Canonical:** https://apis.io/apis/cloud-foundry/cloud-foundry-routes-api/  
**Provider:** Cloud Foundry — https://apis.io/providers/cloud-foundry/  
**Base URL:** https://api.{system-domain}  
**Documentation:** https://v3-apidocs.cloudfoundry.org/

Cloud Foundry Routes API is one of 49 APIs that [Cloud Foundry](https://apis.io/providers/cloud-foundry/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Routes. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

Routes are used to map a URL to an app.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/v3/routes` | List routes |
| POST | `/v3/routes` | Create a route |
| GET | `/v3/routes/{guid}/destinations` | List destinations for a route |
| POST | `/v3/routes/{guid}/destinations` | Insert destinations for a route |
| PATCH | `/v3/routes/{guid}/destinations` | Replace all destinations for a route |
| PATCH | `/v3/routes/{guid}/destinations/{destination_guid}` | Update a destination protocol for a route |
| DELETE | `/v3/routes/{guid}/destinations/{destination_guid}` | Remove destination for a route |
| GET | `/v3/apps/{guid}/routes` | List routes for an app |
| GET | `/v3/routes/{guid}` | Get a route |
| PATCH | `/v3/routes/{guid}` | Update a route |
| DELETE | `/v3/routes/{guid}` | Delete a route |
| GET | `/v3/routes/{guid}/relationships/shared_spaces` | List shared spaces relationship |
| POST | `/v3/routes/{guid}/relationships/shared_spaces` | Share a route with other spaces (experimental) |
| DELETE | `/v3/routes/{guid}/relationships/shared_spaces/{space_guid}` | Unshare a route that was shared with another space (experimental) |
| PATCH | `/v3/routes/{guid}/relationships/space` | Transfer ownership (experimental) |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cloud-foundry/refs/heads/main/openapi/cloud-foundry-routes-api-openapi.yml
- **APIReference** — https://v3-apidocs.cloudfoundry.org/
- **Documentation** — https://docs.cloudfoundry.org/
- **Source Code** — https://github.com/cloudfoundry/cloud_controller_ng
- **Specification** — https://github.com/cloudfoundry/cf-openapi
- **Reference** — https://cloudfoundry.github.io/cf-openapi/
- **Documentation** — https://www.openservicebrokerapi.org/
- **Specification** — https://github.com/openservicebrokerapi/servicebroker
- **Documentation** — https://github.com/cloudfoundry/app-autoscaler/blob/main/docs/user_guide.md
- **Source Code** — https://github.com/cloudfoundry/app-autoscaler

## Other Cloud Foundry APIs (12)

- [Cloud Foundry UAA](https://apis.io/apis/cloud-foundry/uaa/)
- [Cloud Foundry Loggregator](https://apis.io/apis/cloud-foundry/loggregator/)
- [BOSH Director API](https://apis.io/apis/cloud-foundry/bosh/)
- [Cloud Foundry Apps API](https://apis.io/apis/cloud-foundry/cloud-foundry-apps-api/)
- [Cloud Foundry Builds API](https://apis.io/apis/cloud-foundry/cloud-foundry-builds-api/)
- [Cloud Foundry Deployments API](https://apis.io/apis/cloud-foundry/cloud-foundry-deployments-api/)
- [Cloud Foundry Jobs API](https://apis.io/apis/cloud-foundry/cloud-foundry-jobs-api/)
- [Cloud Foundry Organizations API](https://apis.io/apis/cloud-foundry/cloud-foundry-organizations-api/)
- [Cloud Foundry Service Instances API](https://apis.io/apis/cloud-foundry/cloud-foundry-service-instances-api/)
- [Cloud Foundry Spaces API](https://apis.io/apis/cloud-foundry/cloud-foundry-spaces-api/)
- [Cloud Foundry Admin API](https://apis.io/apis/cloud-foundry/cloud-foundry-admin-api/)
- [Cloud Foundry App Usage Events API](https://apis.io/apis/cloud-foundry/cloud-foundry-app-usage-events-api/)

## Tags

Routes

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cloud-foundry/cloud-foundry-routes-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cloud-foundry/.