On this page

API

already_exists

HTTP 409. Already exists

What it means

A duplicate slug, version, review or webhook.

What to do

Versions are immutable and unique per item: publish a higher version instead of replacing one. Slugs are unique per owner. Publishing the same files again with the same Idempotency-Key is safe and returns the first result.

Retrying

Do not retry the same request. Change it first.

Example

json
{
  "type": "https://reuseforge.com/docs/api/errors/already_exists",
  "title": "Already exists",
  "status": 409,
  "detail": "Version 1.4.0 of acme/invoice-extractor already exists.",
  "instance": "/api/v1/items/acme/invoice-extractor",
  "code": "already_exists",
  "request_id": "req_c4v8n2m6x1z3"
}

Every error is application/problem+json (RFC 9457). Branch on code, show detail to people and quote request_id when you ask for help. See the error catalogue.