Vers commits API
The commits API from Vers — 4 operation(s) for commits.
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/vers-commits-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: Orchestrator Control Plane commit_tags Commits API
description: ''
license:
name: ''
version: 0.1.0
servers:
- url: https://api.vers.sh
description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: commits
paths:
/api/v1/commits:
get:
tags:
- commits
operationId: list_commits
parameters:
- name: limit
in: path
description: 'Maximum number of commits to return (default: 50, max: 100)'
required: true
schema:
type:
- integer
- 'null'
format: int64
- name: offset
in: path
description: 'Number of commits to skip (default: 0)'
required: true
schema:
type:
- integer
- 'null'
format: int64
responses:
'200':
description: List of commits
content:
application/json:
schema:
$ref: '#/components/schemas/ListCommitsResponse'
'401':
description: Unauthorized
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- bearer_auth: []
/api/v1/commits/public:
get:
tags:
- commits
operationId: list_public_commits
parameters:
- name: limit
in: path
description: 'Maximum number of commits to return (default: 50, max: 100)'
required: true
schema:
type:
- integer
- 'null'
format: int64
- name: offset
in: path
description: 'Number of commits to skip (default: 0)'
required: true
schema:
type:
- integer
- 'null'
format: int64
responses:
'200':
description: List of public commits
content:
application/json:
schema:
$ref: '#/components/schemas/ListCommitsResponse'
'401':
description: Unauthorized
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- bearer_auth: []
/api/v1/commits/{commit_id}:
delete:
tags:
- commits
operationId: delete_commit
parameters:
- name: commit_id
in: path
description: Commit ID to delete
required: true
schema:
type: string
format: uuid
responses:
'204':
description: Commit deleted
'401':
description: Unauthorized
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Commit not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'409':
description: Commit in use
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- bearer_auth: []
patch:
tags:
- commits
operationId: update_commit
parameters:
- name: commit_id
in: path
description: The commit ID
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateCommitRequest'
required: true
responses:
'200':
description: Commit updated
content:
application/json:
schema:
$ref: '#/components/schemas/CommitInfo'
'401':
description: Unauthorized
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Commit not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- bearer_auth: []
/api/v1/vm/commits/{commit_id}/parents:
get:
tags:
- commits
operationId: list_parent_commits
parameters:
- name: commit_id
in: path
description: Commit ID to start from
required: true
schema:
type: string
format: uuid
responses:
'200':
description: List of commits from the specified commit to the root
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/VmCommitEntity'
'401':
description: Unauthorized
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Commit not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- bearer_auth: []
components:
schemas:
ErrorResponse:
type: object
properties:
error:
type: string
description: Reason of error
success:
type: boolean
description: 'Is always: false'
VmCommitEntity:
type: object
required:
- id
- owner_id
- name
- created_at
- is_public
properties:
created_at:
type: string
format: date-time
description:
type:
- string
- 'null'
grandparent_commit_id:
type:
- string
- 'null'
format: uuid
description: The commit that this commit's parent VM was started from, if any. Intended to optimize traversing the commit tree.
id:
type: string
format: uuid
is_public:
type: boolean
description: Whether this commit is publicly accessible (readable/restorable by anyone).
name:
type: string
owner_id:
type: string
format: uuid
description: api key id.
parent_vm_id:
type:
- string
- 'null'
format: uuid
description: The VM that this commit was created from, if any.
UpdateCommitRequest:
type: object
description: Request body for PATCH /commits/{commit_id}
required:
- is_public
properties:
description:
type:
- string
- 'null'
description: Optional description for the commit.
is_public:
type: boolean
name:
type:
- string
- 'null'
description: Optional human-readable name for the commit.
CommitInfo:
type: object
required:
- commit_id
- owner_id
- name
- created_at
- is_public
properties:
commit_id:
type: string
created_at:
type: string
description:
type:
- string
- 'null'
grandparent_commit_id:
type:
- string
- 'null'
is_public:
type: boolean
name:
type: string
owner_id:
type: string
parent_vm_id:
type:
- string
- 'null'
ListCommitsResponse:
type: object
required:
- commits
- total
- limit
- offset
properties:
commits:
type: array
items:
$ref: '#/components/schemas/CommitInfo'
limit:
type: integer
format: int64
offset:
type: integer
format: int64
total:
type: integer
format: int64
securitySchemes:
bearer_auth:
type: http
scheme: bearer
bearerFormat: Token