Version Pill API

v1.0

Manage your roadmap, changelog, and feature requests programmatically.

https://versionpill.com/api/v1

Introduction

The Version Pill API lets you integrate your product roadmap and changelog into your workflows. Create tasks from CI/CD, publish releases automatically, or build custom integrations.

📋

Tasks

Create, update, and manage roadmap tasks

🚀

Releases

Publish changelog entries programmatically

💡

Ideas

Collect and manage feature requests

Authentication

Authenticated endpoints require a Bearer token. Get your API key from Settings.

curl https://versionpill.com/api/v1/project \
  -H "Authorization: Bearer vp_your_api_key"

Keep your API key secure. Never commit it to version control or expose it in client-side code.

Rate Limits

Endpoint TypeLimitWindow
Authenticated1,000 requestsper hour
Public100 requestsper hour
Idea submission3 requestsper hour per IP

Errors

The API returns standard HTTP status codes and JSON error responses.

CodeDescription
200Success
201Created
400Bad request - check your parameters
401Unauthorized - invalid or missing API key
404Not found
429Rate limit exceeded
500Internal server error

Error response format:

{
  "error": "not_found",
  "message": "Task not found"
}

Public

Project

Tasks

Releases

Ideas