Do not miss any Official Secrets API Hub changes, ever again

Subscribe to the Official Secrets API Hub changelog to be up to date on recent changes.

RSS

Changelog

Last update:
v3 - Secrets API (preview)
2026-08-22
5 structure changes including:
5 Modifications
Modified 5 Breaking
GET /api/v3/guest/secret/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • correct_passphrase property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
GET /api/v3/secret/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • correct_passphrase property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
GET /api/v3/secret/{identifier}/status
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • correct_passphrase property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
POST /api/v3/guest/secret/{identifier}/reveal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • correct_passphrase property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
POST /api/v3/secret/{identifier}/reveal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • correct_passphrase property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
v2 - Secrets API (stable)
2026-08-22
4 structure changes including:
4 Modifications
Modified 4 Breaking
GET /api/v2/guest/secret/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • correct_passphrase property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
GET /api/v2/secret/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • correct_passphrase property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
POST /api/v2/guest/secret/{identifier}/reveal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • correct_passphrase property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
POST /api/v2/secret/{identifier}/reveal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • correct_passphrase property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
v3 - Secrets API (preview)
2 structure changes including:
1 Addition
1 Modification
Modified 1
GET /api/v3/version
  • Response
  • 401, 403 responses Added
  • Authentication
  • Session auth, Basic auth authentication methods Added
Added 1
Basic authauthentication method
v2 - Secrets API (stable)
2 structure changes including:
1 Addition
1 Modification
Modified 1
GET /api/v2/version
  • Response
  • 401, 403 responses Added
  • Authentication
  • Session auth, Basic auth authentication methods Added
Added 1
Session authauthentication method
v3 - Secrets API (preview)
2026-07-31
11 structure changes including:
11 Modifications
Modified 11 Breaking
GET /api/v3/guest/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • custid property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
GET /api/v3/receipt/recent
  • Response
  • 200 response Modified
    • application/json content type Modified
      • records property Modified
        • custid property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
      • details property Modified
        • revealed_receipts, pending_receipts properties Modified
GET /api/v3/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • custid property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
PATCH /api/v3/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • custid property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
POST /api/v3/guest/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • custid property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
POST /api/v3/guest/receipts
  • Response
  • 200 response Modified
    • application/json content type Modified
      • records property Modified
        • custid property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
      • details property Modified
        • revealed_receipts, pending_receipts properties Modified
POST /api/v3/guest/secret/conceal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v3/guest/secret/generate
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v3/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • custid property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
POST /api/v3/secret/conceal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v3/secret/generate
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
v3 - Secrets API (preview)
2026-07-07
1 structure change including:
1 Modification
Modified 1
GET /api/incoming/config
  • Response
  • 200 response Modified
    • application/json content type Modified
      • config property Modified
        • secret_max_length property Added
v3 - Secrets API (preview)
2026-07-06
11 structure changes including:
11 Modifications
Modified 11
GET /api/v3/guest/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
GET /api/v3/receipt/recent
  • Response
  • 200 response Modified
    • application/json content type Modified
      • records property Modified
        • source property Added
      • details property Modified
        • revealed_receipts, pending_receipts properties Modified
GET /api/v3/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
PATCH /api/v3/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
POST /api/v3/guest/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
POST /api/v3/guest/receipts
  • Response
  • 200 response Modified
    • application/json content type Modified
      • records property Modified
        • source property Added
      • details property Modified
        • revealed_receipts, pending_receipts properties Modified
POST /api/v3/guest/secret/conceal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v3/guest/secret/generate
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v3/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
POST /api/v3/secret/conceal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v3/secret/generate
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
v2 - Secrets API (stable)
2026-07-06
14 structure changes including:
14 Modifications
Modified 14
GET /api/v2/guest/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
GET /api/v2/private/recent
  • Response
  • 200 response Modified
    • application/json content type Modified
      • records property Modified
        • source property Added
      • details property Modified
        • received, notreceived properties Modified
