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/vantage-sh-teams-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: Vantage Teams API
description: The Vantage API provides programmatic access to the Vantage cloud cost management and FinOps platform.
termsOfService: https://www.vantage.sh/terms-of-use
contact:
name: Vantage Support
url: https://www.vantage.sh
email: support@vantage.sh
version: 2.0.0
servers:
- url: https://api.vantage.sh/v2
security:
- oauth2:
- read
tags:
- name: Teams
description: Operations about Teams
paths:
/teams:
get:
tags:
- Teams
summary: Get all teams
description: Return all Teams that the current API token has access to.
operationId: getTeams
parameters:
- name: page
in: query
description: The page of results to return.
schema:
type: integer
format: int32
- name: limit
in: query
description: The amount of results to return. The maximum is 1000.
schema:
type: integer
format: int32
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/Teams'
example:
links:
self: https://api.vantage.sh/v2/teams
first: https://api.vantage.sh/v2/teams?page=1
next: null
last: https://api.vantage.sh/v2/teams?page=1
prev: null
teams:
- token: team_2d4733920ec4385e
name: Prod Team
description: Handles all production deployments
workspace_tokens:
- wrkspc_08026aa5fb4c90f8
user_tokens:
- usr_c59398553e838116
default_dashboard_token: null
security:
- oauth2:
- read
post:
tags:
- Teams
summary: Create team
description: Create a new Team.
operationId: createTeam
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/createTeam'
required: true
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/Team'
example:
token: team_8467157535a30221
name: New Team
description: New Team Description
workspace_tokens:
- wrkspc_52b6e5e663b4cde1
user_tokens:
- usr_a00e614b5843c234
default_dashboard_token: null
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'400':
description: BadRequest
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'422':
description: UnprocessableEntity
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- write
x-codegen-request-body-name: createTeam
/teams/{team_token}:
get:
tags:
- Teams
summary: Get team by token
description: Return a specific Team.
operationId: getTeam
parameters:
- name: team_token
in: path
required: true
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/Team'
example:
token: team_081e09bbb812d369
name: Prod Team
description: Handles all production deployments.
workspace_tokens:
- wrkspc_ddc003a2f0171bf8
user_tokens:
- usr_7c309915e847cfc6
default_dashboard_token: null
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- read
put:
tags:
- Teams
summary: Update team
description: Update a Team.
operationId: updateTeam
parameters:
- name: team_token
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/updateTeam'
required: true
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/Team'
example:
token: team_d617e73dcc6b57c5
name: Updated Team
description: Updated Team Description
workspace_tokens:
- wrkspc_efc4284a56772481
user_tokens:
- usr_d268561e520c7aac
default_dashboard_token: null
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'400':
description: BadRequest
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'422':
description: UnprocessableEntity
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- write
x-codegen-request-body-name: updateTeam
delete:
tags:
- Teams
summary: Delete team
description: Delete a Team.
operationId: deleteTeam
parameters:
- name: team_token
in: path
required: true
schema:
type: string
responses:
'204':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/Team'
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'400':
description: BadRequest
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'422':
description: UnprocessableEntity
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- write
/teams/{team_token}/members:
get:
tags:
- Teams
summary: Get team members
description: Return all members of a Team.
operationId: getTeamMembers
parameters:
- name: team_token
in: path
required: true
schema:
type: string
- name: page
in: query
description: The page of results to return.
schema:
type: integer
format: int32
- name: limit
in: query
description: The amount of results to return. The maximum is 1000.
schema:
type: integer
format: int32
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/TeamMembers'
example:
links:
self: https://api.vantage.sh/v2/teams/team_081e09bbb812d369/members
first: https://api.vantage.sh/v2/teams/team_081e09bbb812d369/members?page=1
next: null
last: https://api.vantage.sh/v2/teams/team_081e09bbb812d369/members?page=1
prev: null
members:
- name: John Doe
email: john.doe@acme.com
user_token: usr_7c309915e847cfc6
role: editor
- name: Jane Smith
email: jane.smith@acme.com
user_token: usr_a1b2c3d4e5f67890
role: viewer
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- read
post:
tags:
- Teams
summary: Add team member
description: Add a member to a Team.
operationId: addTeamMember
parameters:
- name: team_token
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/addTeamMember'
required: true
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/TeamMember'
example:
user_email: john.doe@acme.com
role: editor
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'400':
description: BadRequest
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'422':
description: UnprocessableEntity
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- write
x-codegen-request-body-name: addTeamMember
/teams/{team_token}/members/{user_token}:
delete:
tags:
- Teams
summary: Remove team member
description: Remove a member from a Team.
operationId: removeTeamMember
parameters:
- name: team_token
in: path
required: true
schema:
type: string
- name: user_token
in: path
required: true
schema:
type: string
responses:
'204':
description: ''
content: {}
'404':
description: NotFound
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'400':
description: BadRequest
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
security:
- oauth2:
- write
components:
schemas:
Team:
required:
- default_dashboard_token
- description
- name
- token
- user_emails
- user_tokens
- workspace_tokens
type: object
properties:
token:
type: string
name:
type: string
description: The name of the Team.
example: Cost Savers
description:
type:
- string
- 'null'
description: The description of the Team.
example: The Team that saves costs
workspace_tokens:
type: array
description: The tokens for any Workspaces that the Team belongs to
items:
type: string
example: ''
user_emails:
type: array
description: The email addresses for Users that belong to the Team
items:
type: string
example: ''
user_tokens:
type: array
description: The tokens for Users that belong to the Team
items:
type: string
example: ''
default_dashboard_token:
type:
- string
- 'null'
description: The token of the default Dashboard for the Team.
example: dshbrd_abcd1234
description: Team model
updateTeam:
type: object
properties:
name:
type: string
description: The name of the Team.
description:
type: string
description: The description of the Team.
workspace_tokens:
type: array
description: The Workspace tokens to associate to the Team.
items:
type: string
user_tokens:
type: array
description: The User tokens to associate to the Team.
items:
type: string
user_emails:
type: array
description: The User emails to associate to the Team.
items:
type: string
role:
type: string
description: The role to assign to the provided Users. Defaults to 'editor' which has editor permissions.
enum:
- owner
- editor
- viewer
default_dashboard_token:
type:
- string
- 'null'
description: The token of a Dashboard to set as the Team default. Send null to clear.
x-omitempty: false
description: Update a Team.
TeamMember:
required:
- email
- name
- role
- user_token
type: object
properties:
name:
type: string
description: The name of the team member.
example: John Doe
email:
type: string
description: The email address of the team member.
example: john@acme.com
user_token:
type: string
description: The token of the team member.
example: usr_abcd1234
role:
type: string
description: The role of the team member in the team.
example: editor
description: TeamMember model
Teams:
required:
- teams
type: object
properties:
links:
$ref: '#/components/schemas/Links'
teams:
type: array
items:
$ref: '#/components/schemas/Team'
description: Teams model
Errors:
required:
- errors
type: object
properties:
links:
$ref: '#/components/schemas/Links'
errors:
type: array
items:
type: string
description: Errors model
Links:
type: object
properties:
self:
type:
- string
- 'null'
description: The URL of the current page of results.
first:
type:
- string
- 'null'
description: The URL of the first page of results.
next:
type:
- string
- 'null'
description: The URL of the next page of results, if one exists.
last:
type:
- string
- 'null'
description: The URL of the last page of results, if one exists.
prev:
type:
- string
- 'null'
description: The URL of the previous page of results, if one exists.
addTeamMember:
required:
- role
- user_email
type: object
properties:
user_email:
type: string
description: The email address of the user to add to the Team.
role:
type: string
description: The role to assign to the user. Defaults to 'editor'.
default: editor
enum:
- owner
- editor
- viewer
- integration_owner
description: Add a member to a Team.
TeamMembers:
required:
- members
type: object
properties:
links:
$ref: '#/components/schemas/Links'
members:
type: array
items:
$ref: '#/components/schemas/TeamMember'
description: TeamMembers model
createTeam:
required:
- name
type: object
properties:
name:
type: string
description: The name of the Team.
description:
type: string
description: The description of the Team.
workspace_tokens:
type: array
description: The Workspace tokens to associate to the Team.
items:
type: string
user_tokens:
type: array
description: The User tokens to associate to the Team.
items:
type: string
user_emails:
type: array
description: The User emails to associate to the Team.
items:
type: string
role:
type: string
description: The role to assign to the provided Users. Defaults to 'editor' which has editor permissions.
enum:
- owner
- editor
- viewer
default_dashboard_token:
type:
- string
- 'null'
description: The token of a Dashboard to set as the Team default. Send null to clear.
x-omitempty: false
description: Create a new Team.
securitySchemes:
oauth2:
type: oauth2
flows:
clientCredentials:
tokenUrl: https://console.vantage.sh/account/profile
scopes:
read: Grants read access
write: Grants write access
x-original-swagger-version: '2.0'