Woodpecker CI

Woodpecker CI is a free, open-source (Apache-2.0) continuous integration and delivery engine, forked from Drone and maintained by a community organization on GitHub. It is self-hosted: an operator runs a Woodpecker server plus one or more agents (Docker, Kubernetes, or local backends) against a Git forge — GitHub, GitLab, Gitea, Forgejo, or Bitbucket. Pipelines are declared in `.woodpecker/` YAML workflow files validated by a published JSON Schema, and every server exposes a documented Swagger 2.0 REST API under /api covering repositories, pipelines, secrets, registries, crons, agents, forges, orgs and users, plus Server-Sent Event streams for pipeline events and step logs. Agents talk to the server over a published gRPC/protobuf contract. A first-party Go client library (woodpecker-go), a woodpecker-cli command line tool, DEB/RPM packages, container images and a Helm chart are all published by the project.

Woodpecker CI publishes 1 API on the APIs.io network: Server API. Tagged areas include Company, Continuous Integration, Continuous Delivery, DevOps, and Developer Tools.

The Woodpecker CI catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Woodpecker CI’s developer surface includes documentation, API reference, getting-started guide, support, engineering blog, changelog, authentication, and 24 more developer resources.

🌐 Visit website 📡 Source on GitHub

1 APIs

Company Continuous Integration Continuous Delivery DevOps Developer ToolsOpen SourcePipelines Self-Hosted Build Automation Containers

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

JSON Schema 1

Standalone JSON Schema definitions for this provider's data models.

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

GettingStarted

GettingStarted

Sandbox

Sandbox

Documentation 3

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

JSONSchema

JSONSchema

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgentSkill

AgentSkill

LLMsTxt

LLMsTxt

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Lifecycle

Conventions

ErrorCatalog

Conformance

DataModel

Webhooks

Build 5

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

Packages

SDKs

CLI

ToolCrosswalk

Access & Security 4

Authentication, authorization, and security posture

Security

Security

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 4

Status, limits, changes, and where to get help

Support

ChangeLog

Deprecation

RateLimits

Commercial 1

Pricing, plans, and the legal terms of use

Plans

Plans

Company 2

The organization behind the API

Website

Website

Blog

Blog

Other 1

Properties that don't map to a standard resource type

Protobuf

Protobuf

Source (apis.yml)

aid: woodpecker-ci
name: Woodpecker CI
description: 'Woodpecker CI is a free, open-source (Apache-2.0) continuous integration and delivery engine, forked from Drone
  and maintained by a community organization on GitHub. It is self-hosted: an operator runs a Woodpecker server plus one or
  more agents (Docker, Kubernetes, or local backends) against a Git forge — GitHub, GitLab, Gitea, Forgejo, or Bitbucket.
  Pipelines are declared in `.woodpecker/` YAML workflow files validated by a published JSON Schema, and every server exposes
  a documented Swagger 2.0 REST API under /api covering repositories, pipelines, secrets, registries, crons, agents, forges,
  orgs and users, plus Server-Sent Event streams for pipeline events and step logs. Agents talk to the server over a published
  gRPC/protobuf contract. A first-party Go client library (woodpecker-go), a woodpecker-cli command line tool, DEB/RPM packages,
  container images and a Helm chart are all published by the project.'
url: https://raw.githubusercontent.com/api-evangelist/woodpecker-ci/refs/heads/main/apis.yml
image: https://woodpecker-ci.org/img/logo.svg
x-type: company
x-source: harvest:self-hosted-agent-stack
specificationVersion: '0.20'
created: '2026-08-27'
modified: '2026-08-27'
tags:
- Company
- Continuous Integration
- Continuous Delivery
- DevOps
- Developer Tools
- Open Source
- Pipelines
- Self-Hosted
- Build Automation
- Containers
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
apis:
- aid: woodpecker-ci:server-api
  name: Woodpecker CI Server API
  description: The REST API exposed by every Woodpecker CI server under /api. 118 operations across 74 paths covering repositories,
    pipelines, pipeline logs, secrets, registries, cron jobs, agents, forges, organizations, users, queue administration and
    system endpoints, plus Server-Sent Event streams for pipeline events and step logs. Authenticated with a personal access
    token supplied as an Authorization bearer header. Because Woodpecker is self-hosted, the base URL is whatever host the
    operator runs; the project's own public instance at ci.woodpecker-ci.org serves the reference Swagger document.
  humanURL: https://woodpecker-ci.org/api
  baseURL: https://ci.woodpecker-ci.org/api
  tags:
  - Continuous Integration
  - Pipelines
  - DevOps
  - Build Automation
  properties:
  - type: OpenAPI
    url: openapi/woodpecker-ci-server-swagger.json
  - type: Overlay
    url: overlays/woodpecker-ci-server-swagger-overlay.yaml
  - type: Documentation
    url: https://woodpecker-ci.org/docs/intro
  - type: APIReference
    url: https://woodpecker-ci.org/api
  - type: Console
    url: https://ci.woodpecker-ci.org/swagger/index.html
