Upsun API Tokens API
The API Tokens API from Upsun — 2 operation(s) for api tokens.
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-api-tokens-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 API Tokens 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: API Tokens
paths:
/users/{user_id}/api-tokens:
parameters:
- $ref: '#/components/parameters/UserID'
get:
summary: List a user's API tokens
description: Retrieves a list of API tokens associated with a single user.
operationId: list-api-tokens
tags:
- API Tokens
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/APIToken'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
summary: Create an API token
description: Creates an API token
operationId: create-api-token
tags:
- API Tokens
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/APIToken'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Conflict
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: The token name.
required:
- name
/users/{user_id}/api-tokens/{token_id}:
parameters:
- $ref: '#/components/parameters/UserID'
- schema:
type: string
format: uuid
name: token_id
in: path
required: true
description: The ID of the token.
get:
summary: Get an API token
description: Retrieves the specified API token.
operationId: get-api-token
tags:
- API Tokens
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/APIToken'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
delete:
summary: Delete an API token
description: Deletes an API token
operationId: delete-api-token
tags:
- API Tokens
responses:
'204':
description: No Content
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
components:
schemas:
APIToken:
description: ''
type: object
properties:
id:
type: string
format: uuid
description: The ID of the token.
name:
type: string
description: The token name.
mfa_on_creation:
type: boolean
description: Whether the user had multi-factor authentication (MFA) enabled when they created the token.
token:
type: string
description: The token in plain text (available only when created).
created_at:
type: string
format: date-time
description: The date and time when the token was created.
updated_at:
type: string
format: date-time
description: The date and time when the token was last updated.
last_used_at:
type:
- string
- 'null'
format: date-time
description: 'The date and time when the token was last exchanged for an access token. This will be <code>null</code> for a token which has never been used, or not used since this API property was added. <strong>Note:</strong> After an API token is used, the derived access token may continue to be used until its expiry. This also applies to SSH certificate(s) derived from the access token.
'
x-examples:
example-1:
created_at: '2019-01-29T08:17:47Z'
id: 660aa36d-23cf-402b-8889-63af71967f2b
name: Token for CI
updated_at: '2019-01-29T08:17:47Z'
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
parameters:
UserID:
name: user_id
in: path
required: true
description: The ID of the user.
schema:
type: string
example: d81c8ee2-44b3-429f-b944-a33ad7437690
format: uuid
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