GET /api/v2/private/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
GET /api/v2/receipt/recent
  • Response
  • 200 response Modified
    • application/json content type Modified
      • records property Modified
        • source property Added
      • details property Modified
        • received, notreceived properties Modified
GET /api/v2/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
PATCH /api/v2/private/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
PATCH /api/v2/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
POST /api/v2/guest/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
POST /api/v2/guest/secret/conceal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v2/guest/secret/generate
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v2/private/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
POST /api/v2/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • share_path, share_url properties Modified
          • Properties are no longer required
          • Type went from string to string | null
        • source property Added
POST /api/v2/secret/conceal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v2/secret/generate
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
v3 - Secrets API (preview)
2026-07-05
5 structure changes including:
5 Modifications
Modified 5
GET /api/v3/guest/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
GET /api/v3/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
PATCH /api/v3/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
POST /api/v3/guest/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
POST /api/v3/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
v2 - Secrets API (stable)
2026-07-05
8 structure changes including:
8 Modifications
Modified 8
GET /api/v2/guest/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
GET /api/v2/private/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
GET /api/v2/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
PATCH /api/v2/private/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
PATCH /api/v2/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
POST /api/v2/guest/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
POST /api/v2/private/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
POST /api/v2/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • first_access, last_access properties Added
v3 - Secrets API (preview)
2026-06-24
5 structure changes including:
5 Modifications
Modified 5
GET /api/v3/guest/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
GET /api/v3/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
PATCH /api/v3/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
POST /api/v3/guest/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
POST /api/v3/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
v2 - Secrets API (stable)
2026-06-24
8 structure changes including:
8 Modifications
Modified 8
GET /api/v2/guest/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
GET /api/v2/private/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
GET /api/v2/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
PATCH /api/v2/private/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
PATCH /api/v2/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
POST /api/v2/guest/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
POST /api/v2/private/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
POST /api/v2/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • expiration property Modified
          • Property is no longer required
          • Type went from number to number | null
v3 - Secrets API (preview)
2026-06-23
24 structure changes including:
24 Modifications
Modified 24
GET /api/incoming/config
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v3/guest/receipt/{identifier}
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v3/guest/secret/{identifier}
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v3/receipt/recent
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v3/receipt/{identifier}
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v3/secret/{identifier}
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v3/secret/{identifier}/status
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v3/status
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v3/supported-locales
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v3/version
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
PATCH /api/v3/receipt/{identifier}
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/incoming/secret
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/incoming/validate
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v3/feedback
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v3/guest/receipt/{identifier}/burn
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v3/guest/receipts
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v3/guest/secret/conceal
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v3/guest/secret/generate
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v3/guest/secret/{identifier}/reveal
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v3/receipt/{identifier}/burn
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v3/secret/conceal
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v3/secret/generate
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v3/secret/status
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v3/secret/{identifier}/reveal
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
v2 - Secrets API (stable)
2026-06-23
23 structure changes including:
23 Modifications
Modified 23
GET /api/v2/guest/receipt/{identifier}
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v2/guest/secret/{identifier}
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v2/private/recent
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v2/private/{identifier}
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v2/receipt/recent
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v2/receipt/{identifier}
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v2/secret/{identifier}
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v2/secret/{identifier}/status
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v2/status
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v2/supported-locales
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v2/version
  • Response
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
PATCH /api/v2/private/{identifier}
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
PATCH /api/v2/receipt/{identifier}
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v2/guest/receipt/{identifier}/burn
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v2/guest/secret/conceal
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v2/guest/secret/generate
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v2/guest/secret/{identifier}/reveal
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v2/private/{identifier}/burn
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v2/receipt/{identifier}/burn
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v2/secret/conceal
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v2/secret/generate
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v2/secret/status
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v2/secret/{identifier}/reveal
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
v1 - Secrets API (legacy)
2026-06-23
18 structure changes including:
18 Modifications
Modified 18
GET /api/v1/authcheck
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v1/metadata/recent
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v1/metadata/{key}
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v1/private/recent
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v1/private/{key}
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v1/receipt/recent
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v1/receipt/{key}
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
GET /api/v1/status
  • Response
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v1/create
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v1/generate
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v1/metadata/{key}
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v1/metadata/{key}/burn
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v1/private/{key}
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v1/private/{key}/burn
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v1/receipt/{key}
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v1/receipt/{key}/burn
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v1/secret/{key}
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
POST /api/v1/share
  • Response
  • 400 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 401 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 403 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 404 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 422 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 429 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
  • 500 response Modified
    • application/json content type Modified
      • message property Modified
        • Property is no longer required
      • error_type, request_id properties Added
