Drone

Drone is a container-native open-source continuous delivery platform owned by Harness. Pipelines are defined in YAML and executed in Docker containers. The Drone server exposes a REST API used by the Drone CLI, dashboard and SDKs; Drone is now positioned as the open-source upstream of Harness Continuous Integration (Drone Enterprise / Harness CI).

1 APIs 0 Features

DevOpsCI/CDContainer-NativeOpen SourceYAMLHarness

APIs

Drone Server REST API

Bearer-token authenticated REST API exposed by every Drone server. Endpoints under /api/ for repos, builds, cron, secrets, users, templates, logs and queue status. Default port ...

Collections

Drone CI REST API

OPEN

Pricing Plans

Drone Ci Plans Pricing

2 plans

PLANS

Rate Limits

Drone Ci Rate Limits

3 limits

RATE LIMITS

FinOps

Drone Ci Finops

FINOPS

Resources

Sources

opencollection: 1.0.0
info:
  name: Drone CI REST API
  version: 1.0.0
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: User
    type: folder
  items:
  - info:
      name: Get the authenticated user
      type: http
    http:
      method: GET
      url: https://drone.example.com/api/user
    docs: Get the authenticated user
- info:
    name: Builds
    type: folder
  items:
  - info:
      name: List recent builds across repositories
      type: http
    http:
      method: GET
      url: https://drone.example.com/api/builds
    docs: List recent builds across repositories
  - info:
      name: List builds for a repository
      type: http
    http:
      method: GET
      url: https://drone.example.com/api/repos/:owner/:repo/builds
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
    docs: List builds for a repository
  - info:
      name: Trigger a new build for a repository
      type: http
    http:
      method: POST
      url: https://drone.example.com/api/repos/:owner/:repo/builds
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
    docs: Trigger a new build for a repository
  - info:
      name: Get a single build
      type: http
    http:
      method: GET
      url: https://drone.example.com/api/repos/:owner/:repo/builds/:build
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
      - name: build
        value: ''
        type: path
    docs: Get a single build
  - info:
      name: Approve a build awaiting approval
      type: http
    http:
      method: POST
      url: https://drone.example.com/api/repos/:owner/:repo/builds/:build/approve
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
      - name: build
        value: ''
        type: path
    docs: Approve a build awaiting approval
  - info:
      name: Decline a build awaiting approval
      type: http
    http:
      method: POST
      url: https://drone.example.com/api/repos/:owner/:repo/builds/:build/decline
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
      - name: build
        value: ''
        type: path
    docs: Decline a build awaiting approval
  - info:
      name: Promote a build to a target environment
      type: http
    http:
      method: POST
      url: https://drone.example.com/api/repos/:owner/:repo/builds/:build/promote
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
      - name: build
        value: ''
        type: path
    docs: Promote a build to a target environment
  - info:
      name: Restart a previously completed build
      type: http
    http:
      method: POST
      url: https://drone.example.com/api/repos/:owner/:repo/builds/:build/restart
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
      - name: build
        value: ''
        type: path
    docs: Restart a previously completed build
  - info:
      name: Stop a running build
      type: http
    http:
      method: POST
      url: https://drone.example.com/api/repos/:owner/:repo/builds/:build/stop
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
      - name: build
        value: ''
        type: path
    docs: Stop a running build
  - info:
      name: Stream logs for a step within a build
      type: http
    http:
      method: GET
      url: https://drone.example.com/api/repos/:owner/:repo/builds/:build/logs/:stage/:step
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
      - name: build
        value: ''
        type: path
      - name: stage
        value: ''
        type: path
      - name: step
        value: ''
        type: path
    docs: Stream logs for a step within a build
- info:
    name: Cron
    type: folder
  items:
  - info:
      name: List cron jobs for a repository
      type: http
    http:
      method: GET
      url: https://drone.example.com/api/repos/:owner/:repo/cron
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
    docs: List cron jobs for a repository
  - info:
      name: Create a cron job for a repository
      type: http
    http:
      method: POST
      url: https://drone.example.com/api/repos/:owner/:repo/cron
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
    docs: Create a cron job for a repository
- info:
    name: Secrets
    type: folder
  items:
  - info:
      name: List secrets for a repository
      type: http
    http:
      method: GET
      url: https://drone.example.com/api/repos/:owner/:repo/secrets
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
    docs: List secrets for a repository
  - info:
      name: Create a secret for a repository
      type: http
    http:
      method: POST
      url: https://drone.example.com/api/repos/:owner/:repo/secrets
      params:
      - name: owner
        value: ''
        type: path
      - name: repo
        value: ''
        type: path
    docs: Create a secret for a repository
- info:
    name: Templates
    type: folder
  items:
  - info:
      name: List pipeline templates
      type: http
    http:
      method: GET
      url: https://drone.example.com/api/templates
    docs: List pipeline templates
  - info:
      name: Create a pipeline template
      type: http
    http:
      method: POST
      url: https://drone.example.com/api/templates
    docs: Create a pipeline template
bundled: true