WIP API
Build integrations, automate workflows, and extend WIP with our REST API.
Getting Started
Authenticate your requests with an API key. Pass it as a Bearer token in the Authorization header.
# Fetch your todos
curl https://api.wip.co/v1/todos \
-H "Authorization: Bearer YOUR_API_KEY"
# Create a todo
curl -X POST https://api.wip.co/v1/todos \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "body=Shipped new feature #myproject"
Authentication
API Key
Generate a key in your settings, then pass it with each request. Two options:
- Authorization header (recommended):
Authorization: Bearer YOUR_API_KEY - Query parameter:
?api_key=YOUR_API_KEY— convenient for quick scripts, but the key may be captured in server logs and browser history.
OAuth 2.0
Authenticate WIP users, request their data, and create todos on their behalf. Manage OAuth apps
https://wip.co/oauth/authorize
https://wip.co/oauth/token
https://wip.co/oauth/introspect
https://wip.co/oauth/token/info
Available Endpoints
| Method | Endpoint |
|---|---|
| GET | /v1/todos |
| POST | /v1/todos |
| GET | /v1/users/:id |
| GET | /v1/users/:id/todos |
| GET | /v1/projects |
| GET | /v1/projects/:id/todos |
| POST | /v1/uploads |
| GET | /v1/timeline |
Base URL: https://api.wip.co · Full details in the documentation
Integrations
Community Examples
Usage of the API is subject to our API Terms.
Have questions? Reach out in the Telegram chat.