The Accounts API from Tower — 2 operation(s) for accounts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/tower:tower-accounts-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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: 3.2.0
info:
contact:
email: hello@tower.dev
name: Tower Computing GmbH
url: https://tower.dev
description: REST API to interact with Tower Services.
termsOfService: https://tower.dev/terms
title: Tower Accounts API
version: v0.11.16
servers:
- url: https://api.tower.dev/v1
tags:
- name: Accounts
paths:
/accounts:
post:
description: This is the primary way that users register new accounts with Tower.
operationId: create-account
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAccountParams'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAccountResponse'
description: OK
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
summary: Create account
tags:
- Accounts
/accounts/{name}:
get:
description: Get information about a specific account by name.
operationId: describe-account
parameters:
- description: The name of the account to describe
in: path
name: name
required: true
schema:
description: The name of the account to describe
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DescribeAccountBody'
description: OK
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
security:
- AccessTokenAuth:
- teams:read
- APIKeyAuth:
- teams:read
summary: Describe account
tags:
- Accounts
put:
description: Update the properties of an account
operationId: update-account
parameters:
- description: The name of the account to update
in: path
name: name
required: true
schema:
description: The name of the account to update
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateAccountParams'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateAccountResponse'
description: OK
default:
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Error
security:
- AccessTokenAuth:
- teams:update
- APIKeyAuth:
- teams:update
summary: Update account
tags:
- Accounts
components:
schemas:
Session:
additionalProperties: false
properties:
featurebase_identity:
$ref: '#/components/schemas/FeaturebaseIdentity'
deprecated: true
description: This property is deprecated. It will be removed in a future version.
teams:
items:
$ref: '#/components/schemas/Team'
type: array
token:
$ref: '#/components/schemas/Token'
user:
$ref: '#/components/schemas/User'
required:
- user
- token
- teams
- featurebase_identity
type: object
Account:
additionalProperties: false
properties:
execution_region:
type: string
is_self_hosted_only:
type: boolean
name:
type: string
slug:
deprecated: true
description: This property is deprecated. Use name instead.
type: string
required:
- name
- is_self_hosted_only
- execution_region
type: object
FeaturebaseIdentity:
additionalProperties: false
properties:
company_hash:
type: string
user_hash:
type: string
required:
- user_hash
- company_hash
type: object
ErrorDetail:
additionalProperties: false
properties:
location:
description: Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
type: string
message:
description: Error message text
type: string
value:
description: The value at the given location
type: object
UpdateAccountParams:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://api.tower.dev/v1/schemas/UpdateAccountParams.json
format: uri
readOnly: true
type: string
execution_region:
description: The execution region for runs
enum:
- eu-central-1
- us-east-1
- us-west-2
- eu-west-1
type: string
is_self_hosted_only:
description: Whether the account is for self-hosted use only
type: boolean
name:
description: The new name for the account, if any
type: string
type: object
User:
additionalProperties: false
properties:
company:
type: string
country:
type: string
created_at:
format: date-time
type: string
email:
type: string
first_name:
type: string
is_alerts_enabled:
type: boolean
is_confirmed:
type: boolean
is_invitation_claimed:
deprecated: true
description: This property is deprecated. It will be removed in a future version.
type: boolean
is_subscribed_to_changelog:
type: boolean
last_name:
type: string
profile_photo_url:
type: string
promo_code:
type: string
required:
- first_name
- last_name
- company
- country
- promo_code
- email
- profile_photo_url
- created_at
- is_alerts_enabled
- is_confirmed
- is_subscribed_to_changelog
type: object
DescribeAccountBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://api.tower.dev/v1/schemas/DescribeAccountBody.json
format: uri
readOnly: true
type: string
account:
$ref: '#/components/schemas/Account'
required:
- account
type: object
Team:
additionalProperties: false
properties:
execution_region:
type: string
name:
type: string
organization:
description: The name of the organization this team belongs to.
type: string
slug:
deprecated: true
description: This property is deprecated. Use name instead.
type: string
token:
$ref: '#/components/schemas/Token'
type:
description: The type of team, either 'personal' or 'team'.
type: string
required:
- name
- type
- organization
- execution_region
type: object
UpdateAccountResponse:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://api.tower.dev/v1/schemas/UpdateAccountResponse.json
format: uri
readOnly: true
type: string
account:
$ref: '#/components/schemas/Account'
required:
- account
type: object
Token:
additionalProperties: false
properties:
access_token:
description: The access token to use when authenticating API requests with Tower.
type: string
jwt:
type: string
refresh_token:
description: The refresh token to use when refreshing an expired access token. For security reasons, refresh tokens should only be transmitted over secure channels and never logged or stored in plaintext. It will only be returned upon initial authentication or when explicitly refreshing the access token.
type: string
required:
- access_token
- jwt
type: object
CreateAccountParams:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://api.tower.dev/v1/schemas/CreateAccountParams.json
format: uri
readOnly: true
type: string
email:
type: string
password:
type: string
required:
- email
- password
type: object
ErrorModel:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://api.tower.dev/v1/schemas/ErrorModel.json
format: uri
readOnly: true
type: string
detail:
description: A human-readable explanation specific to this occurrence of the problem.
examples:
- Property foo is required but is missing.
type: string
errors:
description: Optional list of individual error details
items:
$ref: '#/components/schemas/ErrorDetail'
type: array
instance:
description: A URI reference that identifies the specific occurrence of the problem.
examples:
- https://example.com/error-log/abc123
format: uri
type: string
status:
description: HTTP status code
examples:
- 400
format: int64
type: integer
title:
description: A short, human-readable summary of the problem type. This value should not change between occurrences of the error.
examples:
- Bad Request
type: string
type:
default: about:blank
description: A URI reference to human-readable documentation for the error.
examples:
- https://example.com/errors/example
format: uri
type: string
type: object
CreateAccountResponse:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://api.tower.dev/v1/schemas/CreateAccountResponse.json
format: uri
readOnly: true
type: string
session:
$ref: '#/components/schemas/Session'
required:
- session
type: object
securitySchemes:
APIKeyAuth:
description: API key created by a Tower user or Tower service account to authenticate an API request.
in: header
name: X-API-Key
type: apiKey
AccessTokenAuth:
description: Access token authentication scheme which uses an access token provided by the Tower API as part of a Tower session (see documentation about creating sessions).
scheme: Bearer
type: http