# Vikunja API

**Canonical:** https://apis.io/apis/vikunja/vikunja-api/  
**Provider:** Vikunja — https://apis.io/providers/vikunja/  
**Base URL:** https://dl.vikunja.io  
**Documentation:** https://vikunja.io/docs/api-v2

Vikunja API is one of 2 APIs that [Vikunja](https://apis.io/providers/vikunja/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Vikunja API as documented publicly: 20 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| GET | `/.well-known/openid-configuration` | GET /.well-known/openid-configuration |
| GET | `/api/v1/filters` | List all saved filters |
| PUT | `/api/v1/filters` | Create a saved filter |
| DELETE | `/api/v1/filters/{id}` | Delete a saved filter |
| GET | `/api/v1/filters/{id}` | Get a specific saved filter |
| POST | `/api/v1/filters/{id}` | Update a saved filter |
| GET | `/api/v1/labels` | Lookup label IDs |
| GET | `/api/v1/plugins/user-profile` | GET /api/v1/plugins/user-profile |
| GET | `/api/v1/projects` | Lookup project IDs |
| GET | `/api/v1/projects/{id}/webhooks` | List all webhooks for a project |
| PUT | `/api/v1/projects/{id}/webhooks` | Create a webhook for a project |
| DELETE | `/api/v1/projects/{id}/webhooks/{webhookid}` | Delete a webhook |
| POST | `/api/v1/projects/{id}/webhooks/{webhookid}` | Update a webhook |
| GET | `/api/v1/user/settings/webhooks` | List all webhooks for the current user |
| PUT | `/api/v1/user/settings/webhooks` | Create a user webhook |
| DELETE | `/api/v1/user/settings/webhooks/{webhookid}` | Delete a user webhook |
| POST | `/api/v1/user/settings/webhooks/{webhookid}` | Update a user webhook |
| PATCH | `/api/v2/labels/{labelId}` | PATCH for partial updates |
| POST | `/plugins/webhook` | POST /plugins/webhook |
| GET | `/repos/gpg.key` | GET /repos/gpg.key |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/vikunja/openapi/_ae-authored/vikunja-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/vikunja/json-schema/vikunja-put-api-v1-filters-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/vikunja/json-schema/vikunja-get-api-v1-filters-id-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/vikunja/json-schema/vikunja-get-api-v1-filters-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/vikunja/json-schema/vikunja-post-api-v1-filters-id-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/vikunja/json-schema/vikunja-put-api-v1-filters-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/vikunja/json-schema/vikunja-post-api-v1-filters-id-request-schema.json

## Other Vikunja APIs (1)

- [Vikunja API](https://apis.io/apis/vikunja/vikunja-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/vikunja/vikunja-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/vikunja/.
