Upsun

Upsun Environment API

On Upsun, an environment encompasses a single instance of your entire application stack, the services used by the application, the application's data storage, and the environment's backups. In general, an environment represents a single branch or merge request in the Git repository backing a project. It is a virtual cluster of read-only application and service containers with read-write mounts for application and service data. On Upsun, the default branch is your production environment—thus, merging changes to this branch will put those changes to production.

GitHub OpenAPI
Business capability
Environment Management BC-4210.20

Operations 19

GET /projects/{projectId}/environments Get list of project environments #
GET /projects/{projectId}/environments/{environmentId} Get an environment #
PATCH /projects/{projectId}/environments/{environmentId} Update an environment #
DELETE /projects/{projectId}/environments/{environmentId} Delete an environment #
POST /projects/{projectId}/environments/{environmentId}/activate Activate an environment #
POST /projects/{projectId}/environments/{environmentId}/branch Branch an environment #
POST /projects/{projectId}/environments/{environmentId}/deactivate Deactivate an environment #
POST /projects/{projectId}/environments/{environmentId}/deploy Deploy an environment #
POST /projects/{projectId}/environments/{environmentId}/initialize Initialize a new environment #
POST /projects/{projectId}/environments/{environmentId}/merge Merge an environment #
POST /projects/{projectId}/environments/{environmentId}/pause Pause an environment #
POST /projects/{projectId}/environments/{environmentId}/redeploy Redeploy an environment #
POST /projects/{projectId}/environments/{environmentId}/resume Resume a paused environment #
POST /projects/{projectId}/environments/{environmentId}/synchronize Synchronize a child environment with its parent #
GET /projects/{projectId}/environments/{environmentId}/versions List versions associated with the environment #
POST /projects/{projectId}/environments/{environmentId}/versions Create versions associated with the environment #
GET /projects/{projectId}/environments/{environmentId}/versions/{versionId} List the version #
PATCH /projects/{projectId}/environments/{environmentId}/versions/{versionId} Update the version #
DELETE /projects/{projectId}/environments/{environmentId}/versions/{versionId} Delete the version #

Documentation

📖
Documentation
https://developer.upsun.com/api-reference

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/upsun/refs/heads/main/openapi/upsun-environment-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/upsun-environment-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

upsun-environment-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Upsun.com Rest Environment API
  version: '1.0'
  contact:
    name: Support
    url: https://upsun.com/contact-us/
  termsOfService: https://upsun.com/trust-center/legal/tos/
  description: '# Introduction


    Upsun, formerly Platform.sh, is a container-based Platform-as-a-Service.'
  x-logo:
    url: https://docs.upsun.com/images/upsun-api.svg
    href: https://upsun.com/#section/Introduction
    altText: Upsun logo
servers:
- url: '{schemes}://api.upsun.com'
  description: The Upsun.com API gateway
  variables:
    schemes:
      default: https
security:
- OAuth2: []
tags:


# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/upsun/refs/heads/main/openapi/upsun-environment-api-openapi.yml