Update subscription

curl --request PATCH \
  --url {schemes}://api.upsun.com/organizations/{organization_id}/subscriptions/{subscription_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_title": "<string>",
  "plan": "<string>",
  "timezone": "<string>",
  "environments": 123,
  "storage": 123,
  "big_dev": "<string>",
  "big_dev_service": "<string>",
  "backups": "<string>",
  "observability_suite": "<string>",
  "blackfire": "<string>",
  "continuous_profiling": "<string>",
  "project_support_level": "<string>"
}
'

{
  "id": "<string>",
  "status": "requested",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "owner": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "owner_info": {
    "type": "<string>",
    "username": "<string>",
    "display_name": "<string>"
  },
  "vendor": "<string>",
  "plan": "<string>",
  "environments": 123,
  "storage": 123,
  "user_licenses": 123,
  "project_id": "<string>",
  "project_endpoint": "<string>",
  "project_title": "<string>",
  "project_region": "<string>",
  "project_region_label": "<string>",
  "project_ui": "<string>",
  "project_options": {
    "defaults": {
      "settings": {},
      "variables": {},
      "access": {},
      "capabilities": {}
    },
    "enforced": {
      "settings": {},
      "capabilities": {}
    },
    "regions": [
      "<string>"
    ],
    "plans": [
      "<string>"
    ],
    "billing": {}
  },
  "agency_site": true,
  "invoiced": true,
  "hipaa": true,
  "is_trial_plan": true,
  "services": [
    {}
  ],
  "green": true
}

PATCH

organizations

{organization_id}

subscriptions

{subscription_id}

Error

A valid request URL is required to generate request examples

{
  "id": "<string>",
  "status": "requested",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "owner": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "owner_info": {
    "type": "<string>",
    "username": "<string>",
    "display_name": "<string>"
  },
  "vendor": "<string>",
  "plan": "<string>",
  "environments": 123,
  "storage": 123,
  "user_licenses": 123,
  "project_id": "<string>",
  "project_endpoint": "<string>",
  "project_title": "<string>",
  "project_region": "<string>",
  "project_region_label": "<string>",
  "project_ui": "<string>",
  "project_options": {
    "defaults": {
      "settings": {},
      "variables": {},
      "access": {},
      "capabilities": {}
    },
    "enforced": {
      "settings": {},
      "capabilities": {}
    },
    "regions": [
      "<string>"
    ],
    "plans": [
      "<string>"
    ],
    "billing": {}
  },
  "agency_site": true,
  "invoiced": true,
  "hipaa": true,
  "is_trial_plan": true,
  "services": [
    {}
  ],
  "green": true
}

Authorizations

Authorization

string

header

required

Path Parameters

organization_id

string<ulid>

required

The ID of the organization.

subscription_id

string

required

The ID of the subscription.

Body

application/json

project_title

string

The title of the project.

plan

string

The project plan.

timezone

string

Timezone of the project.

environments

integer

The maximum number of environments which can be provisioned on the project.

storage

integer

The total storage available to each environment, in MiB.

big_dev

string

The development environment plan.

big_dev_service

string

The development service plan.

backups

string

The backups plan.

observability_suite

string

The observability suite option.

blackfire

string

The Blackfire integration option.

continuous_profiling

string

The Blackfire continuous profiling option.

project_support_level

string

The project uptime option.

Response

The subscription object.

string

The internal ID of the subscription.

status

enum<string>

The status of the subscription.

Available options:

requested,

provisioning failure,

provisioning,

active,

suspended,

deleted

created_at

string<date-time>

The date and time when the subscription was created.

updated_at

string<date-time>

The date and time when the subscription was last updated.

owner

string<uuid>

The UUID of the owner.

owner_info

object

Project owner information that can be exposed to collaborators.

Show child attributes

vendor

string

The machine name of the vendor the subscription belongs to.

plan

string

The plan type of the subscription.

environments

integer

The number of environments which can be provisioned on the project.

storage

integer

The total storage available to each environment, in MiB. Only multiples of 1024 are accepted as legal values.

user_licenses

integer

The number of chargeable users who currently have access to the project. Manage this value by adding and removing users through the Platform project API. Staff and billing/administrative contacts can be added to a project for no charge. Contact support for questions about user licenses.

project_id

string

The unique ID string of the project.

project_endpoint

string

The project API endpoint for the project.

project_title

string

The name given to the project. Appears as the title in the UI.

project_region

string

The machine name of the region where the project is located. Cannot be changed after project creation.

project_region_label

string

The human-readable name of the region where the project is located.

project_ui

string

The URL for the project's user interface.

project_options

object

The project options object.

Show child attributes

agency_site

boolean

True if the project is an agency site.

invoiced

boolean

Whether the subscription is invoiced.

hipaa

boolean

Whether the project is marked as HIPAA.

is_trial_plan

boolean

Whether the project is currently on a trial plan.

services

object[]

Details of the attached services.

green

boolean

Whether the subscription is considered green (on a green region, belonging to a green vendor) for billing purposes.

Delete subscription List user profiles

⌘I

SDK

REST API

OpenAPI Reference

Update subscription

Authorizations

Path Parameters

Body

Response