Admin Titles

Generated admin titles operations.

POST/v1/admin/titles/mergeSay that two titles of one library are the same title: the first becomes part of the second, with its files as versions (an album, book, artist or author: its songs, files, albums or books) and everyone's state combinedlibrary

Audience: Clients · Native API
Authorization: API key or personal access token with the library scope, or a signed-in session
OpenAPI operation ID: merge_titles
Max body: 4 KiB

Request body application/json · required

Example

{
  "fileInfo": {
    "occurrence": "string",
    "opening": "string"
  },
  "fromId": "id_8h2k4q",
  "intoId": "id_8h2k4q"
}

Schema

fileInfoobject
- occurrencestringrequired
- openingstringrequired
fromIdstringrequired
intoIdstringrequired

Responses

200Successapplication/json

Example

{
  "itemId": "id_8h2k4q"
}

Schema

itemIdstringrequired

defaultRequest refused or unavailableapplication/json

Example

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

Schema

errorobjectrequired
- codestringrequired
- messagestringrequired

Error codesunauthorizednot_permittednot_foundinvalid_requestinternalstale_continuationmetadata_unavailabletimeoutdatabase_busywriter_capacity

Example request

curl -X POST "http://127.0.0.1:32500/v1/admin/titles/merge" \
  -H "Authorization: Bearer $PORTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileInfo":{"occurrence":"string","opening":"string"},"fromId":"id_8h2k4q","intoId":"id_8h2k4q"}'

POST/v1/admin/titles/separate-artistSay that some albums are not by the artist they are filed under: they move, with their songs' credits, to a new artist of the same name that is never joined back automatically; at least one album stayslibrary

Audience: Clients · Native API
Authorization: API key or personal access token with the library scope, or a signed-in session
OpenAPI operation ID: separate_artist
Max body: 8 KiB

Request body application/json · required

Example

{
  "albumIds": [
    "string"
  ]
}

Schema

albumIdsarray of stringrequired

Responses

200Successapplication/json

Example

{
  "artistId": "id_8h2k4q"
}

Schema

artistIdstringrequired

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/titles/separate-artist" \
  -H "Authorization: Bearer $PORTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"albumIds":["string"]}'