v3 - Secrets API (preview)
11 structure changes including:
11 Modifications
Modified 11
GET /api/v3/guest/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
GET /api/v3/receipt/recent
  • Response
  • 200 response Modified
    • application/json content type Modified
      • records property Modified
        • recipient_name property Added
      • details property Modified
        • revealed_receipts, pending_receipts properties Modified
GET /api/v3/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
PATCH /api/v3/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
POST /api/v3/guest/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
POST /api/v3/guest/receipts
  • Response
  • 200 response Modified
    • application/json content type Modified
      • records property Modified
        • recipient_name property Added
      • details property Modified
        • revealed_receipts, pending_receipts properties Modified
POST /api/v3/guest/secret/conceal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v3/guest/secret/generate
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v3/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
POST /api/v3/secret/conceal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v3/secret/generate
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
v2 - Secrets API (stable)
14 structure changes including:
14 Modifications
Modified 14
GET /api/v2/guest/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
GET /api/v2/private/recent
  • Response
  • 200 response Modified
    • application/json content type Modified
      • records property Modified
        • recipient_name property Added
      • details property Modified
        • received, notreceived properties Modified
GET /api/v2/private/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
GET /api/v2/receipt/recent
  • Response
  • 200 response Modified
    • application/json content type Modified
      • records property Modified
        • recipient_name property Added
      • details property Modified
        • received, notreceived properties Modified
GET /api/v2/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
PATCH /api/v2/private/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
PATCH /api/v2/receipt/{identifier}
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
POST /api/v2/guest/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
POST /api/v2/guest/secret/conceal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v2/guest/secret/generate
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v2/private/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
POST /api/v2/receipt/{identifier}/burn
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • recipient_name property Added
POST /api/v2/secret/conceal
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
POST /api/v2/secret/generate
  • Response
  • 200 response Modified
    • application/json content type Modified
      • record property Modified
        • receipt property Modified
v3 - Secrets API (preview)
2026-04-15
2 structure changes including:
2 Modifications
Modified 2
GET /api/incoming/config
  • Response
  • 200 response Modified
    • application/json content type Modified
      • config property Added
POST /api/incoming/secret
  • Response
  • 200 response Modified
    • application/json content type Modified
      • success, message, shrimp, custid, record, details properties Added
v3 - Secrets API (preview)
3 structure changes including:
3 Modifications
Modified 3 Breaking
GET /api/incoming/config
  • Response
  • 200 response Modified
    • application/json content type Modified
      • user_id, shrimp, record, details properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
POST /api/incoming/secret
  • Body
  • application/json content type Modified
    • recipient property Modified
      • Type went from object to string
        Breaking
      • * property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
  • Response
  • 200 response Modified
    • application/json content type Modified
      • success, message, shrimp, custid, record, details properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
POST /api/incoming/validate
  • Response
  • 200 response Modified
    • application/json content type Modified
      • user_id, shrimp, record, details properties Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • recipient, valid properties Added
v2 - Secrets API (stable)
2 structure changes including:
2 Modifications
Modified 2
GET /api/v2/private/recent
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • received, notreceived properties Modified
          • Properties are no longer required
GET /api/v2/receipt/recent
  • Response
  • 200 response Modified
    • application/json content type Modified
      • details property Modified
        • received, notreceived properties Modified
          • Properties are no longer required