PorticoDocs

Admin Missing Titles

Generated admin missing titles operations.

GET/v1/admin/missing-titlesList titles whose files are no longer on disk, oldest first, with when each will be removedadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
list_missing_titles

Parameters

NameInTypeDescription
libraryIdquerystring
cursorquerystring
limitqueryinteger | ""1–200

Responses

200Successapplication/json

Example
{
  "days": 0,
  "items": [
    {
      "id": "id_8h2k4q",
      "kind": "string",
      "libraryId": "id_8h2k4q",
      "missingSince": "string",
      "parentTitle": "Fargo",
      "removedAt": "2026-10-18T19:30:00Z",
      "title": "Fargo",
      "year": 0
    }
  ],
  "nextCursor": "eyJvIjoyMH0",
  "observedAt": "2026-10-18T19:30:00Z",
  "rule": "string",
  "total": 0
}
Schema
  • daysintegerrequired
  • itemsarray of objectrequired
    • idstringrequired
    • kindstringrequired
    • libraryIdstringrequired
    • missingSincestringrequired
    • parentTitlestring
    • removedAtstring
    • titlestringrequired
    • yearinteger
  • nextCursorstring
  • observedAtstring
  • rulestringrequired
  • totalintegerrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesunauthorizednot_permittednot_foundinvalid_requestinternaltimeoutdatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/missing-titles" \
  -H "Authorization: Bearer $PORTICO_API_KEY"
POST/v1/admin/missing-titles/emptyRemove missing titles and missing files now, whatever the owner's rule says; call again while more is trueadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
empty_missing_titles
Max body
4 KiB

Request body application/json

Example
{
  "before": "2026-10-18T19:30:00Z",
  "libraryId": "id_8h2k4q"
}
Schema
  • beforestring (date-time)length 20–64
  • libraryIdstring

Responses

200Successapplication/json

Example
{
  "files": 0,
  "more": true,
  "titles": 0
}
Schema
  • filesintegerrequired
  • morebooleanrequired
  • titlesintegerrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesunauthorizednot_permittednot_foundinvalid_requestinternaltimeoutdatabase_busywriter_capacity

Example request

curl -X POST "http://127.0.0.1:32500/v1/admin/missing-titles/empty" \
  -H "Authorization: Bearer $PORTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"before":"2026-10-18T19:30:00Z","libraryId":"id_8h2k4q"}'