common:
- type: Website
  url: https://woodpecker-ci.org/
- type: DeveloperPortal
  url: https://woodpecker-ci.org/docs/intro
- type: Documentation
  url: https://woodpecker-ci.org/docs/intro
- type: APIReference
  url: https://woodpecker-ci.org/api
- type: GettingStarted
  url: https://woodpecker-ci.org/docs/usage/intro
- type: Support
  url: https://github.com/woodpecker-ci/.github/blob/main/SUPPORT.md
- type: Blog
  url: https://woodpecker-ci.org/blog
- type: GitHubOrganization
  url: https://github.com/woodpecker-ci
- type: ChangeLog
  url: changelog/woodpecker-ci-changelog.yml
- type: Deprecation
  url: https://woodpecker-ci.org/docs/development/deprecations
- type: Lifecycle
  url: lifecycle/woodpecker-ci-lifecycle.yml
- type: Security
  url: https://github.com/woodpecker-ci/.github/blob/main/SECURITY.md
- type: VulnerabilityDisclosure
  url: security/woodpecker-ci-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/woodpecker-ci-domain-security.yml
- type: Authentication
  url: authentication/woodpecker-ci-authentication.yml
- type: Conventions
  url: conventions/woodpecker-ci-conventions.yml
- type: ErrorCatalog
  url: errors/woodpecker-ci-problem-types.yml
- type: Conformance
  url: conformance/woodpecker-ci-conformance.yml
- type: DataModel
  url: data-model/woodpecker-ci-data-model.yml
- type: Packages
  url: packages/woodpecker-ci-packages.yml
- type: SDKs
  url: packages/woodpecker-ci-packages.yml
- type: CLI
  url: cli/woodpecker-ci-cli.yml
- type: Sandbox
  url: sandbox/woodpecker-ci-sandbox.yml
- type: Plans
  url: plans/woodpecker-ci-plans-pricing.yml
- type: RateLimits
  url: rate-limits/woodpecker-ci-rate-limits.yml
- type: Webhooks
  url: asyncapi/woodpecker-ci-events.yml
- type: AgentSkill
  url: skills/_index.yml
- type: ToolCrosswalk
  url: mcp/woodpecker-ci-tool-crosswalk.yml
- type: LLMsTxt
  url: llms/woodpecker-ci-llms.txt
- type: JSONSchema
  url: json-schema/woodpecker-ci-pipeline-schema.json
- type: Protobuf
  url: grpc/woodpecker-ci-rpc.proto
x-enrichment:
  date: '2026-08-27'
  status: enriched
  artifacts_added: 27
  pass: local-v1
x-coverage:
  state: covered
  reason: null
  detail: 'Woodpecker CI publishes a real machine-readable contract: a Swagger 2.0 document with 118 operations served at
    https://ci.woodpecker-ci.org/swagger/doc.json and rendered at https://woodpecker-ci.org/api, plus a draft-07 JSON Schema
    for pipeline files and a proto3 gRPC contract. Nothing was gated, unreadable or blocked.'
  evidence:
  - url: https://ci.woodpecker-ci.org/swagger/doc.json
    status: 200
  - url: https://woodpecker-ci.org/api
    status: 200
  checked: '2026-08-27'

Work with this as data

Every provider 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 providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
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.

All 92 tools

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/woodpecker-ci"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/woodpecker-ci/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/woodpecker-ci/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

Woodpecker CI

APIs 1

Woodpecker CI Server API

Pricing Plans 1

Woodpecker Ci Plans Pricing

Rate Limits 1

Woodpecker Ci Rate Limits

Event Specifications 1

Woodpecker Ci Events