OpenAPI Specification
openapi: 3.0.3
info:
title: Drone REST Builds System API
description: The Drone REST API provides programmatic access to the Drone CI/CD platform, enabling management of builds, repositories, secrets, cron jobs, templates, and user accounts. Authentication is performed using bearer tokens retrieved from the Drone user interface profile page.
version: 1.0.0
contact:
name: Drone Support
url: https://docs.drone.io/
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: https://your-drone-server
description: Your self-hosted Drone server
security:
- BearerAuth: []
tags:
- name: System
description: System information.
paths:
/version:
get:
operationId: getVersion
summary: Get system version
description: Returns Drone server version information.
tags:
- System
security: []
responses:
'200':
description: Version information.
content:
application/json:
schema:
$ref: '#/components/schemas/Version'
components:
schemas:
Version:
type: object
description: System version information.
properties:
source:
type: string
version:
type: string
commit:
type: string
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: Bearer token retrieved from the Drone user interface profile page.