Upsun Team Access API
The Team Access API from Upsun — 4 operation(s) for team access.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/upsun-team-access-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Upsun.com Rest Team Access 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:
- name: Team Access
paths:
/projects/{project_id}/team-access:
parameters:
- $ref: '#/components/parameters/ProjectID'
get:
summary: List team access for a project
description: Returns a list of items representing the project access.
operationId: list-project-team-access
tags:
- Team Access
parameters:
- in: query
name: page[size]
description: Determines the number of items to show.
schema:
type: integer
minimum: 1
maximum: 200
default: null
- in: query
name: page[before]
description: Pagination cursor. This is automatically generated as necessary and provided in HAL links (_links); it should not be constructed externally.
schema:
type: string
- in: query
name: page[after]
description: Pagination cursor. This is automatically generated as necessary and provided in HAL links (_links); it should not be constructed externally.
schema:
type: string
- in: query
name: sort
description: 'Allows sorting by a single field.<br>
Use a dash ("-") to sort descending.<br>
Supported fields: `granted_at`, `updated_at`.
'
schema:
type: string
example: -updated_at
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/TeamProjectAccess'
_links:
$ref: '#/components/schemas/ListLinks'
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
post:
summary: Grant team access to a project
description: Grants one or more team access to a specific project.
operationId: grant-project-team-access
tags:
- Team Access
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
type: object
properties:
team_id:
type: string
description: ID of the team.
required:
- team_id
responses:
'204':
description: No Content
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
/projects/{project_id}/team-access/{team_id}:
parameters:
- $ref: '#/components/parameters/ProjectID'
- $ref: '#/components/parameters/TeamID'
get:
summary: Get team access for a project
description: Retrieves the team's permissions for the current project.
operationId: get-project-team-access
tags:
- Team Access
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/TeamProjectAccess'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
delete:
summary: Remove team access for a project
description: Removes the team from the current project.
operationId: remove-project-team-access
tags:
- Team Access
responses:
'204':
description: No Content
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
/teams/{team_id}/project-access:
parameters:
- $ref: '#/components/parameters/TeamID'
get:
summary: List project access for a team
description: Returns a list of items representing the team's project access.
operationId: list-team-project-access
tags:
- Team Access
parameters:
- in: query
name: page[size]
description: Determines the number of items to show.
schema:
type: integer
minimum: 1
maximum: 200
default: null
- in: query
name: page[before]
description: Pagination cursor. This is automatically generated as necessary and provided in HAL links (_links); it should not be constructed externally.
schema:
type: string
- in: query
name: page[after]
description: Pagination cursor. This is automatically generated as necessary and provided in HAL links (_links); it should not be constructed externally.
schema:
type: string
- in: query
name: sort
description: 'Allows sorting by a single field.<br>
Use a dash ("-") to sort descending.<br>
Supported fields: `project_title`, `granted_at`, `updated_at`.
'
schema:
type: string
example: -updated_at
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/TeamProjectAccess'
_links:
$ref: '#/components/schemas/ListLinks'
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
post:
summary: Grant project access to a team
description: Adds the team to one or more specified projects.
operationId: grant-team-project-access
tags:
- Team Access
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
type: object
properties:
project_id:
type: string
description: ID of the project.
required:
- project_id
responses:
'204':
description: No Content
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
/teams/{team_id}/project-access/{project_id}:
parameters:
- $ref: '#/components/parameters/TeamID'
- $ref: '#/components/parameters/ProjectID'
get:
summary: Get project access for a team
description: Retrieves the team's permissions for the current project.
operationId: get-team-project-access
tags:
- Team Access
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/TeamProjectAccess'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
delete:
summary: Remove project access for a team
description: Removes the team from the current project.
operationId: remove-team-project-access
tags:
- Team Access
responses:
'204':
description: No Content
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Error'
components:
parameters:
TeamID:
name: team_id
in: path
required: true
description: The ID of the team.
schema:
type: string
ProjectID:
name: project_id
in: path
required: true
description: The ID of the project.
schema:
type: string
schemas:
Error:
description: ''
type: object
properties:
status:
type: string
message:
type: string
code:
type: number
detail:
type: object
title:
type: string
title: ''
x-examples:
example-1:
status: Invalid input
message: This field is required.
code: 400
detail:
field:
- This field is required.
title: Bad Request
Link:
type: object
title: Link
description: A hypermedia link to the {current, next, previous} set of items.
properties:
href:
type: string
description: URL of the link
TeamProjectAccess:
type: object
properties:
team_id:
type: string
format: ulid
description: The ID of the team.
organization_id:
type: string
format: ulid
description: The ID of the organization.
project_id:
type: string
description: The ID of the project.
project_title:
type: string
description: The title of the project.
granted_at:
type: string
format: date-time
description: The date and time when the access was granted.
updated_at:
type: string
format: date-time
description: The date and time when the access was last updated.
_links:
type: object
properties:
self:
type: object
description: Link to the current access item.
properties:
href:
type: string
description: URL of the link.
update:
type: object
description: Link for updating the current access item.
properties:
href:
type: string
description: URL of the link.
method:
type: string
description: The HTTP method to use.
delete:
type: object
description: Link for deleting the current access item.
properties:
href:
type: string
description: URL of the link.
method:
type: string
description: The HTTP method to use.
ListLinks:
type: object
properties:
self:
$ref: '#/components/schemas/Link'
previous:
$ref: '#/components/schemas/Link'
next:
$ref: '#/components/schemas/Link'
securitySchemes:
OAuth2:
type: oauth2
flows:
authorizationCode:
tokenUrl: https://auth.api.platform.sh/oauth2/token
refreshUrl: https://auth.api.platform.sh/oauth2/token
scopes: {}
authorizationUrl: https://auth.api.platform.sh/oauth2/authorize
description: ''
OAuth2Admin:
type: oauth2
flows:
clientCredentials:
tokenUrl: https://auth.api.platform.sh/oauth2/token
refreshUrl: ''
scopes:
admin: administrative operations
description: ''
x-tagGroups:
- name: Organization Administration
tags:
- Organizations
- Organization Members
- Organization Invitations
- Organization Projects
- Add-ons
- name: Project Administration
tags:
- Project
- Domain Management
- Cert Management
- Certificate Provisioner
- Project Variables
- Repository
- Third-Party Integrations
- Support
- name: Environments
tags:
- Environment
- Environment Backups
- Environment Type
- Environment Variables
- Routing
- Source Operations
- Runtime Operations
- Deployment
- Autoscaling
- name: User Activity
tags:
- Project Activity
- Environment Activity
- name: Project Access
tags:
- Project Invitations
- Teams
- Team Access
- User Access
- name: Account Management
tags:
- API Tokens
- Connections
- MFA
- Users
- User Profiles
- SSH Keys
- Plans
- name: Billing
tags:
- Organization Management
- Subscriptions
- Orders
- Invoices
- Discounts
- Vouchers
- Records
- Profiles
- name: Global Info
tags:
- Project Discovery
- References
- Regions
- name: Internal APIs
tags:
- Project Settings
- Environment Settings
- Deployment Target
- System Information
- Container Profile