{"openapi":"3.0.1","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"http://localhost","description":"Generated server url"}],"tags":[{"name":"Record preview","description":"Inline previews of title and product records"},{"name":"tenant","description":"the tenant API"},{"name":"Z39.50","description":"Backend for the Z39.50 gateway (tr/zserver)"},{"name":"Reports","description":"Report generation API"}],"paths":{"/titles/{id}":{"get":{"tags":["title-controller"],"description":"\n\n**Required permissions:** `titles.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getTitleById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Title"}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["titles.item.get"]},"put":{"tags":["title-controller"],"description":"\n\n**Required permissions:** `titles.item.put` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"putTitleById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Title"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"titles.item.put":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["titles.item.put"]},"delete":{"tags":["title-controller"],"description":"\n\n**Required permissions:** `titles.item.delete` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"deleteTitleById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"titles.item.delete":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["titles.item.delete"]}},"/title-subjects/{id}/set-main/{titleId}":{"put":{"tags":["title-subject-controller"],"description":"\n\n**Required permissions:** `title-subjects.item.set-main.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"setTitleSubjectAsMain","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"titleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"title-subjects.item.set-main.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["title-subjects.item.set-main.post"]}},"/publisher-prefixes/{id}":{"get":{"tags":["publisher-prefix-controller"],"description":"\n\n**Required permissions:** `publisher-prefixes.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getPublisherPrefixById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherPrefix"}}}}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefixes.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["publisher-prefixes.item.get"]},"put":{"tags":["publisher-prefix-controller"],"description":"\n\n**Required permissions:** `publisher-prefixes.item.put` (Role: Pracovník agentury, Administrátor)","operationId":"putPublisherPrefixById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublisherPrefix"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefixes.item.put":["Pracovník agentury","Administrátor"]},"x-permissions-required":["publisher-prefixes.item.put"]}},"/publisher-prefix-ranges/{id}":{"get":{"tags":["publisher-prefix-range-controller"],"description":"\n\n**Required permissions:** `publisher-prefix-ranges.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getPublisherPrefixRangeById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherPrefixRange"}}}}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefix-ranges.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["publisher-prefix-ranges.item.get"]},"put":{"tags":["publisher-prefix-range-controller"],"description":"\n\n**Required permissions:** `publisher-prefix-ranges.item.put` (Role: Pracovník agentury, Administrátor)","operationId":"putPublisherPrefixRangeById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublisherPrefixRange"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefix-ranges.item.put":["Pracovník agentury","Administrátor"]},"x-permissions-required":["publisher-prefix-ranges.item.put"]},"delete":{"tags":["publisher-prefix-range-controller"],"description":"\n\n**Required permissions:** `publisher-prefix-ranges.item.delete` (Role: Pracovník agentury, Administrátor)","operationId":"deletePublisherPrefixRangeById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefix-ranges.item.delete":["Pracovník agentury","Administrátor"]},"x-permissions-required":["publisher-prefix-ranges.item.delete"]}},"/products/{id}":{"get":{"tags":["product-controller"],"description":"\n\n**Required permissions:** `products.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getProductById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Product"}}}}},"x-permission-status":"protected","x-permission-roles":{"products.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["products.item.get"]},"put":{"tags":["product-controller"],"description":"\n\n**Required permissions:** `products.item.put` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"putProduct","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"products.item.put":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["products.item.put"]},"delete":{"tags":["product-controller"],"description":"\n\n**Required permissions:** `products.item.delete` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"deleteProductById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"products.item.delete":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["products.item.delete"]}},"/product-numbers/{productNumberId}/unblock":{"put":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.item.unblock.put` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"unblockProductNumber","parameters":[{"name":"productNumberId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"204":{"description":"Product number successfully unblocked and made available for assignment"}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.item.unblock.put":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.item.unblock.put"]}},"/product-numbers/{productNumberId}/block":{"put":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.item.block.put` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"blockProductNumber","parameters":[{"name":"productNumberId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductNumberBlockRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"204":{"description":"Product number successfully blocked and marked as unavailable for assignment"}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.item.block.put":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.item.block.put"]}},"/product-numbers/block-range":{"put":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.block-range.put` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"blockProductNumberRange","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductNumberBlockRangeRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Range of product numbers blocked successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumberBlockRangeResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.block-range.put":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.block-range.put"]}},"/onix-codetables/{id}":{"get":{"tags":["onix-codetable-controller"],"description":"\n\n**Required permissions:** `onix-codetables.item.get` (Role: Správce ONIX kódových tabulek, Administrátor)","operationId":"getOnixCodetableById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OnixCodetable"}}}}},"x-permission-status":"protected","x-permission-roles":{"onix-codetables.item.get":["Správce ONIX kódových tabulek","Administrátor"]},"x-permissions-required":["onix-codetables.item.get"]},"put":{"tags":["onix-codetable-controller"],"description":"\n\n**Required permissions:** `onix-codetables.item.put` (Role: Správce ONIX kódových tabulek, Administrátor)","operationId":"putOnixCodetableById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnixCodetable"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"onix-codetables.item.put":["Správce ONIX kódových tabulek","Administrátor"]},"x-permissions-required":["onix-codetables.item.put"]},"delete":{"tags":["onix-codetable-controller"],"description":"\n\n**Required permissions:** `onix-codetables.item.delete` (Role: Správce ONIX kódových tabulek, Administrátor)","operationId":"deleteOnixCodetableById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"onix-codetables.item.delete":["Správce ONIX kódových tabulek","Administrátor"]},"x-permissions-required":["onix-codetables.item.delete"]}},"/onix-codetable-items/{id}":{"get":{"tags":["onix-codetable-item-controller"],"description":"\n\n**Required permissions:** `onix-codetable-items.item.get` (Role: Správce ONIX kódových tabulek, Administrátor)","operationId":"getOnixCodetableItemById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OnixCodetableItem"}}}}},"x-permission-status":"protected","x-permission-roles":{"onix-codetable-items.item.get":["Správce ONIX kódových tabulek","Administrátor"]},"x-permissions-required":["onix-codetable-items.item.get"]},"put":{"tags":["onix-codetable-item-controller"],"description":"\n\n**Required permissions:** `onix-codetable-items.item.put` (Role: Správce ONIX kódových tabulek, Administrátor)","operationId":"putOnixCodetableItemById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnixCodetableItem"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"onix-codetable-items.item.put":["Správce ONIX kódových tabulek","Administrátor"]},"x-permissions-required":["onix-codetable-items.item.put"]},"delete":{"tags":["onix-codetable-item-controller"],"description":"\n\n**Required permissions:** `onix-codetable-items.item.delete` (Role: Správce ONIX kódových tabulek, Administrátor)","operationId":"deleteOnixCodetableItemById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"onix-codetable-items.item.delete":["Správce ONIX kódových tabulek","Administrátor"]},"x-permissions-required":["onix-codetable-items.item.delete"]}},"/natural-persons/{id}":{"get":{"tags":["natural-person-controller"],"description":"\n\n**Required permissions:** `natural-persons.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getNaturalPersonById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NaturalPerson"}}}}},"x-permission-status":"protected","x-permission-roles":{"natural-persons.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["natural-persons.item.get"]},"put":{"tags":["natural-person-controller"],"description":"\n\n**Required permissions:** `natural-persons.item.put` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"putNaturalPersonById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NaturalPerson"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"natural-persons.item.put":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["natural-persons.item.put"]},"delete":{"tags":["natural-person-controller"],"description":"\n\n**Required permissions:** `natural-persons.item.delete` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"deleteNaturalPersonById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"natural-persons.item.delete":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["natural-persons.item.delete"]}},"/legal-persons/{id}":{"get":{"tags":["legal-person-controller"],"description":"\n\n**Required permissions:** `legal-persons.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getLegalPersonById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Legal person not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal server error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"200":{"description":"Legal person found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegalPerson"}}}}},"x-permission-status":"protected","x-permission-roles":{"legal-persons.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["legal-persons.item.get"]},"put":{"tags":["legal-person-controller"],"description":"\n\n**Required permissions:** `legal-persons.item.put` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"putLegalPersonById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalPerson"}}},"required":true},"responses":{"404":{"description":"Legal person not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal server error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"204":{"description":"Legal person updated successfully"}},"x-permission-status":"protected","x-permission-roles":{"legal-persons.item.put":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["legal-persons.item.put"]},"delete":{"tags":["legal-person-controller"],"description":"\n\n**Required permissions:** `legal-persons.item.delete` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"deleteLegalPersonById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Legal person not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Legal person has child records and cannot be deleted","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal server error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"204":{"description":"Legal person deleted successfully"}},"x-permission-status":"protected","x-permission-roles":{"legal-persons.item.delete":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["legal-persons.item.delete"]}},"/collections/{id}":{"get":{"tags":["collection-controller"],"description":"\n\n**Required permissions:** `collections.item.get` (Role: Pracovník agentury, Správce sbírek, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getCollectionById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Collection"}}}}},"x-permission-status":"protected","x-permission-roles":{"collections.item.get":["Pracovník agentury","Správce sbírek","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["collections.item.get"]},"put":{"tags":["collection-controller"],"description":"\n\n**Required permissions:** `collections.item.put` (Role: Pracovník agentury, Správce sbírek, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"putCollectionById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collection"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"collections.item.put":["Pracovník agentury","Správce sbírek","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["collections.item.put"]},"delete":{"tags":["collection-controller"],"description":"\n\n**Required permissions:** `collections.item.delete` (Role: Pracovník agentury, Správce sbírek, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"deleteCollectionById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"collections.item.delete":["Pracovník agentury","Správce sbírek","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["collections.item.delete"]}},"/admin/authority-update/schedule":{"put":{"tags":["authority-update-controller"],"summary":"Update the authority-update schedule","description":"Sets the cron expression and enabled flag.\n\n**Required permissions:** `agency.admin.authority-update.schedule.execute` (Role: žádná role)","operationId":"updateSchedule","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorityUpdateSchedule"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AuthorityUpdateSchedule"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.authority-update.schedule.execute":[]},"x-permissions-required":["agency.admin.authority-update.schedule.execute"]}},"/titles":{"get":{"tags":["title-controller"],"description":"\n\n**Required permissions:** `titles.collection.get` (Role: Pracovník agentury, Distributor, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getTitleCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}},{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TitleCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.collection.get":["Pracovník agentury","Distributor","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["titles.collection.get"]},"post":{"tags":["title-controller"],"description":"\n\n**Required permissions:** `titles.collection.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"postTitle","parameters":[{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Title"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Title"}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.collection.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["titles.collection.post"]}},"/titles/{titleId}/aleph-sync":{"post":{"tags":["aleph-title-sync-controller"],"description":"\n\n**Required permissions:** `titles.aleph-sync.post` (Role: Pracovník agentury, Administrátor)","operationId":"syncTitle","parameters":[{"name":"titleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"force","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.aleph-sync.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["titles.aleph-sync.post"]}},"/titles/{titleId}/aleph-sync/reset":{"post":{"tags":["aleph-title-sync-controller"],"description":"\n\n**Required permissions:** `titles.aleph-sync.reset.post` (Role: Pracovník agentury, Administrátor)","operationId":"resetPermanentlyFailed","parameters":[{"name":"titleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"titles.aleph-sync.reset.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["titles.aleph-sync.reset.post"]}},"/titles/receive":{"post":{"tags":["title-controller"],"description":"\n\n**Required permissions:** `titles.receive.post` (Role: Externí nakladatelský systém, Administrátor)","operationId":"receiveTitle","parameters":[{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TitleMessage"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"201":{"description":"Title received and processed successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Title"}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.receive.post":["Externí nakladatelský systém","Administrátor"]},"x-permissions-required":["titles.receive.post"]}},"/titles/data-import/upload":{"post":{"tags":["title-import-controller"],"description":"\n\n**Required permissions:** `titles.data-import.upload.post` (Role: Pracovník agentury, Administrátor)","operationId":"uploadTitleFile","requestBody":{"content":{"application/json":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"titles.data-import.upload.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["titles.data-import.upload.post"]}},"/titles/data-import/owncloud/import":{"post":{"tags":["title-import-controller"],"description":"\n\n**Required permissions:** `titles.data-import.owncloud.import.post` (Role: Pracovník agentury, Administrátor)","operationId":"importFromOwnCloud","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OwnCloudImportRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.data-import.owncloud.import.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["titles.data-import.owncloud.import.post"]}},"/titles/aleph-sync/resync":{"post":{"tags":["aleph-title-sync-controller"],"description":"\n\n**Required permissions:** `titles.aleph-sync.resync.post` (Role: žádná role)","operationId":"resyncTitles","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResyncRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.aleph-sync.resync.post":[]},"x-permissions-required":["titles.aleph-sync.resync.post"]}},"/thema-import/start":{"post":{"tags":["thema-import-controller"],"description":"\n\n**Required permissions:** `thema-import.start.post` (Role: Pracovník agentury, Administrátor)","operationId":"startImport","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"x-permission-status":"protected","x-permission-roles":{"thema-import.start.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["thema-import.start.post"]}},"/storage/upload":{"post":{"tags":["storage-controller"],"description":"\n\n**Required permissions:** `agency.storage.upload.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"upload","requestBody":{"content":{"application/json":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StorageUploadResponseDto"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.storage.upload.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["agency.storage.upload.post"]}},"/reports/wipo-report":{"post":{"tags":["Reports"],"summary":"Generate WIPO Report","description":"Generates WIPO statistics — total registered identifiers and count for a given year. Returns JSON data for inline display (no file download).\n\n**Required permissions:** `reports.wipo-report.post` (Role: Pracovník agentury, Administrátor)","operationId":"generateWipoReport","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WipoReportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report data generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WipoReportData"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WipoReportData"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.wipo-report.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["reports.wipo-report.post"]}},"/reports/sckn-report":{"post":{"tags":["Reports"],"summary":"Generate SČKN Report","description":"Generates SČKN report — publisher statistics grouped by ARES legal form with TOP 50 rankings for commercial, university, and municipality groups. Returns JSON data for inline display (no file download).\n\n**Required permissions:** `reports.sckn-report.post` (Role: Pracovník agentury, Administrátor)","operationId":"generateScknReport","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScknReportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report data generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ScknReportData"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ScknReportData"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.sckn-report.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["reports.sckn-report.post"]}},"/reports/progress-report":{"post":{"tags":["Reports"],"summary":"Generate Progress Report","description":"Generates ISBN Agency Progress Report for International ISBN Agency\n\n**Required permissions:** `reports.progress-report.post` (Role: Pracovník agentury, Administrátor)","operationId":"generateProgressReport","parameters":[{"name":"format","in":"query","description":"Output format","required":false,"schema":{"type":"string","default":"PDF","enum":["PDF","DOCX","XLSX","XML","CSV"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressReportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Report generation failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.progress-report.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["reports.progress-report.post"]}},"/reports/piid-report":{"post":{"tags":["Reports"],"summary":"Generate PIID Report","description":"Generates PIID report CSV for international ISBN/ISMN agencies\n\n**Required permissions:** `reports.piid-report.post` (Role: Pracovník agentury, Administrátor)","operationId":"generatePiidReport","parameters":[{"name":"format","in":"query","description":"Output format (only CSV supported)","required":false,"schema":{"type":"string","default":"CSV","enum":["PDF","DOCX","XLSX","XML","CSV"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PiidExportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Report generation failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.piid-report.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["reports.piid-report.post"]}},"/reports/performance-statistics":{"post":{"tags":["Reports"],"summary":"Generate Performance Statistics Report","description":"Generates performance statistics report for agency workers. Returns XLSX file.\n\n**Required permissions:** `reports.performance-statistics.post` (Role: Pracovník agentury, Administrátor)","operationId":"generatePerformanceStatistics","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerformanceStatisticsParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Report generation failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.performance-statistics.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["reports.performance-statistics.post"]}},"/reports/onix-export":{"post":{"tags":["Reports"],"summary":"Generate ONIX Export","description":"Generates ONIX 3.0 XML export of titles and products. Supports filtering by date range, title IDs, and ISBNs.\n\n**Required permissions:** `reports.onix-export.post` (Role: Pracovník agentury, Administrátor)","operationId":"generateOnixExport","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnixExportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Export generation failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Export generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.onix-export.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["reports.onix-export.post"]}},"/reports/nipos-report":{"post":{"tags":["Reports"],"summary":"Generate NIPOS Report","description":"Generates NIPOS report (XLSX) with publisher statistics: product counts split by physical/online\n\n**Required permissions:** `reports.nipos-report.post` (Role: Pracovník agentury, Administrátor)","operationId":"generateNiposReport","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NiposReportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Report generation failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.nipos-report.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["reports.nipos-report.post"]}},"/reports/kult-18-01":{"post":{"tags":["Reports"],"summary":"Generate Kult 18-01 Report","description":"Generates Kult (MK) 18-01 annual publisher statistics. Contains publisher identification (pre-filled from ARES) and Part I product counts. Returns JSON data for inline display.\n\n**Required permissions:** `reports.kult-18-01.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"generateKult1801Report","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kult1801ReportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report data generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Kult1801ReportData"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Kult1801ReportData"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.kult-18-01.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["reports.kult-18-01.post"]}},"/reports/kult-18-01/export":{"post":{"tags":["Reports"],"summary":"Generate Kult 18-01 Report (file export)","description":"Generates Kult (MK) 18-01 report as a downloadable file with publisher identification and product counts. Returns fileId for download.\n\n**Required permissions:** `reports.kult-18-01.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"generateKult1801Export","parameters":[{"name":"format","in":"query","description":"Output format","required":false,"schema":{"type":"string","default":"XLSX","enum":["PDF","DOCX","XLSX","XML","CSV"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kult1801ReportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Report generation failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.kult-18-01.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["reports.kult-18-01.post"]}},"/reports/kult-15-01":{"post":{"tags":["Reports"],"summary":"Generate Kult 15-01 Report","description":"Generates Kult (MK) 15-01 annual statistics of non-periodical publications. Contains three parts: titles by MDT classification, by publication language, and translations by original language. Returns JSON data for inline display.\n\n**Required permissions:** `reports.kult-15-01.post` (Role: Pracovník agentury, Administrátor)","operationId":"generateKult1501Report","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kult1501ReportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report data generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Kult1501ReportData"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Kult1501ReportData"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.kult-15-01.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["reports.kult-15-01.post"]}},"/reports/kult-15-01/export":{"post":{"tags":["Reports"],"summary":"Generate Kult 15-01 Report (file export)","description":"Generates Kult (MK) 15-01 report as a downloadable file with 3 sheets: MDT classification, publication languages, and translations. Returns fileId for download via /reports/download/{fileId}.\n\n**Required permissions:** `reports.kult-15-01.post` (Role: Pracovník agentury, Administrátor)","operationId":"generateKult1501Export","parameters":[{"name":"format","in":"query","description":"Output format","required":false,"schema":{"type":"string","default":"XLSX","enum":["PDF","DOCX","XLSX","XML","CSV"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kult1501ReportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Report generation failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.kult-15-01.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["reports.kult-15-01.post"]}},"/reports/ipa-report":{"post":{"tags":["Reports"],"summary":"Generate IPA Report","description":"Counts active (non-closed) publishers for a given agency as of 31 December of the given year. Returns JSON data for inline display (no file download).\n\n**Required permissions:** `reports.ipa-report.post` (Role: Pracovník agentury, Administrátor)","operationId":"generateIpaReport","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IpaReportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report data generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IpaReportData"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IpaReportData"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.ipa-report.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["reports.ipa-report.post"]}},"/reports/identifier-report":{"post":{"tags":["Reports"],"summary":"Generate Identifier Report","description":"Generates SpreadsheetML XML report for all ISBNs assigned to a publisher prefix. Includes real-time Z39.50 lookups to CNB/SKC catalogs.\n\n**Required permissions:** `reports.identifier-report.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"generateIdentifierReport","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentifierReportParams"}}},"required":true},"responses":{"404":{"description":"Publisher prefix not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Report generation failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.identifier-report.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["reports.identifier-report.post"]}},"/reports/cleanup-storage":{"post":{"tags":["Reports"],"summary":"Clean up expired report files","description":"Removes report files older than configured expiration period. Intended for scheduled execution.\n\n**Required permissions:** `agency.execute-scheduled-job.execute` (Role: žádná role)","operationId":"cleanupStorage","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"204":{"description":"Cleanup completed successfully"}},"x-permission-status":"protected","x-permission-roles":{"agency.execute-scheduled-job.execute":[]},"x-permissions-required":["agency.execute-scheduled-job.execute"]}},"/reports/annual-report":{"post":{"tags":["Reports"],"summary":"Generate Annual Report","description":"Generates annual report data for NK ČR. Returns JSON data for inline display (no file download).\n\n**Required permissions:** `reports.annual-report.post` (Role: Pracovník agentury, Administrátor)","operationId":"generateAnnualReport","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnualReportParams"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report data generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AnnualReportData"}}}},"400":{"description":"Invalid parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AnnualReportData"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.annual-report.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["reports.annual-report.post"]}},"/publisher-prefixes/{id}/transfer":{"post":{"tags":["publisher-prefix-controller"],"description":"\n\n**Required permissions:** `publisher-prefixes.transfer.item.post` (Role: žádná role)","operationId":"transferPublisherPrefix","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublisherPrefixTransferRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherPrefix"}}}}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefixes.transfer.item.post":[]},"x-permissions-required":["publisher-prefixes.transfer.item.post"]}},"/publisher-prefixes/{id}/last-used-number":{"post":{"tags":["publisher-prefix-controller"],"description":"\n\n**Required permissions:** `publisher-prefixes.last-used-number.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"declareLastUsedNumber","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublisherPrefixLastUsedNumberRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Declaration stored; product numbers up to the declared one are blocked","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherPrefixDeclarationResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefixes.last-used-number.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["publisher-prefixes.last-used-number.post"]}},"/publisher-prefix-ranges":{"get":{"tags":["publisher-prefix-range-controller"],"description":"\n\n**Required permissions:** `publisher-prefix-ranges.collection.get` (Role: Pracovník agentury, Distributor, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getPublisherPrefixRangeCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherPrefixRangeCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefix-ranges.collection.get":["Pracovník agentury","Distributor","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["publisher-prefix-ranges.collection.get"]},"post":{"tags":["publisher-prefix-range-controller"],"description":"\n\n**Required permissions:** `publisher-prefix-ranges.collection.post` (Role: Pracovník agentury, Administrátor)","operationId":"postPublisherPrefixRange","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublisherPrefixRange"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherPrefixRange"}}}}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefix-ranges.collection.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["publisher-prefix-ranges.collection.post"]}},"/publisher-prefix-ranges/{id}/open":{"post":{"tags":["publisher-prefix-range-controller"],"description":"\n\n**Required permissions:** `publisher-prefix-ranges.open.item.post` (Role: Pracovník agentury, Administrátor)","operationId":"openPublisherPrefixRange","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefix-ranges.open.item.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["publisher-prefix-ranges.open.item.post"]}},"/publisher-prefix-ranges/{id}/close":{"post":{"tags":["publisher-prefix-range-controller"],"description":"\n\n**Required permissions:** `publisher-prefix-ranges.close.item.post` (Role: Pracovník agentury, Administrátor)","operationId":"closePublisherPrefixRange","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefix-ranges.close.item.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["publisher-prefix-ranges.close.item.post"]}},"/products":{"get":{"tags":["product-controller"],"description":"\n\n**Required permissions:** `products.collection.get` (Role: Pracovník agentury, Distributor, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getProductCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}},{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"products.collection.get":["Pracovník agentury","Distributor","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["products.collection.get"]},"post":{"tags":["product-controller"],"description":"\n\n**Required permissions:** `products.collection.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"postProduct","parameters":[{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Product"}}}}},"x-permission-status":"protected","x-permission-roles":{"products.collection.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["products.collection.post"]}},"/products/receive":{"post":{"tags":["product-controller"],"description":"\n\n**Required permissions:** `products.receive.post` (Role: žádná role)","operationId":"receiveProduct","parameters":[{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductMessage"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"201":{"description":"Product received and processed successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Product"}}}}},"x-permission-status":"protected","x-permission-roles":{"products.receive.post":[]},"x-permissions-required":["products.receive.post"]}},"/products/create-with-number":{"post":{"tags":["product-controller"],"description":"\n\n**Required permissions:** `products.create-with-number.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"createProductWithNumber","parameters":[{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductCreateWithNumberRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"201":{"description":"Product created; product number assigned in the same request when possible","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductCreateWithNumberResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"products.create-with-number.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["products.create-with-number.post"]}},"/product-numbers":{"get":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getProductNumberCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumberCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.item.get"]},"post":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.collection.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"postProductNumber","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductNumberCreateRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumber"}}}}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.collection.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.collection.post"]}},"/product-numbers/{productNumberId}/deselect":{"post":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.item.deselect.post` (Role: žádná role)","operationId":"deselectProductNumber","parameters":[{"name":"productNumberId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"204":{"description":"Product number deselected successfully"}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.item.deselect.post":[]},"x-permissions-required":["product-numbers.item.deselect.post"]}},"/product-numbers/{productNumberId}/assign-title":{"post":{"tags":["product-number-controller"],"summary":"Legalize a blocked product number by assigning an existing title to it","description":"Links an existing title (a product without a number) to an already blocked ISBN/ISMN and lifts the block, so numbers a publisher allocated before the registry existed can be legalized. Allowed only for blocked numbers with reason PRESUMED_PUBLISHED or USED_BEFORE_REGISTRY, only for an agency worker, and only when the number belongs to the title's owner publisher.\n\n**Required permissions:** `product-numbers.item.assign-title.post` (Role: Pracovník agentury, Administrátor)","operationId":"assignTitleToBlockedProductNumber","parameters":[{"name":"productNumberId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductNumberAssignTitleRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Title assigned; the number is now unblocked and assigned","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumber"}}}}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.item.assign-title.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["product-numbers.item.assign-title.post"]}},"/product-numbers/clear-selected":{"post":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `agency.execute-scheduled-job.execute` (Role: žádná role)","operationId":"clearSelectedProductNumbers","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"202":{"description":"Accepted","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumber"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.execute-scheduled-job.execute":[]},"x-permissions-required":["agency.execute-scheduled-job.execute"]}},"/product-numbers/assign":{"post":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.assign.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"assignProductNumber","parameters":[{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductNumberAssignRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumber"}}}}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.assign.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.assign.post"]}},"/product-numbers/assign/preview":{"post":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.assign.preview.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"previewProductNumberAssignment","parameters":[{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductNumberAssignRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumberAssignResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.assign.preview.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.assign.preview.post"]}},"/onix-codetables":{"get":{"tags":["onix-codetable-controller"],"description":"\n\n**Required permissions:** `onix-codetables.collection.get` (Role: Admin povinných výtisků, Pracovník agentury, Správce sbírek, Distributor, Externí nakladatelský systém, Knihovník PV - monografie, Knihovník PV - periodika, Správce ONIX kódových tabulek, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getOnixCodetableCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OnixCodetableCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"onix-codetables.collection.get":["Admin povinných výtisků","Pracovník agentury","Správce sbírek","Distributor","Externí nakladatelský systém","Knihovník PV - monografie","Knihovník PV - periodika","Správce ONIX kódových tabulek","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["onix-codetables.collection.get"]},"post":{"tags":["onix-codetable-controller"],"description":"\n\n**Required permissions:** `onix-codetables.collection.post` (Role: Správce ONIX kódových tabulek, Administrátor)","operationId":"postOnixCodetable","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnixCodetable"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OnixCodetable"}}}}},"x-permission-status":"protected","x-permission-roles":{"onix-codetables.collection.post":["Správce ONIX kódových tabulek","Administrátor"]},"x-permissions-required":["onix-codetables.collection.post"]}},"/onix-codetable-items":{"get":{"tags":["onix-codetable-item-controller"],"description":"\n\n**Required permissions:** `onix-codetable-items.collection.get` (Role: Admin povinných výtisků, Pracovník agentury, Správce sbírek, Distributor, Externí nakladatelský systém, Knihovník PV - monografie, Knihovník PV - periodika, Správce ONIX kódových tabulek, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getOnixCodetableItemCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OnixCodetableItemCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"onix-codetable-items.collection.get":["Admin povinných výtisků","Pracovník agentury","Správce sbírek","Distributor","Externí nakladatelský systém","Knihovník PV - monografie","Knihovník PV - periodika","Správce ONIX kódových tabulek","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["onix-codetable-items.collection.get"]},"post":{"tags":["onix-codetable-item-controller"],"description":"\n\n**Required permissions:** `onix-codetable-items.collection.post` (Role: Správce ONIX kódových tabulek, Administrátor)","operationId":"postOnixCodetableItem","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnixCodetableItem"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OnixCodetableItem"}}}}},"x-permission-status":"protected","x-permission-roles":{"onix-codetable-items.collection.post":["Správce ONIX kódových tabulek","Administrátor"]},"x-permissions-required":["onix-codetable-items.collection.post"]}},"/natural-persons":{"get":{"tags":["natural-person-controller"],"description":"\n\n**Required permissions:** `natural-persons.collection.get` (Role: Pracovník agentury, Distributor, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getNaturalPersonCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NaturalPersonCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"natural-persons.collection.get":["Pracovník agentury","Distributor","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["natural-persons.collection.get"]},"post":{"tags":["natural-person-controller"],"description":"\n\n**Required permissions:** `natural-persons.collection.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"postNaturalPerson","parameters":[{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NaturalPerson"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NaturalPerson"}}}}},"x-permission-status":"protected","x-permission-roles":{"natural-persons.collection.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["natural-persons.collection.post"]}},"/natural-persons/report-change":{"post":{"tags":["natural-person-controller"],"description":"\n\n**Required permissions:** `natural-persons.report-change.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"reportChangeToNaturalPerson","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NaturalPersonReportChangeRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"natural-persons.report-change.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["natural-persons.report-change.post"]}},"/legal-persons":{"get":{"tags":["legal-person-controller"],"description":"\n\n**Required permissions:** `legal-persons.collection.get` (Role: Pracovník agentury, Distributor, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getLegalPersonCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal server error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"200":{"description":"Legal persons collection retrieved successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegalPersonCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"legal-persons.collection.get":["Pracovník agentury","Distributor","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["legal-persons.collection.get"]},"post":{"tags":["legal-person-controller"],"description":"\n\n**Required permissions:** `legal-persons.collection.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"postLegalPerson","parameters":[{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalPerson"}}},"required":true},"responses":{"404":{"description":"Publisher not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal server error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"201":{"description":"Legal person created successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/LegalPerson"}}}}},"x-permission-status":"protected","x-permission-roles":{"legal-persons.collection.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["legal-persons.collection.post"]}},"/legal-persons/report-change":{"post":{"tags":["legal-person-controller"],"description":"\n\n**Required permissions:** `legal-persons.report-change.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"reportChangeToLegalPerson","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalPersonReportChangeRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal server error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"}}}},"204":{"description":"Change report sent successfully"}},"x-permission-status":"protected","x-permission-roles":{"legal-persons.report-change.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["legal-persons.report-change.post"]}},"/international-prefixes":{"get":{"tags":["international-prefix-controller"],"description":"\n\n**Required permissions:** `international-prefixes.collection.get` (Role: Pracovník agentury, Administrátor)","operationId":"getInternationalPrefixCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/InternationalPrefixCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"international-prefixes.collection.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["international-prefixes.collection.get"]},"post":{"tags":["international-prefix-controller"],"description":"\n\n**Required permissions:** `international-prefixes.collection.post` (Role: Pracovník agentury, Administrátor)","operationId":"postInternationalPrefix","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternationalPrefix"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/InternationalPrefix"}}}}},"x-permission-status":"protected","x-permission-roles":{"international-prefixes.collection.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["international-prefixes.collection.post"]}},"/international-prefixes/{id}/default":{"post":{"tags":["international-prefix-controller"],"description":"\n\n**Required permissions:** `international-prefixes.item.default.post` (Role: Pracovník agentury, Administrátor)","operationId":"setInternationalPrefixAsDefault","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AgencyPrefix"}}}}},"x-permission-status":"protected","x-permission-roles":{"international-prefixes.item.default.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["international-prefixes.item.default.post"]}},"/collections":{"get":{"tags":["collection-controller"],"description":"\n\n**Required permissions:** `collections.collection.get` (Role: Pracovník agentury, Správce sbírek, Distributor, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getCollectionCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}},{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CollectionCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"collections.collection.get":["Pracovník agentury","Správce sbírek","Distributor","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["collections.collection.get"]},"post":{"tags":["collection-controller"],"description":"\n\n**Required permissions:** `collections.item.post` (Role: Pracovník agentury, Správce sbírek, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"postCollection","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collection"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Collection"}}}}},"x-permission-status":"protected","x-permission-roles":{"collections.item.post":["Pracovník agentury","Správce sbírek","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["collections.item.post"]}},"/collections/receive":{"post":{"tags":["collection-controller"],"description":"\n\n**Required permissions:** `collections.receive.post` (Role: žádná role)","operationId":"receiveCollection","parameters":[{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionMessage"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"201":{"description":"Collection received and processed successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Collection"}}}}},"x-permission-status":"protected","x-permission-roles":{"collections.receive.post":[]},"x-permissions-required":["collections.receive.post"]}},"/co-edition-number-requests":{"get":{"tags":["co-edition-number-request-controller"],"description":"\n\n**Required permissions:** `co-edition-number-requests.collection.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getCoEditionNumberRequestCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CoEditionNumberRequestCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"co-edition-number-requests.collection.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["co-edition-number-requests.collection.get"]},"post":{"tags":["co-edition-number-request-controller"],"summary":"Request an additional co-edition ISBN/ISMN for a product","description":"Creates a request for a second number drawn from the co-publisher's (publishing role 02) prefix. The request is fulfilled or rejected by an agency worker.\n\n**Required permissions:** `co-edition-number-requests.collection.post` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"createCoEditionNumberRequest","parameters":[{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoEditionNumberRequestCreateRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CoEditionNumberRequest"}}}}},"x-permission-status":"protected","x-permission-roles":{"co-edition-number-requests.collection.post":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["co-edition-number-requests.collection.post"]}},"/co-edition-number-requests/{requestId}/reject":{"post":{"tags":["co-edition-number-request-controller"],"description":"\n\n**Required permissions:** `co-edition-number-requests.reject.post` (Role: Pracovník agentury, Administrátor)","operationId":"rejectCoEditionNumberRequest","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoEditionNumberRejectRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CoEditionNumberRequest"}}}}},"x-permission-status":"protected","x-permission-roles":{"co-edition-number-requests.reject.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["co-edition-number-requests.reject.post"]}},"/co-edition-number-requests/{requestId}/assign":{"post":{"tags":["co-edition-number-request-controller"],"description":"\n\n**Required permissions:** `co-edition-number-requests.assign.post` (Role: Pracovník agentury, Administrátor)","operationId":"assignCoEditionNumber","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoEditionNumberAssignRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CoEditionNumberRequest"}}}}},"x-permission-status":"protected","x-permission-roles":{"co-edition-number-requests.assign.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["co-edition-number-requests.assign.post"]}},"/co-edition-number-requests/{requestId}/assign/preview":{"post":{"tags":["co-edition-number-request-controller"],"description":"\n\n**Required permissions:** `co-edition-number-requests.assign.preview.post` (Role: Pracovník agentury, Administrátor)","operationId":"previewCoEditionNumberAssign","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoEditionNumberAssignRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumberAssignResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"co-edition-number-requests.assign.preview.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["co-edition-number-requests.assign.preview.post"]}},"/authority-import/upload":{"post":{"tags":["authority-import-controller"],"description":"\n\n**Required permissions:** `authority-import.upload.post` (Role: žádná role)","operationId":"uploadFile","requestBody":{"content":{"application/json":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"authority-import.upload.post":[]},"x-permissions-required":["authority-import.upload.post"]}},"/authority-import/start":{"post":{"tags":["authority-import-controller"],"description":"\n\n**Required permissions:** `authority-import.start.post` (Role: žádná role)","operationId":"startImport_1","parameters":[{"name":"fileName","in":"query","required":true,"schema":{"type":"string"}},{"name":"importType","in":"query","required":true,"schema":{"type":"string","enum":["NATURAL_PERSONS","LEGAL_PERSONS","THEMA"]}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"x-permission-status":"protected","x-permission-roles":{"authority-import.start.post":[]},"x-permissions-required":["authority-import.start.post"]}},"/authority-import/start-from-nkp":{"post":{"tags":["authority-import-controller"],"description":"\n\n**Required permissions:** `authority-import.start-from-nkp.post` (Role: žádná role)","operationId":"startImportFromNkp","parameters":[{"name":"importType","in":"query","required":true,"schema":{"type":"string","enum":["NATURAL_PERSONS","LEGAL_PERSONS","THEMA"]}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"x-permission-status":"protected","x-permission-roles":{"authority-import.start-from-nkp.post":[]},"x-permissions-required":["authority-import.start-from-nkp.post"]}},"/agency/z3950/titles/search":{"post":{"tags":["Z39.50"],"summary":"Search published titles, returning MARC21 records","description":"Accepts the flattened Z39.50 query the gateway produces. Values within one access point are OR-ed, access points are AND-ed. Only titles with accessibility=PUBLIC are returned.\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"searchTitles","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Z3950TitleSearchRequestDto"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Z3950SearchResponseDto"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/public-view/report":{"post":{"tags":["public-view-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"report","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportRequestDto"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/public-view/admin/reindex":{"post":{"tags":["public-view-admin-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"reindex","parameters":[{"name":"core","in":"query","required":false,"schema":{"type":"string","default":"all"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReindexResponse"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/public-view/admin/obalky-knih/sync":{"post":{"tags":["public-view-admin-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"syncObalkyKnih","parameters":[{"name":"force","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ObalkyKnihSyncResponse"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/inbox":{"post":{"tags":["agency-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"agencyInboxPost","parameters":[{"name":"x-api-key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboxEvent"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/admin/aleph-publisher-sync-all":{"post":{"tags":["aleph-publisher-sync-controller"],"description":"\n\n**Required permissions:** `agency.admin.aleph-publisher-sync-all.post` (Role: žádná role)","operationId":"backfillAll","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.aleph-publisher-sync-all.post":[]},"x-permissions-required":["agency.admin.aleph-publisher-sync-all.post"]}},"/agency-publishers/{publisherId}/aleph-sync":{"post":{"tags":["aleph-publisher-sync-controller"],"description":"\n\n**Required permissions:** `agency-publishers.aleph-sync.post` (Role: žádná role)","operationId":"syncPublisher","parameters":[{"name":"publisherId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.aleph-sync.post":[]},"x-permissions-required":["agency-publishers.aleph-sync.post"]}},"/agency-publishers/{publisherId}/aleph-sync/reset":{"post":{"tags":["aleph-publisher-sync-controller"],"description":"\n\n**Required permissions:** `agency-publishers.aleph-sync.reset.post` (Role: žádná role)","operationId":"resetPermanentlyFailed_1","parameters":[{"name":"publisherId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.aleph-sync.reset.post":[]},"x-permissions-required":["agency-publishers.aleph-sync.reset.post"]}},"/agency-publishers/{id}/resolve":{"post":{"tags":["publisher-controller"],"description":"\n\n**Required permissions:** `agency-publishers.item.resolve.post` (Role: Pracovník agentury, Administrátor)","operationId":"resolvePublisher","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolvePublisherRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.item.resolve.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["agency-publishers.item.resolve.post"]}},"/agency-publishers/find-by-product-numbers":{"post":{"tags":["publisher-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"findPublisherByProductNumbers","parameters":[{"name":"X-Api-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindPublisherByProductNumbersRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FindPublisherByProductNumbersResponse"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency-products/{productId}/publish-verification":{"post":{"tags":["agency-product-link-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"publishVerification","parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Api-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishProductVerificationRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublishProductVerificationResponse"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency-products/find-by-product-number":{"post":{"tags":["agency-product-link-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"findByProductNumber","parameters":[{"name":"X-Api-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindProductByProductNumberRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FindProductByProductNumberResponse"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency-prefixes":{"get":{"tags":["agency-prefix-controller"],"description":"\n\n**Required permissions:** `agency-prefixes.collection.get` (Role: Pracovník agentury, Administrátor)","operationId":"getAgencyPrefixCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AgencyPrefixCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-prefixes.collection.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["agency-prefixes.collection.get"]},"post":{"tags":["agency-prefix-controller"],"description":"\n\n**Required permissions:** `agency-prefixes.collection.post` (Role: Pracovník agentury, Administrátor)","operationId":"postAgencyPrefix","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgencyPrefix"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AgencyPrefix"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-prefixes.collection.post":["Pracovník agentury","Administrátor"]},"x-permissions-required":["agency-prefixes.collection.post"]}},"/admin/sync-titles-to-legal-deposits":{"post":{"tags":["admin-controller"],"description":"\n\n**Required permissions:** `agency.admin.sync.execute` (Role: žádná role)","operationId":"syncTitlesToLegalDeposits","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SyncStatusDto"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.sync.execute":[]},"x-permissions-required":["agency.admin.sync.execute"]}},"/admin/sync-products-to-legal-deposits":{"post":{"tags":["admin-controller"],"description":"\n\n**Required permissions:** `agency.admin.sync.execute` (Role: žádná role)","operationId":"syncProductsToLegalDeposits","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SyncStatusDto"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.sync.execute":[]},"x-permissions-required":["agency.admin.sync.execute"]}},"/admin/sync-persons-to-legal-deposits":{"post":{"tags":["admin-controller"],"description":"\n\n**Required permissions:** `agency.admin.sync.execute` (Role: žádná role)","operationId":"syncPersonsToLegalDeposits","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SyncStatusDto"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.sync.execute":[]},"x-permissions-required":["agency.admin.sync.execute"]}},"/admin/sync-onix-to-legal-deposits":{"post":{"tags":["admin-controller"],"description":"\n\n**Required permissions:** `agency.admin.sync.execute` (Role: žádná role)","operationId":"syncOnixToLegalDeposits","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SyncStatusDto"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.sync.execute":[]},"x-permissions-required":["agency.admin.sync.execute"]}},"/admin/sync-collections-to-legal-deposits":{"post":{"tags":["admin-controller"],"description":"\n\n**Required permissions:** `agency.admin.sync.execute` (Role: žádná role)","operationId":"syncCollectionsToLegalDeposits","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SyncStatusDto"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.sync.execute":[]},"x-permissions-required":["agency.admin.sync.execute"]}},"/admin/solr/reindex":{"post":{"tags":["solr-admin-controller"],"description":"\n\n**Required permissions:** `agency.admin.solr.reindex.execute` (Role: žádná role)","operationId":"reindex_1","parameters":[{"name":"core","in":"query","required":false,"schema":{"type":"string","default":"all"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReindexResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.solr.reindex.execute":[]},"x-permissions-required":["agency.admin.solr.reindex.execute"]}},"/admin/authority-update/run":{"post":{"tags":["authority-update-controller"],"summary":"Trigger a manual authority-update run","description":"Starts an update run asynchronously. Returns the current status (202). If a run is already in progress the call is a no-op and the running status is returned.\n\n**Required permissions:** `agency.admin.authority-update.run.execute` (Role: žádná role)","operationId":"run","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AuthorityUpdateStatus"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.authority-update.run.execute":[]},"x-permissions-required":["agency.admin.authority-update.run.execute"]}},"/_/tenant":{"post":{"tags":["tenant"],"description":"Create tenant job (create, upgrade, delete)\n\n> ⚠️ **No descriptor match** — this operation is exposed by the application but has no matching handler (method + path) in the ModuleDescriptor, so no `permissionsRequired` is declared for it. It may be unprotected or the descriptor may be out of sync with the code. Verify this.","operationId":"postTenant","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tenantAttributes"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errors"}},"text/plain":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"string"}},"text/plain":{"schema":{"type":"string"}}}},"204":{"description":"Job completed"},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"string"}},"text/plain":{"schema":{"type":"string"}}}}},"x-permission-status":"no-descriptor-match"}},"/products/{id}/accessibility":{"patch":{"tags":["product-controller"],"description":"\n\n**Required permissions:** `products.item.accessibility.patch` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"makeProductAccessible","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductAccessibilityRequest"}}},"required":true},"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"products.item.accessibility.patch":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["products.item.accessibility.patch"]}},"/titles/{id}/preview":{"get":{"tags":["Record preview"],"summary":"Preview a title record","description":"Renders the title record inline in the requested format. M21 merges every product of the title into one OAI-MARC record; ONIX/JSON/RDF render the title without a product.\n\n**Required permissions:** `titles.preview.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"previewTitle","parameters":[{"name":"id","in":"path","description":"Title UUID","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","description":"Output format","required":true,"schema":{"type":"string","enum":["M21","ONIX","JSON","RDF"]}}],"responses":{"404":{"description":"Title not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"400":{"description":"Unsupported preview format","content":{"*/*":{"schema":{"type":"string"}}}},"200":{"description":"Preview generated","content":{"*/*":{"schema":{"type":"string"}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.preview.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["titles.preview.get"]}},"/titles/search":{"get":{"tags":["title-controller"],"description":"\n\n**Required permissions:** `titles.collection.search.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getTitleSearch","parameters":[{"name":"search","in":"query","description":"Search criteria","required":true,"schema":{"$ref":"#/components/schemas/TitleSearchCriteria"}},{"name":"x-okapi-tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":false,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"sortBy","in":"query","description":"Ordered list of fields to sort by: mainTitle, partNumber, partName, firstContributor, publisher, editionNumber, publicationYear; append /sort.descending for descending order","required":false,"schema":{"type":"array","items":{"type":"string"}}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TitleSearchCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.collection.search.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["titles.collection.search.get"]}},"/titles/data-import/status":{"get":{"tags":["title-import-controller"],"description":"\n\n**Required permissions:** `titles.data-import.status.get` (Role: Pracovník agentury, Administrátor)","operationId":"getImportStatus","parameters":[{"name":"fileName","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TitleImportStatusDto"}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.data-import.status.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["titles.data-import.status.get"]}},"/titles/data-import/owncloud/files":{"get":{"tags":["title-import-controller"],"description":"\n\n**Required permissions:** `titles.data-import.owncloud.files.get` (Role: Pracovník agentury, Administrátor)","operationId":"listOwnCloudFiles","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OwnCloudFileDtoCollection"}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.data-import.owncloud.files.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["titles.data-import.owncloud.files.get"]}},"/titles/data-import/import-from-file":{"get":{"tags":["title-import-controller"],"description":"\n\n**Required permissions:** `titles.data-import.import-from-file.get` (Role: Pracovník agentury, Administrátor)","operationId":"importTitlesFromFile","parameters":[{"name":"fileName","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"titles.data-import.import-from-file.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["titles.data-import.import-from-file.get"]}},"/titles/data-import/events":{"get":{"tags":["title-import-controller"],"description":"\n\n**Required permissions:** `titles.data-import.events.get` (Role: Pracovník agentury, Administrátor)","operationId":"getImportEvents","parameters":[{"name":"fileName","in":"query","required":true,"schema":{"type":"string"}},{"name":"severity","in":"query","required":false,"schema":{"type":"string","default":"ERROR","enum":["ERROR","WARNING"]}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.data-import.events.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["titles.data-import.events.get"]}},"/titles/data-import/delete-file":{"get":{"tags":["title-import-controller"],"description":"\n\n**Required permissions:** `titles.data-import.delete-file.get` (Role: Pracovník agentury, Administrátor)","operationId":"deleteTitleFile","parameters":[{"name":"fileName","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"titles.data-import.delete-file.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["titles.data-import.delete-file.get"]}},"/titles/data-import/active":{"get":{"tags":["title-import-controller"],"description":"\n\n**Required permissions:** `titles.data-import.active.get` (Role: Pracovník agentury, Administrátor)","operationId":"getActiveImport","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"x-permission-status":"protected","x-permission-roles":{"titles.data-import.active.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["titles.data-import.active.get"]}},"/thema-import/status/{importId}":{"get":{"tags":["thema-import-controller"],"description":"\n\n**Required permissions:** `thema-import.status.get` (Role: Pracovník agentury, Administrátor)","operationId":"getImportStatus_1","parameters":[{"name":"importId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ImportProgressDto"}}}}},"x-permission-status":"protected","x-permission-roles":{"thema-import.status.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["thema-import.status.get"]}},"/thema-import/owncloud-status":{"get":{"tags":["thema-import-controller"],"description":"\n\n**Required permissions:** `thema-import.owncloud-status.get` (Role: Pracovník agentury, Administrátor)","operationId":"getOwnCloudStatus","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}},"x-permission-status":"protected","x-permission-roles":{"thema-import.owncloud-status.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["thema-import.owncloud-status.get"]}},"/thema-import/active":{"get":{"tags":["thema-import-controller"],"description":"\n\n**Required permissions:** `thema-import.active.get` (Role: Pracovník agentury, Administrátor)","operationId":"getActiveImport_1","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"x-permission-status":"protected","x-permission-roles":{"thema-import.active.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["thema-import.active.get"]}},"/storage/content/{filename}":{"get":{"tags":["storage-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"content","parameters":[{"name":"filename","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StreamingResponseBody"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/reports/download/{fileId}":{"get":{"tags":["Reports"],"summary":"Download generated report","description":"Downloads a previously generated report file\n\n**Required permissions:** `reports.download.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"downloadReport","parameters":[{"name":"fileId","in":"path","description":"File ID returned from generation","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Report file not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Report file","content":{"*/*":{"schema":{"type":"string","format":"binary"}}}}},"x-permission-status":"protected","x-permission-roles":{"reports.download.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["reports.download.get"]}},"/publisher-prefixes":{"get":{"tags":["publisher-prefix-controller"],"description":"\n\n**Required permissions:** `publisher-prefixes.collection.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getPublisherPrefixCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"identifierSearch","in":"query","required":false,"schema":{"type":"string"}},{"name":"publisherSourceId","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherPrefixCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefixes.collection.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["publisher-prefixes.collection.get"]}},"/publisher-prefixes/resolve":{"get":{"tags":["publisher-prefix-controller"],"description":"\n\n**Required permissions:** `publisher-prefixes.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"resolvePublisherPrefix","parameters":[{"name":"productNumber","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherPrefix"}}}}},"x-permission-status":"protected","x-permission-roles":{"publisher-prefixes.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["publisher-prefixes.item.get"]}},"/products/{id}/preview":{"get":{"tags":["Record preview"],"summary":"Preview a product record","description":"Renders the product record inline in the requested format. M21 renders the product's parent title with all products merged; ONIX/JSON/RDF render only this product.\n\n**Required permissions:** `products.preview.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"previewProduct","parameters":[{"name":"id","in":"path","description":"Product UUID","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","description":"Output format","required":true,"schema":{"type":"string","enum":["M21","ONIX","JSON","RDF"]}}],"responses":{"404":{"description":"Product not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"400":{"description":"Unsupported preview format","content":{"*/*":{"schema":{"type":"string"}}}},"200":{"description":"Preview generated","content":{"*/*":{"schema":{"type":"string"}}}}},"x-permission-status":"protected","x-permission-roles":{"products.preview.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["products.preview.get"]}},"/products/search":{"get":{"tags":["product-controller"],"description":"\n\n**Required permissions:** `products.search.collection.get` (Role: Pracovník agentury, Distributor, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"searchProducts","parameters":[{"name":"search","in":"query","description":"Search criteria","required":true,"schema":{"$ref":"#/components/schemas/ProductSearchCriteria"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}},{"name":"sortBy","in":"query","description":"Ordered list of fields to sort by: publisher, mainTitle, partNumber, partName, firstContributor, form, productNumber, publishingDate, accessibility; append /sort.descending for descending order","required":false,"schema":{"type":"array","items":{"type":"string"}}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductSearchCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"products.search.collection.get":["Pracovník agentury","Distributor","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["products.search.collection.get"]}},"/products/relation-selection":{"get":{"tags":["product-controller"],"description":"\n\n**Required permissions:** `products.collection.get` (Role: Pracovník agentury, Distributor, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getProductsForRelationSelection","parameters":[{"name":"productNumber","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"List of products for relation selection","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"products.collection.get":["Pracovník agentury","Distributor","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["products.collection.get"]}},"/product-numbers/{productNumberId}":{"get":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getProductNumberById","parameters":[{"name":"productNumberId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumber"}}}}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.item.get"]}},"/product-numbers/search":{"get":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"searchProductNumbers","parameters":[{"name":"search","in":"query","description":"Search criteria","required":true,"schema":{"$ref":"#/components/schemas/ProductNumberSearchCriteria"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumberSearchCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.item.get"]}},"/product-numbers/by-title/{titleId}":{"get":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.by-title.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getProductNumbersByTitleId","parameters":[{"name":"titleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumberCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.by-title.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.by-title.get"]}},"/product-numbers/assign/{productId}/by-product-id":{"get":{"tags":["product-number-controller"],"description":"\n\n**Required permissions:** `product-numbers.assign.by-product-id.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"assignProductNumbers","parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumberAssignResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.assign.by-product-id.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.assign.by-product-id.get"]}},"/product-numbers/assign/feasibility/{titleId}":{"get":{"tags":["product-number-controller"],"summary":"Check product number assignment feasibility for a title","description":"Tells the UI, before a product exists, whether an ISBN/ISMN can be assigned for the title's owner publisher and, if not, why. The optional primaryContentType parameter carries the ONIX primary content type picked in the create form so that the answer (agency, prefix options) matches the agency the number will be drawn from; omitting it means ISBN.\n\n**Required permissions:** `product-numbers.assign.feasibility.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"checkAssignFeasibility","parameters":[{"name":"titleId","in":"path","required":true,"schema":{"type":"string"}},{"name":"primaryContentType","in":"query","description":"ONIX primary content type (codelist 81) of the product about to be created; \"11\" (musical notation) resolves to ISMN, anything else and omitting it resolve to ISBN","required":false,"schema":{"type":"string"}},{"name":"x-okapi-tenant","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-token","in":"header","required":true,"schema":{"type":"string"}},{"name":"x-okapi-url","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"Feasibility result","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductNumberFeasibilityResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"product-numbers.assign.feasibility.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["product-numbers.assign.feasibility.get"]}},"/persons":{"get":{"tags":["person-controller"],"description":"\n\n**Required permissions:** `persons.collection.get` (Role: Pracovník agentury, Distributor, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getPersonCollection","parameters":[{"name":"nameFilter","in":"query","required":false,"schema":{"type":"string"}},{"name":"identifierFilter","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PersonCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"persons.collection.get":["Pracovník agentury","Distributor","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["persons.collection.get"]}},"/persons/search-options":{"get":{"tags":["person-controller"],"description":"\n\n**Required permissions:** `persons.collection.get` (Role: Pracovník agentury, Distributor, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getPersonSearchOptions","parameters":[{"name":"nameFilter","in":"query","required":false,"schema":{"type":"string"}},{"name":"legalForm","in":"query","required":false,"schema":{"type":"string","description":"Legal form","enum":["LEGAL","NATURAL"]}},{"name":"sourceIdFilter","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PersonSearchOption"}}}}}},"x-permission-status":"protected","x-permission-roles":{"persons.collection.get":["Pracovník agentury","Distributor","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["persons.collection.get"]}},"/international-prefixes/{id}":{"get":{"tags":["international-prefix-controller"],"description":"\n\n**Required permissions:** `international-prefixes.item.get` (Role: Pracovník agentury, Administrátor)","operationId":"getInternationalPrefixById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/InternationalPrefix"}}}}},"x-permission-status":"protected","x-permission-roles":{"international-prefixes.item.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["international-prefixes.item.get"]},"delete":{"tags":["international-prefix-controller"],"description":"\n\n**Required permissions:** `international-prefixes.item.delete` (Role: Pracovník agentury, Administrátor)","operationId":"deleteInternationalPrefixById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"international-prefixes.item.delete":["Pracovník agentury","Administrátor"]},"x-permissions-required":["international-prefixes.item.delete"]}},"/collections/{issn}/by-issn":{"get":{"tags":["collection-controller"],"description":"\n\n**Required permissions:** `collections.item.by-issn.get` (Role: žádná role)","operationId":"getCollectionByIssn","parameters":[{"name":"issn","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Collection"}}}}},"x-permission-status":"protected","x-permission-roles":{"collections.item.by-issn.get":[]},"x-permissions-required":["collections.item.by-issn.get"]}},"/co-edition-number-requests/{requestId}":{"get":{"tags":["co-edition-number-request-controller"],"description":"\n\n**Required permissions:** `co-edition-number-requests.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getCoEditionNumberRequestById","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CoEditionNumberRequest"}}}}},"x-permission-status":"protected","x-permission-roles":{"co-edition-number-requests.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["co-edition-number-requests.item.get"]}},"/authority-import/status/{importId}":{"get":{"tags":["authority-import-controller"],"description":"\n\n**Required permissions:** `authority-import.status.get` (Role: žádná role)","operationId":"getImportStatus_2","parameters":[{"name":"importId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ImportProgressDto"}}}}},"x-permission-status":"protected","x-permission-roles":{"authority-import.status.get":[]},"x-permissions-required":["authority-import.status.get"]}},"/authority-import/active":{"get":{"tags":["authority-import-controller"],"description":"\n\n**Required permissions:** `authority-import.active.get` (Role: žádná role)","operationId":"getActiveImport_2","parameters":[{"name":"importType","in":"query","required":true,"schema":{"type":"string","enum":["NATURAL_PERSONS","LEGAL_PERSONS","THEMA"]}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}},"x-permission-status":"protected","x-permission-roles":{"authority-import.active.get":[]},"x-permissions-required":["authority-import.active.get"]}},"/agency/sync-persons":{"get":{"tags":["scheduler-controller"],"description":"\n\n**Required permissions:** `agency.execute-scheduled-job.execute` (Role: žádná role)","operationId":"syncPersons","parameters":[{"name":"X-Okapi-Tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-Token","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-URL","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"agency.execute-scheduled-job.execute":[]},"x-permissions-required":["agency.execute-scheduled-job.execute"]}},"/agency/run-publishing-automation":{"get":{"tags":["scheduler-controller"],"description":"\n\n**Required permissions:** `agency.execute-scheduled-job.execute` (Role: žádná role)","operationId":"runPublishingAutomation","parameters":[{"name":"X-Okapi-Tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-Token","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-URL","in":"header","required":false,"schema":{"type":"string"}},{"name":"full","in":"query","description":"ignore the stored resume point of a capped run and start from the first product","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"agency.execute-scheduled-job.execute":[]},"x-permissions-required":["agency.execute-scheduled-job.execute"]}},"/agency/public-view/titles/{id}":{"get":{"tags":["public-view-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"getTitle","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TitleDetailDto"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/public-view/titles/{id}/recommendations":{"get":{"tags":["public-view-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"getTitleRecommendations","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TitleRecommendationsDto"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/public-view/titles/sitemap":{"get":{"tags":["public-view-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"titlesSitemap","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SitemapResponseDto"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/public-view/titles/search":{"get":{"tags":["public-view-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"searchTitles_1","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"*"}},{"name":"year","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"yearFrom","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"yearTo","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"format","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"language","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"thema","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"audience","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"publisherId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"contributorId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"RELEVANCE","enum":["RELEVANCE","PUBLISHED_DESC","NAME_ASC"]}},{"name":"page","in":"query","required":false,"schema":{"minimum":0,"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"minimum":1,"type":"integer","format":"int32","default":24}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TitleSearchResponseDto"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/public-view/stats":{"get":{"tags":["public-view-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"stats","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CatalogStatsDto"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/public-view/publishers/{id}":{"get":{"tags":["public-view-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"getPublisher","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherDetailDto"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/public-view/publishers/sitemap":{"get":{"tags":["public-view-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"publishersSitemap","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SitemapResponseDto"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/public-view/publishers/search":{"get":{"tags":["public-view-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"searchPublishers","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"*"}},{"name":"legalForm","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"region","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"active","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"RELEVANCE","enum":["RELEVANCE","NAME_ASC","UPDATED_DESC"]}},{"name":"page","in":"query","required":false,"schema":{"minimum":0,"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"minimum":1,"type":"integer","format":"int32","default":24}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherSearchResponseDto"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/public-view/authors/{id}":{"get":{"tags":["public-view-controller"],"description":"\n\n> ⚠️ **No permission required** — this endpoint declares an empty `permissionsRequired` in the ModuleDescriptor and is therefore not permission-protected. Verify this is intentional.","operationId":"getAuthor","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"page","in":"query","required":false,"schema":{"minimum":0,"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"minimum":1,"type":"integer","format":"int32","default":24}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AuthorDetailDto"}}}}},"x-permission-status":"unprotected","x-permissions-required":[]}},"/agency/process-outbox":{"get":{"tags":["scheduler-controller"],"description":"\n\n**Required permissions:** `agency.execute-scheduled-job.execute` (Role: žádná role)","operationId":"processOutbox","parameters":[{"name":"X-Okapi-Tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-Token","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-URL","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"agency.execute-scheduled-job.execute":[]},"x-permissions-required":["agency.execute-scheduled-job.execute"]}},"/agency/authority-update-tick":{"get":{"tags":["scheduler-controller"],"description":"\n\n**Required permissions:** `agency.execute-scheduled-job.execute` (Role: žádná role)","operationId":"authorityUpdateTick","parameters":[{"name":"X-Okapi-Tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-Token","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-URL","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"agency.execute-scheduled-job.execute":[]},"x-permissions-required":["agency.execute-scheduled-job.execute"]}},"/agency/aleph-title-sync":{"get":{"tags":["scheduler-controller"],"description":"\n\n**Required permissions:** `agency.execute-scheduled-job.execute` (Role: žádná role)","operationId":"syncTitlesToAleph","parameters":[{"name":"X-Okapi-Tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-Token","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-URL","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"agency.execute-scheduled-job.execute":[]},"x-permissions-required":["agency.execute-scheduled-job.execute"]}},"/agency/aleph-publisher-sync":{"get":{"tags":["scheduler-controller"],"description":"\n\n**Required permissions:** `agency.execute-scheduled-job.execute` (Role: žádná role)","operationId":"syncPublishersToAleph","parameters":[{"name":"X-Okapi-Tenant","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-Token","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Okapi-URL","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"agency.execute-scheduled-job.execute":[]},"x-permissions-required":["agency.execute-scheduled-job.execute"]}},"/agency-publishers":{"get":{"tags":["publisher-controller"],"description":"\n\n**Required permissions:** `agency-publishers.collection.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getPublisherCollection","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.collection.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["agency-publishers.collection.get"]}},"/agency-publishers/{id}":{"get":{"tags":["publisher-controller"],"description":"\n\n**Required permissions:** `agency-publishers.item.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getPublisherById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Publisher"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.item.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["agency-publishers.item.get"]}},"/agency-publishers/{id}/prefix-history":{"get":{"tags":["publisher-controller"],"description":"\n\n**Required permissions:** `agency-publishers.prefix-history.get` (Role: Pracovník agentury, Administrátor)","operationId":"getPublisherPrefixHistory","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherPrefixHistoryCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.prefix-history.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["agency-publishers.prefix-history.get"]}},"/agency-publishers/{id}/generic-product-numbers":{"get":{"tags":["publisher-controller"],"description":"\n\n**Required permissions:** `agency-publishers.generic-product-numbers.get` (Role: Pracovník agentury, Administrátor)","operationId":"getGenericProductNumbers","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GenericProductNumberCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.generic-product-numbers.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["agency-publishers.generic-product-numbers.get"]}},"/agency-publishers/unresolved":{"get":{"tags":["publisher-controller"],"description":"\n\n**Required permissions:** `agency-publishers.unresolved.get` (Role: Pracovník agentury, Administrátor)","operationId":"getUnresolvedPublishers","parameters":[{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.unresolved.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["agency-publishers.unresolved.get"]}},"/agency-publishers/search":{"get":{"tags":["publisher-controller"],"description":"\n\n**Required permissions:** `agency-publishers.collection.search.get` (Role: Pracovník agentury, Distributor, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getPublisherCollectionSearch","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"cql.allRecords=1"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1000}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherSearchCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.collection.search.get":["Pracovník agentury","Distributor","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["agency-publishers.collection.search.get"]}},"/agency-publishers/search-by-prefix":{"get":{"tags":["publisher-controller"],"description":"\n\n**Required permissions:** `agency-publishers.search-by-prefix.get` (Role: Admin povinných výtisků, Pracovník agentury, Knihovník PV - monografie, Knihovník PV - periodika, Administrátor)","operationId":"searchPublishersByPrefix","parameters":[{"name":"prefix","in":"query","required":true,"schema":{"maxLength":20,"minLength":6,"pattern":"^[0-9\\-]+$","type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SourceIdCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.search-by-prefix.get":["Admin povinných výtisků","Pracovník agentury","Knihovník PV - monografie","Knihovník PV - periodika","Administrátor"]},"x-permissions-required":["agency-publishers.search-by-prefix.get"]}},"/agency-publishers/by-source-id/{sourceId}":{"get":{"tags":["publisher-controller"],"description":"\n\n**Required permissions:** `agency-publishers.by-source-id.get` (Role: Pracovník agentury, Správce nakladatele, Garant nakladatele, Administrátor)","operationId":"getPublisherBySourceId","parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Publisher"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.by-source-id.get":["Pracovník agentury","Správce nakladatele","Garant nakladatele","Administrátor"]},"x-permissions-required":["agency-publishers.by-source-id.get"]}},"/agency-publishers/by-source-id/{sourceId}/prefix-history":{"get":{"tags":["publisher-controller"],"description":"\n\n**Required permissions:** `agency-publishers.by-source-id.prefix-history.get` (Role: Admin povinných výtisků, Pracovník agentury, Knihovník PV - monografie, Knihovník PV - periodika, Administrátor)","operationId":"getPublisherPrefixHistoryBySourceId","parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublisherPrefixHistoryCollectionResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-publishers.by-source-id.prefix-history.get":["Admin povinných výtisků","Pracovník agentury","Knihovník PV - monografie","Knihovník PV - periodika","Administrátor"]},"x-permissions-required":["agency-publishers.by-source-id.prefix-history.get"]}},"/agency-prefixes/{id}":{"get":{"tags":["agency-prefix-controller"],"description":"\n\n**Required permissions:** `agency-prefixes.item.get` (Role: Pracovník agentury, Administrátor)","operationId":"getAgencyPrefixById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AgencyPrefix"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-prefixes.item.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["agency-prefixes.item.get"]},"delete":{"tags":["agency-prefix-controller"],"description":"\n\n**Required permissions:** `agency-prefixes.item.delete` (Role: Pracovník agentury, Administrátor)","operationId":"deleteAgencyPrefixById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"agency-prefixes.item.delete":["Pracovník agentury","Administrátor"]},"x-permissions-required":["agency-prefixes.item.delete"]}},"/agency-prefixes/{id}/valid-magnitudes":{"get":{"tags":["agency-prefix-controller"],"description":"\n\n**Required permissions:** `agency-prefixes.item.get` (Role: Pracovník agentury, Administrátor)","operationId":"getValidMagnitudes","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ValidMagnitudeRangeResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency-prefixes.item.get":["Pracovník agentury","Administrátor"]},"x-permissions-required":["agency-prefixes.item.get"]}},"/admin/sync-status":{"get":{"tags":["admin-controller"],"description":"\n\n**Required permissions:** `agency.admin.sync.execute` (Role: žádná role)","operationId":"getSyncStatus","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SyncStatusDto"}}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.sync.execute":[]},"x-permissions-required":["agency.admin.sync.execute"]}},"/admin/solr/stats":{"get":{"tags":["solr-admin-controller"],"description":"\n\n**Required permissions:** `agency.admin.solr.read` (Role: Administrátor)","operationId":"stats_1","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SolrStatsResponse"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.solr.read":["Administrátor"]},"x-permissions-required":["agency.admin.solr.read"]}},"/admin/environment-variables-agency":{"get":{"tags":["admin-controller"],"description":"\n\n**Required permissions:** `agency.admin.environment-variables.get` (Role: žádná role)","operationId":"getEnvironmentVariables","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EnvironmentVariableDtoCollection"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.environment-variables.get":[]},"x-permissions-required":["agency.admin.environment-variables.get"]}},"/admin/authority-update/status":{"get":{"tags":["authority-update-controller"],"summary":"Get authority-update status","description":"Returns the schedule, running flag, next planned run and the statistics of the most recent run.\n\n**Required permissions:** `agency.admin.authority-update.read` (Role: Pracovník agentury, Administrátor)","operationId":"status","responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AuthorityUpdateStatus"}}}}},"x-permission-status":"protected","x-permission-roles":{"agency.admin.authority-update.read":["Pracovník agentury","Administrátor"]},"x-permissions-required":["agency.admin.authority-update.read"]}},"/_/tenant/{operationId}":{"get":{"tags":["tenant"],"description":"Does tenant id already exist\n\n> ⚠️ **No descriptor match** — this operation is exposed by the application but has no matching handler (method + path) in the ModuleDescriptor, so no `permissionsRequired` is declared for it. It may be unprotected or the descriptor may be out of sync with the code. Verify this.","operationId":"getTenant","parameters":[{"name":"operationId","in":"path","description":"Operation ID","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal server error","content":{"text/plain":{"schema":{"type":"string"}}}},"200":{"description":"true or false indicator","content":{"text/plain":{"schema":{"type":"string"}}}}},"x-permission-status":"no-descriptor-match"},"delete":{"tags":["tenant"],"description":"drop tenant id\n\n> ⚠️ **No descriptor match** — this operation is exposed by the application but has no matching handler (method + path) in the ModuleDescriptor, so no `permissionsRequired` is declared for it. It may be unprotected or the descriptor may be out of sync with the code. Verify this.","operationId":"deleteTenant","parameters":[{"name":"operationId","in":"path","description":"Operation ID","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal server error","content":{"text/plain":{"schema":{"type":"string"}}}},"204":{"description":"Delete succeeded"},"400":{"description":"Bad request"}},"x-permission-status":"no-descriptor-match"}},"/authority-import/file":{"delete":{"tags":["authority-import-controller"],"description":"\n\n**Required permissions:** `authority-import.file.delete` (Role: žádná role)","operationId":"deleteFile","parameters":[{"name":"fileName","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Entity not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"409":{"description":"Optimistic lock exception","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"422":{"description":"Validation constraint violation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"403":{"description":"Forbidden access","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"503":{"description":"Service Unavailable","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/errors"}}}},"200":{"description":"OK"}},"x-permission-status":"protected","x-permission-roles":{"authority-import.file.delete":[]},"x-permissions-required":["authority-import.file.delete"]}}},"components":{"schemas":{"error":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"Error message text"},"type":{"type":"string","description":"Error message type"},"code":{"type":"string","description":"Error message code"},"parameters":{"type":"array","description":"List of key/value parameters","items":{"$ref":"#/components/schemas/parameter"}}},"description":"An error message"},"errors":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"$ref":"#/components/schemas/error"}},"total_records":{"type":"integer","description":"Total number of errors","format":"int32"}},"description":"A set of error messages"},"parameter":{"required":["key"],"type":"object","properties":{"key":{"type":"string","description":"The key for this parameter"},"value":{"type":"string","description":"The value of this parameter"}},"description":"Key/value parameter"},"Author":{"type":"object","properties":{"firstName":{"type":"string","description":"First name"},"lastName":{"type":"string","description":"Last name"}},"description":"Author information"},"Collection":{"required":["mainName","type"],"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a Collection","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"sourceId":{"type":"string","description":"External source identifier"},"type":{"type":"string","description":"Type of collection","enum":["PUBLISHER_SERIES","SERIES"]},"publisher":{"$ref":"#/components/schemas/Publisher"},"issn":{"type":"string","description":"ISSN of the collection"},"mainName":{"type":"string","description":"Main name of the collection"},"otherLanguageNames":{"type":"array","description":"List of other language names for the collection","items":{"$ref":"#/components/schemas/CollectionName"}},"publisherNames":{"type":"array","description":"Distinct publisher names taken from titles linked to the collection, filled only when fetching a single collection","readOnly":true,"items":{"type":"string","description":"Distinct publisher names taken from titles linked to the collection, filled only when fetching a single collection","readOnly":true}},"version":{"type":"integer","description":"Optimistic locking version for the entity","format":"int32","readOnly":true,"example":1}},"description":"Collection DTO"},"CollectionName":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a CollectionName","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"name":{"type":"string","description":"Name of the collection"}},"description":"Collection Name DTO"},"LegalPerson":{"required":["legalForm"],"type":"object","description":"Legal Person DTO","allOf":[{"$ref":"#/components/schemas/Person"},{"type":"object","properties":{"name":{"type":"string","description":"Name of the legal person"},"residence":{"type":"string","description":"Residence of the legal person"},"legalAlternativeNames":{"type":"array","description":"List of alternative names for the legal person","items":{"$ref":"#/components/schemas/LegalPersonAlternativeName"}}}}]},"LegalPersonAlternativeName":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a LegalPersonAlternativeName","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"name":{"type":"string","description":"Name of the legal person"}},"description":"Legal Person Alternative Name DTO"},"NaturalPerson":{"required":["legalForm"],"type":"object","description":"Natural Person DTO","allOf":[{"$ref":"#/components/schemas/Person"},{"type":"object","properties":{"firstName":{"type":"string","description":"First name of the natural person"},"lastName":{"type":"string","description":"Last name of the natural person"},"birthDate":{"type":"string","description":"Birth date of the natural person in partial date format (YYYY, MM.YYYY, or DD.MM.YYYY)"},"deathDate":{"type":"string","description":"Death date of the natural person in partial date format (YYYY, MM.YYYY, or DD.MM.YYYY)"},"biographicalNote":{"type":"string","description":"Biographical note about the natural person"},"disclosureConsent":{"type":"boolean","description":"Consent to disclosure"},"naturalAlternativeNames":{"type":"array","description":"List of alternative names for the natural person","items":{"$ref":"#/components/schemas/NaturalPersonAlternativeName"}}}}]},"NaturalPersonAlternativeName":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a NaturalPersonAlternativeName","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"firstName":{"type":"string","description":"Name of the natural person alternative name"},"lastName":{"type":"string","description":"Last name of the natural person alternative name"}},"description":"Natural Person Alternative Name DTO"},"OnixCodetable":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of an OnixCodetable","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"number":{"type":"integer","description":"Number","format":"int32"},"name":{"type":"string","description":"Name"},"onixCodetableItems":{"type":"array","description":"List of onix codetable items","items":{"$ref":"#/components/schemas/OnixCodetableItem"}},"version":{"type":"integer","description":"Version","format":"int32"}},"description":"Onix Codetable DTO"},"OnixCodetableItem":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of an OnixCodetableItem","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"onixCodetable":{"$ref":"#/components/schemas/OnixCodetable"},"value":{"type":"string","description":"Value"},"description":{"type":"string","description":"Description"},"notes":{"type":"string","description":"Notes"},"sortOrder":{"type":"integer","description":"Display order","format":"int32"},"version":{"type":"integer","description":"Version","format":"int32"}},"description":"Onix Codetable Item DTO"},"OtherFormat":{"type":"object","properties":{"format":{"type":"string","description":"Format name"}},"description":"Other publication format"},"Person":{"required":["legalForm"],"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a Person","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"sourceId":{"type":"string","description":"External source identifier"},"legalForm":{"type":"string","description":"Legal form","enum":["LEGAL","NATURAL"]},"status":{"type":"string","description":"Status of a person","enum":["PROPOSAL","CONFIRMED","SEARCH_FAILED"]},"proposer":{"$ref":"#/components/schemas/Publisher"},"proposerId":{"type":"string","description":"External identifier of the proposer"},"identifiers":{"type":"array","description":"List of person identifiers","items":{"$ref":"#/components/schemas/PersonIdentifier"}},"version":{"type":"integer","description":"Version for optimistic locking","format":"int32","readOnly":true},"authoritySendError":{"type":"string","description":"Non-null when the person was saved but sending its authority record to the Z39.50/Aleph server failed. The save itself succeeded; this message describes why the authority send did not.","readOnly":true}},"description":"Person DTO","discriminator":{"propertyName":"legalForm"}},"PersonIdentifier":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a PersonIdentifier","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"type":{"type":"string","description":"Type of person identifier","enum":["ISNI","ORCID"]},"identifier":{"type":"string","description":"The identifier value (normalized and formatted: ISNI: 0000 0000 0000 0000, ORCID: 0000-0000-0000-0000)"}},"description":"Data Transfer Object for Person Identifier"},"PublicationType":{"type":"object","properties":{"printedPublications":{"type":"array","description":"Printed publication formats","items":{"type":"string","description":"Printed publication format","enum":["SOFTCOVER","HARDCOVER"]}}},"description":"Publication type settings"},"Publisher":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a Publisher","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"sourceId":{"type":"string","description":"External source identifier"},"name":{"type":"string","description":"Publisher name"},"nameSuffix":{"type":"string","description":"Publisher name suffix"},"qualifier":{"type":"string","description":"Publisher qualifier"},"status":{"type":"string","description":"Status of a publisher","enum":["ACTIVE","CLOSING","CLOSED"]},"registrations":{"type":"array","description":"Per-agency registrations of this publisher, synced from mod-br-publishers","items":{"$ref":"#/components/schemas/PublisherRegistration"}},"dataConfirmationTime":{"type":"string","description":"Data confirmation time","format":"date-time"},"workSpecification":{"$ref":"#/components/schemas/WorkSpecification"},"publisherType":{"type":"string","description":"Type of a publisher","enum":["COMMON","SPECIAL"]},"idz":{"type":"string","description":"Publisher authority identifier from the Czech National Library"},"municipality":{"type":"string","description":"Municipality from publisher main address, synced from mod-br-publishers"},"legalForm":{"type":"string","description":"Legal form: LEGAL, NATURAL, UNKNOWN"},"companyNumber":{"type":"string","description":"Company number (IČO)"},"taxNumber":{"type":"string","description":"Tax number (DIČ)"},"addressStreet":{"type":"string","description":"Street from publisher main address"},"addressPostalCode":{"type":"string","description":"Postal code from publisher main address"},"addressRegion":{"type":"string","description":"Region name from publisher main address"},"activationTime":{"type":"string","description":"Activation time","format":"date-time"},"closeTime":{"type":"string","description":"Close time","format":"date-time"},"addressDisclosureConsent":{"type":"boolean","description":"Consent to publish the main address and identifiers"},"alternativeNames":{"type":"array","description":"Public alternative names","items":{"$ref":"#/components/schemas/PublisherAlternativeName"}},"contacts":{"type":"array","description":"Publisher contacts","items":{"$ref":"#/components/schemas/PublisherContact"}},"notificationEmail":{"type":"string","description":"Guarantor notification e-mail, synced from mod-br-publishers"},"version":{"type":"integer","description":"Version for optimistic locking","format":"int32","readOnly":true}},"description":"Publisher DTO"},"PublisherAlternativeName":{"type":"object","properties":{"name":{"type":"string","description":"The alternative name"},"nameSuffix":{"type":"string","description":"The name suffix"},"qualifier":{"type":"string","description":"Qualifier distinguishing publishers with the same name"},"type":{"type":"string","description":"Type: PREVIOUS, IMPRINT, ABBREVIATION, ORGANIZATION_UNIT, FOREIGN_LANGUAGE"}},"description":"Publisher alternative name"},"PublisherContact":{"type":"object","properties":{"type":{"type":"string","description":"Contact type: PHONE, EMAIL, WEB, DATA_BOX"},"value":{"type":"string","description":"Contact value"},"info":{"type":"string","description":"Additional info"}},"description":"Publisher contact"},"PublisherRegistration":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a PublisherRegistration","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"registrationAgency":{"type":"string","description":"Registration agency","enum":["ISBN","ISMN"]},"registrationIntent":{"type":"string","description":"Registration intent","enum":["ONE_OFF","CONTINUOUS"]},"registrationTime":{"type":"string","description":"When the registration became effective","format":"date-time"},"terminationTime":{"type":"string","description":"When the registration was terminated; null means the registration is active","format":"date-time"}},"description":"Publisher registration DTO"},"Title":{"required":["owner"],"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a Title","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"owner":{"$ref":"#/components/schemas/Publisher"},"ownerId":{"type":"string","description":"Owner Identifier - unique identifier of the title in the owner's system"},"names":{"type":"array","description":"Names","items":{"$ref":"#/components/schemas/TitleName"}},"editionNumber":{"type":"integer","description":"Edition Number","format":"int32"},"editionStatement":{"type":"string","description":"Edition Statement"},"languages":{"type":"array","description":"Languages","items":{"$ref":"#/components/schemas/TitleLanguage"}},"subjects":{"type":"array","description":"Subjects","items":{"$ref":"#/components/schemas/TitleSubject"}},"textContents":{"type":"array","description":"Text Contents","items":{"$ref":"#/components/schemas/TitleTextContent"}},"supportingResources":{"type":"array","description":"Supporting Resources","items":{"$ref":"#/components/schemas/TitleSupportingResource"}},"publicationPlaces":{"type":"array","description":"Publication Places","items":{"$ref":"#/components/schemas/TitlePublicationPlace"}},"audiences":{"type":"array","description":"Audiences","items":{"$ref":"#/components/schemas/TitleAudience"}},"ageFrom":{"type":"integer","description":"Age From","format":"int32"},"ageTo":{"type":"integer","description":"Age To","format":"int32"},"doi":{"type":"string","description":"DOI"},"illustrationsNote":{"type":"string","description":"Illustrations Note"},"imprint":{"type":"string","description":"Imprint"},"commentForAgency":{"type":"string","description":"Comment For Agency"},"ownerUnresolved":{"type":"boolean","description":"Owner Unresolved"},"version":{"type":"integer","description":"Version","format":"int32"},"titleContributions":{"type":"array","description":"Title Contributions","items":{"$ref":"#/components/schemas/TitleContribution"}},"titlePublishers":{"type":"array","description":"Title Publishers","items":{"$ref":"#/components/schemas/TitlePublisher"}},"titleCollections":{"type":"array","description":"Title Collections","items":{"$ref":"#/components/schemas/TitleCollection"}}},"description":"Title DTO"},"TitleAudience":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitleAudience","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"type":{"$ref":"#/components/schemas/OnixCodetableItem"},"version":{"type":"string","description":"Version"}},"description":"Title Audience DTO"},"TitleCollection":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitleCollection","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"title":{"$ref":"#/components/schemas/Title"},"collection":{"$ref":"#/components/schemas/Collection"},"partNumber":{"type":"string","description":"Part Number"}},"description":"Title Collection DTO"},"TitleContribution":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitleContribution","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"title":{"$ref":"#/components/schemas/Title"},"person":{"$ref":"#/components/schemas/Person"},"sequenceNumber":{"type":"integer","description":"Sequence Number","format":"int32"},"roles":{"type":"array","description":"Roles","items":{"$ref":"#/components/schemas/TitleContributionRole"}},"firstName":{"type":"string","description":"First Name"},"lastName":{"type":"string","description":"Last Name"},"biographicalNote":{"type":"string","description":"Biographical Note"},"name":{"type":"string","description":"Name"},"unnamedPerson":{"$ref":"#/components/schemas/OnixCodetableItem"}},"description":"Title Contribution DTO"},"TitleContributionRole":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitleContributionRole","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"role":{"$ref":"#/components/schemas/OnixCodetableItem"},"titleContribution":{"$ref":"#/components/schemas/TitleContribution"}},"description":"Title Contribution Role DTO"},"TitleLanguage":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitleLanguage","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"role":{"$ref":"#/components/schemas/OnixCodetableItem"},"language":{"$ref":"#/components/schemas/OnixCodetableItem"},"version":{"type":"string","description":"Version"}},"description":"Title Language DTO"},"TitleName":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitleName","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"type":{"$ref":"#/components/schemas/OnixCodetableItem"},"name":{"type":"string","description":"Name"},"prefix":{"type":"string","description":"Prefix"},"titleWithoutPrefix":{"type":"string","description":"Title Without Prefix"},"partNumber":{"type":"string","description":"Part Number"},"partName":{"type":"string","description":"Part Name"},"subtitle":{"type":"string","description":"Subtitle"},"version":{"type":"string","description":"Version"}},"description":"Title Name DTO"},"TitlePublicationPlace":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitlePublicationPlace","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"city":{"type":"string","description":"City"},"version":{"type":"string","description":"Version"}},"description":"Title Publication Place DTO"},"TitlePublisher":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitlePublisher","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"title":{"$ref":"#/components/schemas/Title"},"publisher":{"$ref":"#/components/schemas/Publisher"},"role":{"$ref":"#/components/schemas/OnixCodetableItem"},"publisherName":{"type":"string","description":"Publisher name"},"publicationPlace":{"type":"string","description":"Publication place"}},"description":"Title Publisher DTO"},"TitleSubject":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitleSubject","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"mainSubject":{"type":"boolean","description":"Main Subject"},"scheme":{"$ref":"#/components/schemas/OnixCodetableItem"},"code":{"type":"string","description":"Code"},"text":{"type":"string","description":"Text"},"version":{"type":"string","description":"Version"}},"description":"Title Subject DTO"},"TitleSupportingResource":{"required":["link","mode","type"],"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitleSupportingResource","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"type":{"$ref":"#/components/schemas/OnixCodetableItem"},"mode":{"$ref":"#/components/schemas/OnixCodetableItem"},"link":{"type":"string","description":"The link to the resource. Either an external URL or the public URL of an internally uploaded file.","example":"https://example.com/resource.pdf"},"storageKey":{"type":"string","description":"Storage object key when the resource is backed by an internal upload. Null for external URLs.","example":"abc-123-def-456"},"mimeType":{"type":"string","description":"MIME type of the uploaded file (only set for internal uploads)","readOnly":true,"example":"image/jpeg"},"fileSize":{"type":"integer","description":"File size in bytes (only set for internal uploads)","format":"int64","readOnly":true,"example":204800},"version":{"type":"string","description":"Version"}},"description":"Title Supporting Resource DTO"},"TitleTextContent":{"required":["text","type"],"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitleTextContent","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"type":{"$ref":"#/components/schemas/OnixCodetableItem"},"text":{"type":"string","description":"Text"},"language":{"$ref":"#/components/schemas/OnixCodetableItem"},"textAuthor":{"type":"string","description":"Text Author"},"version":{"type":"string","description":"Version"}},"description":"Title Text Content DTO"},"WorkSpecification":{"type":"object","properties":{"publisherId":{"type":"string","description":"Publisher ID - converted from String to UUID","format":"uuid"},"title":{"type":"string","description":"Title"},"subtitle":{"type":"string","description":"Subtitle"},"volumeNumber":{"type":"string","description":"Volume/part number"},"partTitle":{"type":"string","description":"Part title"},"authors":{"type":"array","description":"Authors","items":{"$ref":"#/components/schemas/Author"}},"publicationDate":{"type":"string","description":"Publication date in partial date format (YYYY, MM.YYYY, or DD.MM.YYYY)"},"editionNumber":{"type":"string","description":"Edition number"},"coEditionWith":{"type":"string","description":"Published in co-edition with"},"publicationPlace":{"type":"string","description":"Publication place (city)"},"publicationType":{"$ref":"#/components/schemas/PublicationType"},"eBookFormats":{"type":"array","description":"E-book formats","items":{"type":"string","description":"E-book/e-hudebnina format","enum":["PDF","EPUB","MOBI"]}},"otherFormats":{"type":"array","description":"Other formats","items":{"$ref":"#/components/schemas/OtherFormat"}},"dataCarrierVersions":{"type":"array","description":"Data carrier versions","items":{"type":"string","description":"Data carrier version","enum":["CD_ROM","DVD_ROM"]}},"audioBookFormats":{"type":"array","description":"Audio book formats","items":{"type":"string","description":"Audio book format","enum":["ON_CARRIER","WITHOUT_CARRIER"]}}},"description":"Work specification data for publisher publications"},"AgencyPrefix":{"required":["internationalPrefix"],"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of an AgencyPrefix","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"internationalPrefix":{"$ref":"#/components/schemas/InternationalPrefix"},"value":{"type":"string","description":"Prefix value"}},"description":"Agency Prefix DTO"},"InternationalPrefix":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of an InternationalPrefix","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"agency":{"type":"string","description":"Registration agency","enum":["ISBN","ISMN"]},"defaultAgency":{"type":"boolean","description":"Is default agency"},"value":{"type":"string","description":"Prefix value"}},"description":"International Prefix DTO"},"PublisherPrefix":{"required":["dateCreated","publisher","publisherPrefixRange","status","value"],"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a PublisherPrefix","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"publisherPrefixRange":{"$ref":"#/components/schemas/PublisherPrefixRange"},"publisher":{"$ref":"#/components/schemas/Publisher"},"value":{"type":"string","description":"Value"},"status":{"type":"string","description":"Status of the product","enum":["ACTIVE","CLOSED"]},"nextSequence":{"type":"integer","description":"Next sequence","format":"int32"},"declarationStatus":{"type":"string","description":"Last-used-number declaration status of a publisher prefix","readOnly":true,"enum":["PENDING","DECLARED","NOT_REQUIRED"]},"lastUsedNumber":{"type":"string","description":"Declared last used number (normalized, 13 digits)","readOnly":true},"noNumberUsed":{"type":"boolean","description":"True when the publisher declared no number was used yet","readOnly":true},"declaredAt":{"type":"string","description":"Timestamp of the declaration","format":"date-time","readOnly":true},"dateCreated":{"type":"string","description":"Timestamp when this publisher prefix was created. Set automatically by the server.","format":"date-time","readOnly":true}},"description":"PublisherPrefix Data Transfer Object"},"PublisherPrefixRange":{"required":["agencyPrefix","end","magnitude","nextSequence","start","status"],"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a PublisherPrefixRange","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"agencyPrefix":{"$ref":"#/components/schemas/AgencyPrefix"},"magnitude":{"type":"integer","description":"Magnitude of title number part","format":"int32"},"start":{"type":"string","description":"Start"},"end":{"type":"string","description":"End"},"status":{"type":"string","description":"Status of a publisher prefix range","enum":["ACTIVE","CLOSED"]},"nextSequence":{"type":"string","description":"Next sequence"},"version":{"type":"integer","description":"Version","format":"int32"},"isbn":{"type":"boolean"}},"description":"Publisher Prefix Range DTO"},"Measures":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a Measures","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"height":{"type":"integer","description":"Height","format":"int32"},"width":{"type":"integer","description":"Width","format":"int32"},"thickness":{"type":"integer","description":"Thickness","format":"int32"},"weight":{"type":"integer","description":"Weight","format":"int32"}},"description":"Measures Data Transfer Object"},"Product":{"required":["title"],"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a Product","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"title":{"$ref":"#/components/schemas/Title"},"ownerId":{"type":"string","description":"Owner id"},"primaryContentType":{"$ref":"#/components/schemas/OnixCodetableItem"},"form":{"$ref":"#/components/schemas/OnixCodetableItem"},"formDetails":{"type":"array","description":"Form details","items":{"$ref":"#/components/schemas/ProductFormDetail"}},"unitMeasures":{"$ref":"#/components/schemas/Measures"},"cartonMeasures":{"$ref":"#/components/schemas/Measures"},"palletMeasures":{"$ref":"#/components/schemas/Measures"},"extents":{"type":"array","description":"Extents","items":{"$ref":"#/components/schemas/ProductExtent"}},"composition":{"$ref":"#/components/schemas/OnixCodetableItem"},"publishingStatus":{"$ref":"#/components/schemas/OnixCodetableItem"},"publishingDate":{"type":"string","description":"Publishing date in partial date format (YYYY, MM.YYYY, or DD.MM.YYYY)"},"copyrightFrom":{"type":"string","description":"Copyright from in partial date format (YYYY, MM.YYYY, or DD.MM.YYYY)"},"copyrightTo":{"type":"string","description":"Copyright to in partial date format (YYYY, MM.YYYY, or DD.MM.YYYY)"},"price":{"$ref":"#/components/schemas/ProductPrice"},"accessibility":{"type":"string","description":"Accessibility enum","enum":["PRIVATE","PUBLIC"]},"publicTime":{"type":"string","description":"Public time","format":"date-time"},"version":{"type":"integer","description":"Optimistic locking version for the entity","format":"int32","readOnly":true,"example":1},"productsRelations":{"type":"array","description":"Product relations","items":{"$ref":"#/components/schemas/ProductsRelation"}}},"description":"Product Data Transfer Object"},"ProductExtent":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a ProductExtent","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"type":{"$ref":"#/components/schemas/OnixCodetableItem"},"value":{"type":"integer","description":"Value","format":"int32"},"unit":{"$ref":"#/components/schemas/OnixCodetableItem"}},"description":"ProductExtent Data Transfer Object"},"ProductFormDetail":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a ProductFormDetail","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"value":{"$ref":"#/components/schemas/OnixCodetableItem"}},"description":"ProductFormDetail Data Transfer Object"},"ProductPrice":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a ProductPrice","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"type":{"$ref":"#/components/schemas/OnixCodetableItem"},"amount":{"type":"integer","description":"Amount","format":"int32"},"currency":{"$ref":"#/components/schemas/OnixCodetableItem"}},"description":"ProductPrice Data Transfer Object"},"ProductsRelation":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a ProductsRelation","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"relatedProductId":{"type":"string","description":"Related product id"},"relationType":{"$ref":"#/components/schemas/OnixCodetableItem"}},"description":"ProductsRelation Data Transfer Object"},"ProductNumberBlockRequest":{"required":["blockReason"],"type":"object","properties":{"blockReason":{"type":"string","description":"Reason for blocking a product","enum":["UNAUTHORIZED_USE","PRESUMED_PUBLISHED","USED_BEFORE_REGISTRY"]},"blockComment":{"type":"string","description":"Block comment"}},"description":"Product Number Block Request"},"ProductNumberBlockRangeRequest":{"required":["blockReason","fromSequence","publisherPrefixId","toSequence"],"type":"object","properties":{"publisherPrefixId":{"type":"string","description":"Publisher prefix ID","format":"uuid"},"fromSequence":{"type":"integer","description":"Start of sequence range (inclusive)","format":"int32","example":0},"toSequence":{"type":"integer","description":"End of sequence range (inclusive)","format":"int32","example":50},"blockReason":{"type":"string","description":"Reason for blocking a product","enum":["UNAUTHORIZED_USE","PRESUMED_PUBLISHED","USED_BEFORE_REGISTRY"]},"blockComment":{"type":"string","description":"Block comment"}},"description":"Product Number Block Range Request"},"ProductNumberBlockRangeResponse":{"type":"object","properties":{"blockedCount":{"type":"integer","description":"Number of product numbers that were blocked","format":"int32"},"alreadyBlockedCount":{"type":"integer","description":"Number of product numbers that were already blocked","format":"int32"},"createdCount":{"type":"integer","description":"Number of product numbers created and blocked (did not exist before)","format":"int32"},"skippedAssignedCount":{"type":"integer","description":"Number of product numbers skipped because they are already assigned","format":"int32"}},"description":"Product Number Block Range Response"},"ErrorDto":{"type":"object","properties":{"message":{"type":"string","description":"Error message","example":"Validation failed"},"type":{"$ref":"#/components/schemas/ErrorType"},"code":{"type":"string","description":"Error code","example":"VALIDATION_ERROR","enum":["VALIDATION_ERROR","NOT_FOUND_ERROR"]},"parameters":{"type":"object","description":"Additional error parameters"}},"description":"Error details"},"ErrorResponseDto":{"type":"object","properties":{"errors":{"type":"array","description":"List of errors","items":{"$ref":"#/components/schemas/ErrorDto"}},"totalRecords":{"type":"integer","description":"Total number of errors","format":"int32"}},"description":"Error response containing one or more errors"},"ErrorType":{"type":"string","description":"Error type codes","enum":["-1","-2","-3","-4","-5","-6","-7","-8","-9","-10","-11","-12","-13","-14","-15","-16","-17","-18","-19","-20","-21","-22","-23","-24","-25","-28","-26","-27","-29","-30","-31","-32","-33","-34","-35","-36","-37","-38","-39","-40","-41","-42","-43","-44","-45","-46","-47","-48","-49","-50","-51","-52","-53","-54","-55","-56","-57","-58","-59","-60","-61","-62"]},"AuthorityUpdateSchedule":{"type":"object","properties":{"cronExpression":{"type":"string","description":"Standard 5-field cron expression (min hour day-of-month month day-of-week)","example":"0 3 * * *"},"enabled":{"type":"boolean","description":"Whether the schedule is active"},"harvestFrom":{"type":"string","description":"Date/time from which to harvest authorities (passed as the OAI 'from' parameter in the National Library URL). Editable; advanced to the run start after each successful run. Null means a full harvest.","format":"date-time"},"updatedAt":{"type":"string","description":"When the settings were last changed","format":"date-time","readOnly":true}},"description":"Authority update schedule"},"TitleAudienceMessage":{"type":"object","properties":{"type":{"type":"string","description":"Type - ONIX audience code type","example":"01"}},"description":"Title Audience Message DTO"},"TitleCollectionMessage":{"required":["collectionSourceId"],"type":"object","properties":{"collectionSourceId":{"type":"string","description":"Source identifier of the collection (from publisher's system)","example":"550e8400-e29b-41d4-a716-446655440000"},"partNumber":{"type":"integer","description":"Part Number within the collection","format":"int32","example":1}},"description":"Title Collection Message DTO - identifies collection by source ID"},"TitleContributionMessage":{"type":"object","properties":{"personSourceId":{"type":"string","description":"Source identifier of the person/contributor (from publisher's system)","example":"a3bb189e-8bf9-3888-9912-ace4e6543002"},"roles":{"type":"array","description":"Roles - list of ONIX contributor role codes","example":["A01","A12"],"items":{"type":"string","description":"Roles - list of ONIX contributor role codes","example":"[\"A01\",\"A12\"]"}},"unnamedPerson":{"type":"string","description":"Unnamed Person - ONIX code for unnamed persons (e.g., 'AI' for AI-generated)","example":"AI"}},"description":"Title Contribution Message DTO - identifies person by source ID"},"TitleLanguageMessage":{"type":"object","properties":{"role":{"type":"string","description":"Role - ONIX language role code","example":"01"},"language":{"type":"string","description":"Language - ISO 639-2/B code","example":"cze"}},"description":"Title Language Message DTO"},"TitleMessage":{"required":["ownerId"],"type":"object","properties":{"ownerId":{"type":"string","description":"Owner Identifier - unique identifier of the title in the owner's system","example":"BOOK-2024-001"},"names":{"type":"array","description":"Names","items":{"$ref":"#/components/schemas/TitleNameMessage"}},"editionNumber":{"type":"integer","description":"Edition Number","format":"int32"},"editionStatement":{"type":"string","description":"Edition Statement"},"languages":{"type":"array","description":"Languages","items":{"$ref":"#/components/schemas/TitleLanguageMessage"}},"subjects":{"type":"array","description":"Subjects","items":{"$ref":"#/components/schemas/TitleSubjectMessage"}},"textContents":{"type":"array","description":"Text Contents","items":{"$ref":"#/components/schemas/TitleTextContentMessage"}},"supportingResources":{"type":"array","description":"Supporting Resources","items":{"$ref":"#/components/schemas/TitleSupportingResourceMessage"}},"publicationPlaces":{"type":"array","description":"Publication Places","items":{"$ref":"#/components/schemas/TitlePublicationPlace"}},"audiences":{"type":"array","description":"Audiences","items":{"$ref":"#/components/schemas/TitleAudienceMessage"}},"ageFrom":{"type":"integer","description":"Age From","format":"int32"},"ageTo":{"type":"integer","description":"Age To","format":"int32"},"doi":{"type":"string","description":"DOI"},"illustrationsNote":{"type":"string","description":"Illustrations Note"},"imprint":{"type":"string","description":"Imprint"},"commentForAgency":{"type":"string","description":"Comment For Agency"},"titleContributions":{"type":"array","description":"Title Contributions - contributors identified by source ID","items":{"$ref":"#/components/schemas/TitleContributionMessage"}},"titlePublishers":{"type":"array","description":"Title Publishers - ONIX publisher role codes, all related to the sending publisher","example":["01","03"],"items":{"type":"string","description":"Title Publishers - ONIX publisher role codes, all related to the sending publisher","example":"[\"01\",\"03\"]"}},"collections":{"type":"array","description":"Collections - title's collections identified by source ID","items":{"$ref":"#/components/schemas/TitleCollectionMessage"}}},"description":"Title Message DTO - incoming message from publisher"},"TitleNameMessage":{"type":"object","properties":{"type":{"type":"string","description":"Type - ONIX code","example":"01"},"name":{"type":"string","description":"Name","example":"Babička"},"prefix":{"type":"string","description":"Prefix","example":"The"},"titleWithoutPrefix":{"type":"string","description":"Title Without Prefix","example":"Grandmother"},"partNumber":{"type":"string","description":"Part Number","example":"1"},"partName":{"type":"string","description":"Part Name"},"subtitle":{"type":"string","description":"Subtitle","example":"Obrazy venkovského života"}},"description":"Title Name Message DTO"},"TitleSubjectMessage":{"type":"object","properties":{"mainSubject":{"type":"boolean","description":"Main Subject flag","example":true},"scheme":{"type":"string","description":"Scheme - ONIX subject scheme identifier code","example":"93"},"code":{"type":"string","description":"Code","example":"FBC"},"text":{"type":"string","description":"Text","example":"Klasická beletrie"}},"description":"Title Subject Message DTO"},"TitleSupportingResourceMessage":{"type":"object","properties":{"link":{"type":"string","description":"Link to the resource","example":"https://example.com/image.jpg"},"mode":{"type":"string","description":"Mode - ONIX resource mode code","example":"02"},"type":{"type":"string","description":"Type - ONIX resource content type code","example":"01"}},"description":"Title Supporting Resource Message DTO"},"TitleTextContentMessage":{"type":"object","properties":{"text":{"type":"string","description":"Text content"},"type":{"type":"string","description":"Type - ONIX text type code","example":"01"},"language":{"type":"string","description":"Language - ISO 639-2/B code","example":"cze"},"textAuthor":{"type":"string","description":"Text Author","example":"Jaroslav Pospíšil"}},"description":"Title Text Content Message DTO"},"OwnCloudImportRequest":{"type":"object","properties":{"fileName":{"type":"string"}}},"ResyncRequest":{"type":"object","properties":{"titleIds":{"type":"array","items":{"type":"string","format":"uuid"}}}},"StorageUploadResponseDto":{"type":"object","properties":{"storageKey":{"type":"string"},"publicUrl":{"type":"string"},"mimeType":{"type":"string"},"fileSize":{"type":"integer","format":"int64"}}},"WipoReportParams":{"required":["registrationAgency","year"],"type":"object","properties":{"year":{"type":"integer","description":"Calendar year for the report","format":"int32","example":2025},"registrationAgency":{"type":"string","description":"Registration agency","example":"ISBN","enum":["ISBN","ISMN"]}},"description":"WIPO report parameters"},"WipoReportData":{"type":"object","properties":{"registrationAgency":{"type":"string","description":"Registration agency","enum":["ISBN","ISMN"]},"year":{"type":"integer","description":"Report year","format":"int32"},"totalCount":{"type":"integer","description":"Total registered identifiers from agency inception up to 31 December YYYY","format":"int64"},"yearCount":{"type":"integer","description":"Identifiers registered in the given year (1 January YYYY to 31 December YYYY)","format":"int64"}},"description":"WIPO report data"},"ScknReportParams":{"required":["year"],"type":"object","properties":{"year":{"type":"integer","description":"Calendar year for the report","format":"int32","example":2025}},"description":"SČKN report parameters"},"ScknGroupStats":{"type":"object","properties":{"group":{"type":"string","description":"ARES legal form group name","example":"COMMERCIAL"},"activePublishers":{"type":"integer","description":"Number of active publishers in this group","format":"int64"},"assignedIsbns":{"type":"integer","description":"Number of ISBNs assigned to publishers in this group","format":"int64"},"assignedIsmns":{"type":"integer","description":"Number of ISMNs assigned to publishers in this group","format":"int64"}},"description":"Statistics for an ARES legal form group"},"ScknReportData":{"type":"object","properties":{"year":{"type":"integer","description":"Report year","format":"int32"},"totalActivePublishers":{"type":"integer","description":"Total active publishers at end of period","format":"int64"},"totalAssignedIsbns":{"type":"integer","description":"Total assigned ISBNs in the period","format":"int64"},"totalAssignedIsmns":{"type":"integer","description":"Total assigned ISMNs in the period","format":"int64"},"groupStats":{"type":"array","description":"Publisher counts and assigned identifiers grouped by ARES legal form","items":{"$ref":"#/components/schemas/ScknGroupStats"}},"topCommercial":{"type":"array","description":"TOP 50 commercial publishers by assigned identifiers","items":{"$ref":"#/components/schemas/ScknTopPublisher"}},"topUniversity":{"type":"array","description":"TOP 50 university publishers by assigned identifiers","items":{"$ref":"#/components/schemas/ScknTopPublisher"}},"topMunicipality":{"type":"array","description":"TOP 50 municipality publishers by assigned identifiers","items":{"$ref":"#/components/schemas/ScknTopPublisher"}}},"description":"SČKN report data"},"ScknTopPublisher":{"type":"object","properties":{"name":{"type":"string","description":"Publisher name","example":"Nakladatelství Grada"},"companyNumber":{"type":"string","description":"Company registration number (IČO)","example":"12345678"},"assignedCount":{"type":"integer","description":"Total assigned identifiers (ISBN + ISMN) in the period","format":"int64"}},"description":"TOP publisher entry with assigned identifier count"},"AddressInfo":{"type":"object","properties":{"organization":{"type":"string","description":"Name of the organization","example":"National Library"},"department":{"type":"string","description":"Department or unit within the organization"},"street":{"type":"string","description":"Street address including building number"},"city":{"type":"string","description":"City name, optionally including postal code"},"country":{"type":"string","description":"Country name"}},"description":"Physical address information for the ISBN agency"},"ContactInfo":{"type":"object","properties":{"contactPerson":{"type":"string","description":"Name of the primary contact person"},"address":{"$ref":"#/components/schemas/AddressInfo"},"telephone1":{"type":"string","description":"Primary telephone number"},"telephone2":{"type":"string","description":"Secondary telephone number"},"telephone3":{"type":"string","description":"Tertiary telephone number"},"fax":{"type":"string","description":"Fax number"},"email1":{"type":"string","description":"Primary email address"},"email2":{"type":"string","description":"Secondary email address"},"email3":{"type":"string","description":"Tertiary email address"},"url":{"type":"string","description":"Website URL of the agency"}},"description":"Contact information for the ISBN agency"},"PricingInfo":{"type":"object","properties":{"chargeForIsbn":{"type":"boolean","description":"Whether the agency charges for ISBN assignments"},"pricePerIsbn":{"type":"string","description":"Price for a single ISBN assignment"},"priceFor10":{"type":"string","description":"Price for a batch of 10 ISBNs"},"priceFor100":{"type":"string","description":"Price for a batch of 100 ISBNs"},"priceFor1000":{"type":"string","description":"Price for a batch of 1000 ISBNs"},"annualMembership":{"type":"string","description":"Annual membership fee for publishers"},"registrationFee":{"type":"string","description":"One-time registration fee for new publishers"}},"description":"Pricing information for ISBN services"},"ProgressReportParams":{"type":"object","properties":{"registrationAgency":{"type":"string","description":"Registration agency","example":"ISBN","default":"ISBN","enum":["ISBN","ISMN"]},"periodFrom":{"type":"string","description":"Start date of the reporting period","format":"date","example":"2024-01-01"},"periodTo":{"type":"string","description":"End date of the reporting period","format":"date","example":"2024-12-31"},"pricing":{"$ref":"#/components/schemas/PricingInfo"},"contact":{"$ref":"#/components/schemas/ContactInfo"},"gdprConsent":{"type":"boolean","description":"Whether GDPR consent has been given for data processing","default":true}},"description":"Parameters for Progress Report generation"},"ReportResponse":{"type":"object","properties":{"fileId":{"type":"string","description":"Unique file identifier for download"},"downloadUrl":{"type":"string","description":"URL to download the generated report"},"fileName":{"type":"string","description":"Generated file name"},"contentType":{"type":"string","description":"Content type of the generated file"}},"description":"Report generation response"},"PiidExportParams":{"required":["registrationAgency"],"type":"object","properties":{"registrationAgency":{"type":"string","description":"Registration agency","example":"ISBN","enum":["ISBN","ISMN"]}},"description":"Parameters for PIID Export generation"},"PerformanceStatisticsParams":{"required":["periodFrom","periodTo"],"type":"object","properties":{"periodFrom":{"type":"string","format":"date"},"periodTo":{"type":"string","format":"date"},"workerIds":{"type":"array","items":{"type":"string","format":"uuid"}}}},"OnixExportParams":{"type":"object","properties":{"modifiedSince":{"type":"string","format":"date-time"},"modifiedBefore":{"type":"string","format":"date-time"},"titleIds":{"type":"array","items":{"type":"string","format":"uuid"}},"isbns":{"type":"array","items":{"type":"string"}},"offset":{"type":"integer","format":"int32"},"limit":{"type":"integer","format":"int32"}}},"NiposReportParams":{"required":["periodFrom","periodTo"],"type":"object","properties":{"periodFrom":{"type":"string","description":"Start date of the reporting period (inclusive)","format":"date","example":"2025-01-01"},"periodTo":{"type":"string","description":"End date of the reporting period (inclusive)","format":"date","example":"2025-12-31"},"minProductCount":{"type":"integer","description":"Minimum number of products a publisher must have to be included","format":"int32","example":4,"default":4}},"description":"Parameters for NIPOS report generation"},"Kult1801ReportParams":{"required":["publisherId","year"],"type":"object","properties":{"publisherId":{"type":"string","description":"Publisher source ID (UUID from mod-br-publishers)","example":"550e8400-e29b-41d4-a716-446655440000"},"year":{"type":"integer","description":"Calendar year for the report","format":"int32","example":2025}},"description":"Kult 18-01 report parameters"},"Kult1801ProductRow":{"type":"object","properties":{"rowNumber":{"type":"string","description":"Row number in the Kult form (0101-0109)","example":"0101"},"typeName":{"type":"string","description":"Document type name","example":"Knihy s ISBN"},"titleCount":{"type":"integer","description":"Number of titles in the year (pre-filled from ReČeK)","format":"int64"}},"description":"Kult 18-01 Part I row — document type"},"Kult1801PublisherInfo":{"type":"object","properties":{"name":{"type":"string","description":"Publisher name"},"companyNumber":{"type":"string","description":"Company registration number (IČO)"},"street":{"type":"string","description":"Street address"},"municipality":{"type":"string","description":"Municipality"},"postalCode":{"type":"string","description":"Postal code"},"email":{"type":"string","description":"E-mail"},"phone":{"type":"string","description":"Phone number"},"web":{"type":"string","description":"Website URL"},"dataBoxIsds":{"type":"string","description":"Data box (ISDS) identifier"},"kultLegalFormCode":{"type":"string","description":"Kult legal form code (11-90)"},"kultLegalFormName":{"type":"string","description":"Kult legal form name"},"czNace":{"type":"string","description":"CZ-NACE economic activity code"}},"description":"Publisher identification for Kult 18-01 header"},"Kult1801ReportData":{"type":"object","properties":{"year":{"type":"integer","description":"Report year","format":"int32"},"publisherInfo":{"$ref":"#/components/schemas/Kult1801PublisherInfo"},"productRows":{"type":"array","description":"Part I — Published documents by type (rows 0101-0109, column 2 pre-filled)","items":{"$ref":"#/components/schemas/Kult1801ProductRow"}},"fepRows":{"type":"array","description":"Part V — FEP international statistics (general vs educational/scientific)","items":{"$ref":"#/components/schemas/Kult1801ProductRow"}}},"description":"Kult 18-01 report data"},"Kult1501ReportParams":{"required":["year"],"type":"object","properties":{"year":{"type":"integer","description":"Calendar year for the report","format":"int32","example":2025}},"description":"Kult 15-01 report parameters"},"Kult1501LanguageRow":{"type":"object","properties":{"languageCode":{"type":"string","description":"ISO 639-2/B language code","example":"cze"},"languageName":{"type":"string","description":"Language name","example":"čeština"},"printedTotal":{"type":"integer","description":"Printed titles total","format":"int64"},"printedLiterary":{"type":"integer","description":"Printed literary texts (MDT 82x)","format":"int64"},"audioTotal":{"type":"integer","description":"Audio titles total","format":"int64"},"audioLiterary":{"type":"integer","description":"Audio literary texts","format":"int64"},"etotal":{"type":"integer","format":"int64"},"eliterary":{"type":"integer","format":"int64"}},"description":"Kult 15-01 language row — publication or translation language"},"Kult1501MdtRow":{"type":"object","properties":{"rowNumber":{"type":"string","description":"Row number in the Kult form (0101-0130)","example":"0101"},"groupName":{"type":"string","description":"MDT group name","example":"Všeobecnosti"},"books":{"type":"integer","description":"Printed books (≥49 pages)","format":"int64"},"brochures":{"type":"integer","description":"Printed brochures (5-48 pages)","format":"int64"},"total":{"type":"integer","description":"Total printed titles (books + brochures)","format":"int64"},"firstEdBooks":{"type":"integer","description":"First edition books (≥49 pages)","format":"int64"},"firstEdBrochures":{"type":"integer","description":"First edition brochures (5-48 pages)","format":"int64"},"firstEdTotal":{"type":"integer","description":"Total first edition titles","format":"int64"},"audioTitles":{"type":"integer","description":"Audio titles (audiobooks)","format":"int64"},"etitles":{"type":"integer","format":"int64"}},"description":"Kult 15-01 Part I row — MDT thematic group"},"Kult1501ReportData":{"type":"object","properties":{"year":{"type":"integer","description":"Report year","format":"int32"},"mdtRows":{"type":"array","description":"Part I — Titles by MDT thematic classification (rows 0101-0130)","items":{"$ref":"#/components/schemas/Kult1501MdtRow"}},"languageRows":{"type":"array","description":"Part II — Titles by publication language","items":{"$ref":"#/components/schemas/Kult1501LanguageRow"}},"translationRows":{"type":"array","description":"Part III — Translations by original language","items":{"$ref":"#/components/schemas/Kult1501LanguageRow"}}},"description":"Kult 15-01 report data"},"IpaReportParams":{"required":["registrationAgency","year"],"type":"object","properties":{"year":{"type":"integer","description":"Calendar year for the report (data valid on 31/12/YYYY)","format":"int32","example":2025},"registrationAgency":{"type":"string","description":"Registration agency (ISBN or ISMN)","example":"ISBN","enum":["ISBN","ISMN"]}},"description":"IPA report parameters"},"IpaReportData":{"type":"object","properties":{"registrationAgency":{"type":"string","description":"Registration agency (ISBN or ISMN)","enum":["ISBN","ISMN"]},"year":{"type":"integer","description":"Report year","format":"int32"},"activePublisherCount":{"type":"integer","description":"Number of active publishers as of 31 December of the given year","format":"int64"}},"description":"IPA report data"},"IdentifierReportParams":{"required":["publisherPrefixId"],"type":"object","properties":{"publisherPrefixId":{"type":"string","description":"Publisher prefix ID (UUID)","format":"uuid"}},"description":"Parameters for identifier report generation"},"AnnualReportParams":{"required":["periodFrom","periodTo"],"type":"object","properties":{"periodFrom":{"type":"string","description":"Začátek sledovaného období","format":"date","example":"2025-01-01"},"periodTo":{"type":"string","description":"Konec sledovaného období","format":"date","example":"2025-12-31"}},"description":"Parametry pro výroční zprávu NK ČR"},"AnnualReportData":{"type":"object","properties":{"newPublishersIsbn":{"type":"integer","description":"Number of newly registered ISBN publishers","format":"int64"},"newPublishersIsmn":{"type":"integer","description":"Number of newly registered ISMN publishers","format":"int64"},"totalPublishersIsbn":{"type":"integer","description":"Total ISBN publishers with prefix in the period","format":"int64"},"totalPublishersIsmn":{"type":"integer","description":"Total ISMN publishers with prefix in the period","format":"int64"},"assignedFromMiscellaneous":{"$ref":"#/components/schemas/ProductNumberStats"},"reportedFromRegistered":{"$ref":"#/components/schemas/ProductNumberStats"}},"description":"NK CR annual report data"},"ProductNumberStats":{"type":"object","properties":{"books":{"type":"integer","description":"Printed books","format":"int64"},"ebooks":{"type":"integer","description":"E-books (digital)","format":"int64"},"audiobooks":{"type":"integer","description":"Audiobooks (on physical media)","format":"int64"},"printedMusic":{"type":"integer","description":"Printed music","format":"int64"},"eaudiobooks":{"type":"integer","format":"int64"},"emusic":{"type":"integer","format":"int64"}},"description":"Product number counts by document category"},"PublisherPrefixTransferRequest":{"required":["targetPublisherId"],"type":"object","properties":{"targetPublisherId":{"type":"string","description":"Target publisher ID to transfer the prefix to"}},"description":"Publisher Prefix Transfer Request"},"PublisherPrefixLastUsedNumberRequest":{"required":["noNumberUsed"],"type":"object","properties":{"lastUsedNumber":{"type":"string","description":"Last used product number in full hyphenated form, e.g. 978-80-904073-0-5"},"noNumberUsed":{"type":"boolean","description":"True when no number has been used from this prefix yet"}},"description":"Last used number declaration request"},"PublisherPrefixDeclarationResponse":{"type":"object","properties":{"publisherPrefix":{"$ref":"#/components/schemas/PublisherPrefix"},"blockedCount":{"type":"integer","description":"Number of product numbers newly blocked","format":"int32"},"alreadyBlockedCount":{"type":"integer","description":"Number of product numbers that were already blocked","format":"int32"},"createdCount":{"type":"integer","description":"Number of product numbers created and blocked","format":"int32"},"skippedAssignedCount":{"type":"integer","description":"Number of product numbers skipped because they are already assigned","format":"int32"}},"description":"Last used number declaration result"},"MeasuresMessage":{"type":"object","properties":{"height":{"type":"integer","description":"Height in mm","format":"int32","example":210},"width":{"type":"integer","description":"Width in mm","format":"int32","example":148},"thickness":{"type":"integer","description":"Thickness in mm","format":"int32","example":15},"weight":{"type":"integer","description":"Weight in grams","format":"int32","example":350}},"description":"Measures Message DTO"},"ProductExtentMessage":{"type":"object","properties":{"type":{"type":"string","description":"Extent type - ONIX Codelist 23","example":"00"},"value":{"type":"integer","description":"Extent value","format":"int32","example":256},"unit":{"type":"string","description":"Extent unit - ONIX Codelist 24","example":"03"}},"description":"Product Extent Message DTO"},"ProductFormDetailMessage":{"type":"object","properties":{"value":{"type":"string","description":"Product form detail value - ONIX Codelist 175","example":"BC"}},"description":"Product Form Detail Message DTO"},"ProductMessage":{"required":["composition","form","ownerId","primaryContentType","publishingStatus","titleOwnerId"],"type":"object","properties":{"titleOwnerId":{"type":"string","description":"Title Owner Identifier - identifies the title in the owner's system","example":"BOOK-2024-001"},"ownerId":{"type":"string","description":"Owner Identifier - unique identifier of the product in the owner's system","example":"PROD-2024-001"},"form":{"type":"string","description":"Product form - ONIX Codelist 150","example":"BA"},"primaryContentType":{"type":"string","description":"Primary content type - ONIX Codelist 81","example":"10"},"composition":{"type":"string","description":"Product composition - ONIX Codelist 2","example":"00"},"publishingStatus":{"type":"string","description":"Publishing status - ONIX Codelist 64","example":"00"},"publishingDate":{"type":"string","description":"Publishing date (partial date string)","example":"15.06.2025"},"copyrightFrom":{"type":"string","description":"Copyright from (partial date string)","example":"2025"},"copyrightTo":{"type":"string","description":"Copyright to (partial date string)","example":"2025"},"note":{"type":"string","description":"Note"},"formDetails":{"type":"array","description":"Product form details - ONIX Codelist 175","items":{"$ref":"#/components/schemas/ProductFormDetailMessage"}},"unitMeasures":{"$ref":"#/components/schemas/MeasuresMessage"},"cartonMeasures":{"$ref":"#/components/schemas/MeasuresMessage"},"palletMeasures":{"$ref":"#/components/schemas/MeasuresMessage"},"extents":{"type":"array","description":"Product extents","items":{"$ref":"#/components/schemas/ProductExtentMessage"}},"price":{"$ref":"#/components/schemas/ProductPriceMessage"}},"description":"Product Message DTO - incoming message from publisher"},"ProductPriceMessage":{"type":"object","properties":{"type":{"type":"string","description":"Price type - ONIX Codelist 58","example":"02"},"amount":{"type":"integer","description":"Price amount in minor units (e.g. halere)","format":"int32","example":29900},"currency":{"type":"string","description":"Currency - ONIX Codelist 96","example":"CZK"}},"description":"Product Price Message DTO"},"ProductCreateWithNumberRequest":{"type":"object","properties":{"product":{"$ref":"#/components/schemas/Product"},"assignProductNumber":{"type":"boolean","description":"Whether to attempt product number assignment in the same request"},"magnitude":{"type":"integer","description":"Block size (magnitude) used to create a new publisher prefix when the publisher has none yet: 1 = block of 10, 2 = 100, 3 = 1000. When 0/null and no prefix exists, the number is not assigned and needsPublisherPrefix is returned.","format":"int32"},"publisherPrefixId":{"type":"string","description":"The exact publisher prefix to draw the number from, given as its internal UUID (one of the ids returned by the feasibility check). Kept for backward compatibility; when both this and publisherPrefix are supplied, publisherPrefixId wins. When both are omitted the system auto-selects an active prefix."},"publisherPrefix":{"type":"string","description":"Human-readable prefix value to draw the number from, e.g. \"978-80-7702\" (the label returned by the feasibility check), \"80-7702\" or the bare publisher portion \"7702\"; hyphens are optional. Preferred for external clients that do not know internal UUIDs; the value is resolved to a publisher prefix (an internal UUID is also accepted here). When it cannot be resolved, the number is not assigned and the response carries needsPublisherPrefix=true with reason PUBLISHER_PREFIX_VALUE_NOT_FOUND (no silent auto-selection of a different prefix). When omitted, an active prefix is auto-selected.","example":"978-80-7702"}},"description":"Product Create With Number Request"},"ProductCreateWithNumberResponse":{"type":"object","properties":{"product":{"$ref":"#/components/schemas/Product"},"productNumber":{"$ref":"#/components/schemas/ProductNumber"},"needsPublisherPrefix":{"type":"boolean","description":"Flag indicating that a user decision (e.g. creating a new publisher prefix) is required before a product number can be assigned"},"reason":{"type":"string","description":"Machine-readable reason why no number was assigned, so the client can tell a rejected prefix selection apart from a publisher that simply has no usable prefix. Null when the number was assigned or when only a user decision (block size) is missing.","nullable":true,"enum":["INVALID_PUBLISHER_PREFIX_SELECTION","PUBLISHER_PREFIX_VALUE_NOT_FOUND","PUBLISHER_CLOSED","DATA_NOT_CONFIRMED","PRODUCT_STATUS_NOT_ASSIGNABLE","DECLARATION_PENDING"]}},"description":"Product Create With Number Response"},"ProductNumber":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a ProductNumber","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"publisherPrefix":{"$ref":"#/components/schemas/PublisherPrefix"},"publisher":{"$ref":"#/components/schemas/Publisher"},"product":{"$ref":"#/components/schemas/Product"},"value":{"type":"string","description":"Value"},"formattedValue":{"type":"string","description":"Formatted value with dashes (e.g., 978-80-52132-01-2)"},"fullFormattedValue":{"type":"string","description":"Full formatted value with agency prefix (e.g., ISBN 978-80-52132-01-2)"},"blocked":{"type":"boolean","description":"Blocked"},"blockReason":{"type":"string","description":"Reason for blocking a product","enum":["UNAUTHORIZED_USE","PRESUMED_PUBLISHED","USED_BEFORE_REGISTRY"]},"blockComment":{"type":"string","description":"Block comment"},"note":{"type":"string","description":"Public note migrated from MARC $q qualifiers (e.g. \"(dotisk ; brož.)\")"},"selected":{"type":"boolean","description":"Flag if product number is selected"},"selectedTimestamp":{"type":"string","description":"Timestamp when object was marked as selected","format":"date-time"},"assigned":{"type":"boolean","description":"Flag if product number is assigned to a product"},"version":{"type":"integer","description":"Version for optimistic locking","format":"int32"}},"description":"ProductNumber Data Transfer Object"},"ProductNumberCreateRequest":{"required":["agency","blockReason","value"],"type":"object","properties":{"agency":{"type":"string","description":"Registration agency","enum":["ISBN","ISMN"]},"value":{"type":"string","description":"Product number value (complete ISBN-13 or ISMN)","example":"978-80-01-00000-0"},"blockReason":{"type":"string","description":"Reason for blocking a product","enum":["UNAUTHORIZED_USE","PRESUMED_PUBLISHED","USED_BEFORE_REGISTRY"]},"blockComment":{"type":"string","description":"Block comment"}},"description":"Product Number Create Request"},"ProductNumberAssignTitleRequest":{"required":["productId"],"type":"object","properties":{"productId":{"type":"string","description":"Id of the product (title without a number) to link to the blocked number"}},"description":"Assign an existing title (product without a number) to a blocked product number"},"ProductNumberAssignRequest":{"required":["productId","publisherId"],"type":"object","properties":{"productId":{"type":"string","description":"Product ID for which to assign the product number"},"publisherId":{"type":"string","description":"Publisher ID to set to product number"},"agencyPrefixId":{"type":"string","description":"Selected agency prefix ID."},"magnitude":{"type":"integer","description":"Magnitude of new prefix if one needs to be created","format":"int32","example":3},"publisherPrefixId":{"type":"string","description":"Selected publisher prefix ID (internal UUID). Kept for backward compatibility; when both this and publisherPrefix are supplied, publisherPrefixId wins."},"publisherPrefix":{"type":"string","description":"Human-readable prefix value to draw the number from, e.g. \"978-80-7702\" (the label returned by the feasibility check), \"80-7702\" or the bare publisher portion \"7702\"; hyphens are optional. This is the preferred way for external clients that do not know internal UUIDs; the value is resolved to a publisher prefix. An internal UUID is also accepted here. When it cannot be resolved or the resolved prefix has no available numbers, the request fails with a 4xx error (no silent fallback). When omitted, an active prefix is auto-selected.","example":"978-80-7702"},"productNumberId":{"type":"string","description":"Selected product number ID."}},"description":"Product Number Assign Request"},"ProductNumberAssignResponse":{"type":"object","properties":{"publisherName":{"type":"string","description":"Publisher name","example":"Albatros Media"},"publisherId":{"type":"string","description":"Id of selected publisher"},"title":{"type":"string","description":"Title","example":"Božena Němcová: Babička"},"product":{"type":"string","description":"Product","example":"Text, Pevná vazba"},"productId":{"type":"string","description":"Id of product"},"agency":{"type":"string","description":"Registration agency","example":"ISBN","enum":["ISBN","ISMN"]},"internationalPrefix":{"$ref":"#/components/schemas/InternationalPrefix"},"agencyPrefix":{"$ref":"#/components/schemas/AgencyPrefix"},"createNewPublisherPrefix":{"type":"boolean","description":"Flag for need to create new publisher prefix"},"publisherPrefix":{"$ref":"#/components/schemas/PublisherPrefix"},"publisherPrefixValue":{"type":"string","description":"Publisher prefix value"},"assignedValue":{"type":"string","description":"Assigned product number value","example":"9788012123451"},"productNumber":{"$ref":"#/components/schemas/ProductNumber"},"ready":{"type":"boolean","description":"Indicates whether the system is ready to assign the product number (all required data is available)","example":true},"assignBlockedReason":{"type":"string","description":"Machine-readable reason the assignment is blocked, set by the read-only preview when a save precondition fails; null when the product number can be assigned. One of: PRODUCT_ALREADY_HAS_ASSIGNED_NUMBER, PRODUCT_PUBLISHING_STATUS_NOT_ASSIGNABLE, PUBLISHER_CLOSED, PUBLISHER_GUARANTOR_DATA_NOT_CONFIRMED.","nullable":true,"example":"PRODUCT_ALREADY_HAS_ASSIGNED_NUMBER"}},"description":"Product Number Assign Response"},"NaturalPersonReportChangeRequest":{"type":"object","properties":{"sourceId":{"type":"string","description":"External source identifier"},"requestedChange":{"type":"string","description":"Requested change"}},"description":"Natural Person Report Change Request"},"LegalPersonReportChangeRequest":{"type":"object","properties":{"sourceId":{"type":"string","description":"External source identifier"},"requestedChange":{"type":"string","description":"Requested change"}},"description":"Legal Person Report Change Request"},"CollectionMessage":{"required":["mainName","sourceId"],"type":"object","properties":{"sourceId":{"type":"string","description":"Source Identifier - unique identifier of the collection in the publisher's system"},"type":{"type":"string","description":"Type of collection","enum":["PUBLISHER_SERIES","SERIES"]},"issn":{"type":"string","description":"ISSN of the collection"},"mainName":{"type":"string","description":"Main name of the collection"},"otherLanguageNames":{"type":"array","description":"Other language names for the collection","items":{"$ref":"#/components/schemas/CollectionNameMessage"}}},"description":"Collection Message DTO - incoming message from publisher"},"CollectionNameMessage":{"required":["name"],"type":"object","properties":{"name":{"type":"string","description":"Name of the collection in another language"}},"description":"Collection Name Message DTO - other language name for a collection"},"CoEditionNumberRequestCreateRequest":{"required":["productId"],"type":"object","properties":{"productId":{"type":"string","description":"Product ID to request the second ISBN/ISMN for"},"note":{"type":"string","description":"Optional note for the agency worker"}},"description":"Co-edition Number Request Create Request"},"CoEditionNumberRequest":{"type":"object","properties":{"id":{"type":"string","description":"The UUID of the request","readOnly":true},"product":{"$ref":"#/components/schemas/Product"},"coPublisher":{"$ref":"#/components/schemas/Publisher"},"productNumber":{"$ref":"#/components/schemas/ProductNumber"},"status":{"$ref":"#/components/schemas/CoEditionRequestStatus"},"note":{"type":"string","description":"Optional note from the requester"},"rejectionReason":{"type":"string","description":"Reason the request was rejected"},"requestedBy":{"type":"string","description":"User who created the request","readOnly":true},"dateCreated":{"type":"string","description":"Creation timestamp","format":"date-time","readOnly":true},"dateUpdated":{"type":"string","description":"Last update timestamp","format":"date-time","readOnly":true},"version":{"type":"integer","description":"Version for optimistic locking","format":"int32"}},"description":"Co-edition Number Request Data Transfer Object"},"CoEditionRequestStatus":{"type":"string","description":"Co-edition request status","enum":["REQUESTED","ASSIGNED","REJECTED"]},"CoEditionNumberRejectRequest":{"type":"object","properties":{"reason":{"type":"string","description":"Reason for rejecting the request"}},"description":"Co-edition Number Reject Request"},"CoEditionNumberAssignRequest":{"type":"object","properties":{"publisherPrefixId":{"type":"string","description":"Publisher prefix (owned by the co-publisher) to draw the number from; auto-selected when omitted"},"productNumberId":{"type":"string","description":"Previously previewed product number ID"},"magnitude":{"type":"integer","description":"Magnitude of a new co-publisher prefix if one needs to be created","format":"int32","example":3}},"description":"Co-edition Number Assign Request"},"Z3950TitleSearchRequestDto":{"type":"object","properties":{"title":{"type":"array","items":{"type":"string"}},"author":{"type":"array","items":{"type":"string"}},"isbn":{"type":"array","items":{"type":"string"}},"subject":{"type":"array","items":{"type":"string"}},"date":{"type":"array","items":{"type":"string"}},"publisher":{"type":"array","items":{"type":"string"}},"id":{"type":"array","items":{"type":"string"}},"any":{"type":"array","items":{"type":"string"}},"database":{"type":"string"},"maxResults":{"type":"integer","format":"int32"},"empty":{"type":"boolean"}}},"Z3950MarcRecordDto":{"type":"object","properties":{"id":{"type":"string"},"marcxml":{"type":"string"}}},"Z3950SearchResponseDto":{"type":"object","properties":{"records":{"type":"array","items":{"$ref":"#/components/schemas/Z3950MarcRecordDto"}},"totalCount":{"type":"integer","format":"int32"}}},"ReportRequestDto":{"required":["message","recordId","recordType"],"type":"object","properties":{"recordType":{"type":"string","enum":["TITLE","PUBLISHER"]},"recordId":{"type":"string","format":"uuid"},"message":{"type":"string"},"email":{"type":"string"}}},"ReindexResponse":{"type":"object","properties":{"core":{"type":"string"},"indexed":{"type":"integer","format":"int32"},"failed":{"type":"integer","format":"int32"},"firstFailedId":{"type":"string","format":"uuid"},"sampleError":{"type":"string"}}},"ObalkyKnihSyncResponse":{"type":"object","properties":{"checked":{"type":"integer","format":"int32"},"found":{"type":"integer","format":"int32"},"updated":{"type":"integer","format":"int32"},"failedChunks":{"type":"integer","format":"int32"}}},"InboxEvent":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of an InboxEvent","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"type":{"type":"string","description":"Event type"},"source":{"type":"string","description":"Event source"},"payload":{"type":"string","description":"Event payload"},"userId":{"type":"string","description":"User ID of the user who triggered the event"}},"description":"Inbox Event DTO"},"ResolvePublisherRequest":{"type":"object","properties":{"sourceId":{"type":"string","description":"Source ID of the real publisher to resolve to"}},"description":"Resolve Publisher Request"},"FindPublisherByProductNumbersRequest":{"required":["productNumbers"],"type":"object","properties":{"productNumbers":{"type":"array","items":{"type":"string"}}}},"FindPublisherByProductNumbersResponse":{"type":"object","properties":{"sourceId":{"type":"string"}}},"PublishProductVerificationRequest":{"required":["publishingDate"],"type":"object","properties":{"publishingDate":{"type":"string","format":"date"}}},"CollectionRefDto":{"type":"object","properties":{"sourceId":{"type":"string","format":"uuid"}}},"MeasuresSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"height":{"type":"integer","format":"int32"},"width":{"type":"integer","format":"int32"},"thickness":{"type":"integer","format":"int32"},"weight":{"type":"integer","format":"int32"}}},"OnixItemRefDto":{"type":"object","properties":{"sourceId":{"type":"string","format":"uuid"}}},"ProductExtentSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"$ref":"#/components/schemas/OnixItemRefDto"},"value":{"type":"integer","format":"int32"},"unit":{"$ref":"#/components/schemas/OnixItemRefDto"}}},"ProductFormDetailSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"value":{"$ref":"#/components/schemas/OnixItemRefDto"}}},"ProductNumberSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"value":{"type":"string"},"formattedValue":{"type":"string"},"fullFormattedValue":{"type":"string"},"blocked":{"type":"boolean"},"blockReason":{"type":"string"},"blockComment":{"type":"string"},"note":{"type":"string"},"selected":{"type":"boolean"},"selectedTimestamp":{"type":"string","format":"date-time"},"assigned":{"type":"boolean"},"dateCreated":{"type":"string","format":"date-time"},"publisher":{"$ref":"#/components/schemas/PublisherRefDto"}}},"ProductPriceSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"$ref":"#/components/schemas/OnixItemRefDto"},"amount":{"type":"integer","format":"int32"},"currency":{"$ref":"#/components/schemas/OnixItemRefDto"}}},"ProductRefDto":{"type":"object","properties":{"sourceId":{"type":"string","format":"uuid"}}},"ProductSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"$ref":"#/components/schemas/TitleRefDto"},"ownerId":{"type":"string"},"primaryContentType":{"$ref":"#/components/schemas/OnixItemRefDto"},"form":{"$ref":"#/components/schemas/OnixItemRefDto"},"formDetails":{"type":"array","items":{"$ref":"#/components/schemas/ProductFormDetailSyncDto"}},"unitMeasures":{"$ref":"#/components/schemas/MeasuresSyncDto"},"cartonMeasures":{"$ref":"#/components/schemas/MeasuresSyncDto"},"palletMeasures":{"$ref":"#/components/schemas/MeasuresSyncDto"},"extents":{"type":"array","items":{"$ref":"#/components/schemas/ProductExtentSyncDto"}},"composition":{"$ref":"#/components/schemas/OnixItemRefDto"},"publishingStatus":{"$ref":"#/components/schemas/OnixItemRefDto"},"publishingDate":{"type":"string"},"copyrightFrom":{"type":"string"},"copyrightTo":{"type":"string"},"price":{"$ref":"#/components/schemas/ProductPriceSyncDto"},"accessibility":{"type":"string"},"publicTime":{"type":"string","format":"date-time"},"numbers":{"type":"array","items":{"$ref":"#/components/schemas/ProductNumberSyncDto"}},"productsRelations":{"type":"array","items":{"$ref":"#/components/schemas/ProductsRelationSyncDto"}},"note":{"type":"string"},"dateUpdated":{"type":"string","format":"date-time"}}},"ProductsRelationSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"relatedProduct":{"$ref":"#/components/schemas/ProductRefDto"},"relationType":{"$ref":"#/components/schemas/OnixItemRefDto"}}},"PublishProductVerificationResponse":{"type":"object","properties":{"product":{"$ref":"#/components/schemas/ProductSyncDto"},"title":{"$ref":"#/components/schemas/TitleSyncDto"}}},"PublisherRefDto":{"type":"object","properties":{"source":{"type":"string"},"sourceId":{"type":"string","format":"uuid"}}},"TitleAudienceSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"$ref":"#/components/schemas/OnixItemRefDto"}}},"TitleCollectionSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"collection":{"$ref":"#/components/schemas/CollectionRefDto"},"partNumber":{"type":"string"}}},"TitleContributionRoleSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"role":{"$ref":"#/components/schemas/OnixItemRefDto"}}},"TitleContributionSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"personSourceId":{"type":"string","format":"uuid"},"sequenceNumber":{"type":"integer","format":"int32"},"firstName":{"type":"string"},"lastName":{"type":"string"},"biographicalNote":{"type":"string"},"name":{"type":"string"},"unnamedPerson":{"$ref":"#/components/schemas/OnixItemRefDto"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/TitleContributionRoleSyncDto"}}}},"TitleLanguageSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"role":{"$ref":"#/components/schemas/OnixItemRefDto"},"language":{"$ref":"#/components/schemas/OnixItemRefDto"}}},"TitleNameSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"$ref":"#/components/schemas/OnixItemRefDto"},"name":{"type":"string"},"prefix":{"type":"string"},"titleWithoutPrefix":{"type":"string"},"partNumber":{"type":"string"},"partName":{"type":"string"},"subtitle":{"type":"string"}}},"TitlePublicationPlaceSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"city":{"type":"string"}}},"TitlePublisherSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"publisher":{"$ref":"#/components/schemas/PublisherRefDto"},"publisherName":{"type":"string"},"publicationPlace":{"type":"string"},"role":{"$ref":"#/components/schemas/OnixItemRefDto"}}},"TitleRefDto":{"type":"object","properties":{"sourceId":{"type":"string","format":"uuid"}}},"TitleSubjectSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"scheme":{"$ref":"#/components/schemas/OnixItemRefDto"},"mainSubject":{"type":"boolean"},"code":{"type":"string"},"text":{"type":"string"}}},"TitleSupportingResourceSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"$ref":"#/components/schemas/OnixItemRefDto"},"mode":{"$ref":"#/components/schemas/OnixItemRefDto"},"link":{"type":"string"}}},"TitleSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"owner":{"$ref":"#/components/schemas/PublisherRefDto"},"ownerId":{"type":"string"},"ownerUnresolved":{"type":"boolean"},"editionNumber":{"type":"integer","format":"int32"},"editionStatement":{"type":"string"},"doi":{"type":"string"},"illustrationsNote":{"type":"string"},"names":{"type":"array","items":{"$ref":"#/components/schemas/TitleNameSyncDto"}},"subjects":{"type":"array","items":{"$ref":"#/components/schemas/TitleSubjectSyncDto"}},"contributions":{"type":"array","items":{"$ref":"#/components/schemas/TitleContributionSyncDto"}},"publishers":{"type":"array","items":{"$ref":"#/components/schemas/TitlePublisherSyncDto"}},"collections":{"type":"array","items":{"$ref":"#/components/schemas/TitleCollectionSyncDto"}},"languages":{"type":"array","items":{"$ref":"#/components/schemas/TitleLanguageSyncDto"}},"textContents":{"type":"array","items":{"$ref":"#/components/schemas/TitleTextContentSyncDto"}},"supportingResources":{"type":"array","items":{"$ref":"#/components/schemas/TitleSupportingResourceSyncDto"}},"publicationPlaces":{"type":"array","items":{"$ref":"#/components/schemas/TitlePublicationPlaceSyncDto"}},"audiences":{"type":"array","items":{"$ref":"#/components/schemas/TitleAudienceSyncDto"}},"ageFrom":{"type":"integer","format":"int32"},"ageTo":{"type":"integer","format":"int32"},"imprint":{"type":"string"},"dateUpdated":{"type":"string","format":"date-time"}}},"TitleTextContentSyncDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"$ref":"#/components/schemas/OnixItemRefDto"},"language":{"$ref":"#/components/schemas/OnixItemRefDto"},"text":{"type":"string"}}},"FindProductByProductNumberRequest":{"required":["productNumber"],"type":"object","properties":{"productNumber":{"type":"string"}}},"FindProductByProductNumberResponse":{"type":"object","properties":{"found":{"type":"boolean"},"product":{"$ref":"#/components/schemas/ProductSyncDto"},"title":{"$ref":"#/components/schemas/TitleSyncDto"}}},"SyncStatusDto":{"type":"object","properties":{"type":{"type":"string"},"status":{"type":"string"},"syncedCount":{"type":"integer","format":"int32"},"totalCount":{"type":"integer","format":"int32"},"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"durationSeconds":{"type":"integer","format":"int64"},"errorMessage":{"type":"string"}}},"AuthorityUpdateRun":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"trigger":{"type":"string","description":"How the run was triggered","example":"SCHEDULED"},"status":{"type":"string","description":"Run status","example":"COMPLETED"},"startedAt":{"type":"string","description":"When the run started","format":"date-time"},"finishedAt":{"type":"string","description":"When the run finished (null while running)","format":"date-time"},"durationMs":{"type":"integer","description":"Duration in milliseconds (null while running)","format":"int64"},"naturalCreated":{"type":"integer","description":"Natural-person authorities created","format":"int32"},"naturalUpdated":{"type":"integer","description":"Natural-person authorities updated","format":"int32"},"legalCreated":{"type":"integer","description":"Legal-person authorities created","format":"int32"},"legalUpdated":{"type":"integer","description":"Legal-person authorities updated","format":"int32"},"totalCreated":{"type":"integer","description":"Total authorities created across both feeds","format":"int32"},"totalUpdated":{"type":"integer","description":"Total authorities updated across both feeds","format":"int32"},"totalRecords":{"type":"integer","description":"Total records read across both feeds","format":"int32"},"errorMessage":{"type":"string","description":"Error message when status is FAILED"}},"description":"Authority update run statistics"},"AuthorityUpdateStatus":{"type":"object","properties":{"schedule":{"$ref":"#/components/schemas/AuthorityUpdateSchedule"},"running":{"type":"boolean","description":"Whether a run is currently in progress"},"nextRunAt":{"type":"string","description":"Next planned run time derived from the cron (null when disabled or cron invalid)","format":"date-time"},"lastRun":{"$ref":"#/components/schemas/AuthorityUpdateRun"}},"description":"Authority update status"},"tenantAttributes":{"type":"object","properties":{"module_from":{"type":"string","description":"Existing module ID. If omitted, the module is not enabled already"},"module_to":{"type":"string","description":"Target module ID. If omitted, the existing module is disabled"},"purge":{"type":"boolean","description":"On disable should data also be purged"},"parameters":{"type":"array","description":"List of key/value parameters","items":{"$ref":"#/components/schemas/parameter"}}},"description":"Configuration how to install, upgrade or delete a module for a tenant"},"ProductAccessibilityRequest":{"type":"object","properties":{"accessibility":{"type":"string","description":"Accessibility enum","enum":["PRIVATE","PUBLIC"]}},"description":"Product Accessibility Request"},"TitleCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/Title"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"TitleSearchCriteria":{"type":"object","properties":{"name":{"type":"string","description":"Name, location name or subname of the title"},"contributor":{"type":"string","description":"Last name or name of company of the contributor"},"publisher":{"type":"string","description":"The uuid of publisher"},"productNumber":{"type":"string","description":"Product number (ISBN/ISMN) value (raw or formatted, partial match, case-insensitive)"},"collection":{"type":"string","description":"The uuid of collection the title belongs to"},"hasCommentForAgency":{"type":"boolean","description":"When true, returns only titles that have a non-blank comment for agency"}},"description":"Title Search Criteria DTO"},"TitleSearch":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a TitleSearch","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"mainTitle":{"type":"string","description":"The main title of the Title"},"partNumber":{"type":"string","description":"The part number of the Title"},"partName":{"type":"string","description":"The part name of the Title"},"firstContributor":{"type":"string","description":"The first contributor of the Title, usually the author or creator"},"publisher":{"type":"string","description":"Name of the publisher owner of the Title"},"ownerSourceId":{"type":"string","description":"The sourceId of the publisher that owns the Title, used by clients to gate edit/create actions per row (e.g. a co-publisher who does not own the title)"},"editionNumber":{"type":"integer","description":"The edition number of the Title","format":"int32","example":2},"editionStatement":{"type":"string","description":"The edition statement of the Title","example":"2., doplněné vydání"},"publicationYear":{"type":"integer","description":"Publication year taken from the earliest published product of the Title","format":"int32","example":2025},"products":{"type":"array","description":"The products of the Title (id and ONIX form), used to link to each product","items":{"$ref":"#/components/schemas/TitleSearchProduct"}}},"description":"Title Search DTO"},"TitleSearchCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/TitleSearch"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"TitleSearchProduct":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of the product","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"form":{"type":"string","description":"The ONIX product form code (Codetable 150 value) of the product","example":"BB"}},"description":"A product of a Title referenced from the title search"},"FailedRecord":{"type":"object","properties":{"recordNumber":{"type":"integer","format":"int32"},"controlNumber":{"type":"string"},"errorMessage":{"type":"string"}},"description":"List of records that produced warnings"},"TitleImportStatusDto":{"type":"object","properties":{"fileName":{"type":"string","description":"Name of the imported file","example":"nkp_export_2024.xml"},"status":{"type":"string","description":"Current import status","enum":["IN_PROGRESS","COMPLETED","FAILED"]},"totalRecords":{"type":"integer","description":"Total number of records in file (0 if unknown during streaming)","format":"int64"},"processedRecords":{"type":"integer","description":"Number of records processed so far","format":"int64"},"progressPercent":{"type":"integer","description":"Progress percentage (0-100, only accurate when totalRecords is known)","format":"int32"},"phase":{"type":"string","description":"Current import phase","enum":["SCANNING","RESERVING","IMPORTING"]},"phaseProcessed":{"type":"integer","description":"Records processed within the current phase","format":"int64"},"phaseTotal":{"type":"integer","description":"Total records to process within the current phase","format":"int64"},"titlesCreated":{"type":"integer","description":"Number of titles created","format":"int64"},"productsCreated":{"type":"integer","description":"Number of products created","format":"int64"},"productNumbersCreated":{"type":"integer","description":"Number of product numbers (ISBNs) created","format":"int64"},"skippedRecords":{"type":"integer","description":"Number of records skipped (duplicates, etc.)","format":"int64"},"skippedBatches":{"type":"integer","description":"Number of whole batches skipped after exhausting their lock-conflict retries. Non-zero means records are missing from an import that still reports COMPLETED.","format":"int64"},"errorCount":{"type":"integer","description":"Number of errors encountered","format":"int32"},"warningCount":{"type":"integer","description":"Number of warnings encountered","format":"int32"},"startedAt":{"type":"string","description":"Import start time","format":"date-time"},"completedAt":{"type":"string","description":"Import completion time (null if still in progress)","format":"date-time"},"estimatedSecondsRemaining":{"type":"integer","description":"Estimated seconds remaining (null if cannot be estimated)","format":"int64"},"estimatedCompletionAt":{"type":"string","description":"Estimated completion time (null if cannot be estimated)","format":"date-time"},"errorRecords":{"type":"array","description":"List of records that failed with errors","items":{"$ref":"#/components/schemas/FailedRecord"}},"warningRecords":{"type":"array","description":"List of records that produced warnings","items":{"$ref":"#/components/schemas/FailedRecord"}}},"description":"Title import status with progress details"},"OwnCloudFileDto":{"type":"object","properties":{"name":{"type":"string"},"path":{"type":"string"},"size":{"type":"integer","format":"int64"},"lastModified":{"type":"string","format":"date-time"},"contentType":{"type":"string"}}},"OwnCloudFileDtoCollection":{"type":"object","properties":{"files":{"type":"array","items":{"$ref":"#/components/schemas/OwnCloudFileDto"}},"totalRecords":{"type":"integer","format":"int32"}}},"CollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/FailedRecord"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}},"description":"Collection Response"},"ImportProgressDto":{"type":"object","properties":{"status":{"type":"string","enum":["DOWNLOADING","RUNNING","COMPLETED","FAILED"]},"totalRecords":{"type":"integer","format":"int32"},"currentRecord":{"type":"integer","format":"int32"},"successCount":{"type":"integer","format":"int32"},"missing1xxCount":{"type":"integer","format":"int32"},"duplicateCount":{"type":"integer","format":"int32"},"skippedNameTitleCount":{"type":"integer","format":"int32"},"failedCount":{"type":"integer","format":"int32"},"failedRecords":{"type":"array","items":{"$ref":"#/components/schemas/FailedRecord"}},"percentComplete":{"type":"number","format":"double"},"estimatedSecondsRemaining":{"type":"integer","format":"int64"}}},"StreamingResponseBody":{"type":"object"},"PublisherPrefixCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/PublisherPrefix"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"PublisherPrefixRangeCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/PublisherPrefixRange"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"ProductCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/Product"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"ProductSearchCriteria":{"type":"object","properties":{"name":{"type":"string","description":"Name, location name or subname of the title"},"contributor":{"type":"string","description":"Last name or name of company of the contributor"},"publisher":{"type":"string","description":"The uuid of publisher"},"productNumber":{"type":"string","description":"Product number value (raw or formatted, partial match, case-insensitive)"},"accessibility":{"type":"string","description":"Accessibility filter (PUBLIC or PRIVATE)","enum":["PRIVATE","PUBLIC"]}},"description":"Product Search Criteria DTO"},"ProductSearch":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a ProductSearch","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"firstContributor":{"type":"string","description":"The first contributor of the Product, usually the author or creator"},"editionNumber":{"type":"integer","description":"The edition number of the Product's Title","format":"int32"},"publisher":{"type":"string","description":"Name of the publisher owner of the Product"},"mainTitle":{"type":"string","description":"The main title of the Product"},"partNumber":{"type":"string","description":"The title part number of the Product"},"partName":{"type":"string","description":"The title part name of the Product"},"productNumber":{"type":"string","description":"The number of the Product, usually ISBN or similar"},"formattedProductNumber":{"type":"string","description":"The formatted number of the Product, usually ISBN or similar"},"fullFormattedProductNumber":{"type":"string","description":"Full formatted product number with registration agency, e.g. ISBN 978-80-123-0001-4"},"publishingDate":{"type":"string","description":"The publishing date of the Product"},"primaryContentType":{"type":"string","description":"The primary content type of the Product"},"form":{"type":"string","description":"The form of the Product"},"accessibility":{"type":"string","description":"The accessibility of the Product, e.g., public, private"},"publishingStatus":{"type":"string","description":"The ONIX publishing status of the Product (ONIX Codetable 64)"},"relatedProducts":{"type":"array","description":"Related products, rendered as navigation buttons in the product list","items":{"$ref":"#/components/schemas/RelatedProductSearch"}}},"description":"Product Search DTO"},"ProductSearchCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/ProductSearch"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"RelatedProductSearch":{"type":"object","properties":{"targetId":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of the related (target) product to navigate to","example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"form":{"type":"string","description":"The ONIX product form value of the related product, used as the button label"}},"description":"Related product reference for the product search result"},"ProductNumberCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/ProductNumber"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"ProductNumberSearchCriteria":{"type":"object","properties":{"publisherId":{"type":"string","description":"The UUID of the publisher"},"publisherPrefixId":{"type":"string","description":"The UUID of the publisher prefix"},"value":{"type":"string","description":"The value of the product number to search for"},"blocked":{"type":"boolean","description":"Filter by blocked status"}},"description":"Product Number Search Criteria DTO"},"ProductNumberSearch":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a ProductNumber","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"productNumber":{"type":"string","description":"The product number value with agency prefix, in format ISBN 978-80-123-0001-4"},"publisherName":{"type":"string","description":"Name of the publisher"},"blocked":{"type":"boolean","description":"Whether the product number is blocked"},"blockReason":{"type":"string","description":"Reason for blocking a product","enum":["UNAUTHORIZED_USE","PRESUMED_PUBLISHED","USED_BEFORE_REGISTRY"]},"blockComment":{"type":"string","description":"Free-text comment describing why the product number is blocked; null when not blocked"},"mainTitle":{"type":"string","description":"The main title of the Title the product number is assigned to"},"partNumber":{"type":"string","description":"The part number of the Title the product number is assigned to"},"partName":{"type":"string","description":"The part name of the Title the product number is assigned to"},"firstContributor":{"type":"string","description":"The first contributor of the Title, usually the author or creator"},"editionNumber":{"type":"integer","description":"The edition number of the Title","format":"int32","example":2},"editionStatement":{"type":"string","description":"The edition statement of the Title","example":"2., doplněné vydání"},"publicationYear":{"type":"integer","description":"Publication year of the product the product number is assigned to","format":"int32","example":2025},"productForm":{"type":"string","description":"Product form of the product, ONIX codelist 150 code","example":"BC"}},"description":"Product Number Search DTO"},"ProductNumberSearchCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/ProductNumberSearch"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"ProductNumberFeasibilityPrefixOption":{"type":"object","properties":{"publisherPrefixId":{"type":"string","description":"The publisher prefix ID to send back on the create-with-number request.","example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"label":{"type":"string","description":"Human-readable full prefix (international + agency + publisher prefix, hyphen-joined).","example":"978-80-7702"}},"description":"Choosable publisher prefix option"},"ProductNumberFeasibilityResponse":{"type":"object","properties":{"canAssign":{"type":"boolean","description":"True if a product number can be assigned now (possibly by creating a new publisher prefix)","example":true},"agency":{"type":"string","description":"Registration agency","example":"ISMN","enum":["ISBN","ISMN"]},"needsNewPrefix":{"type":"boolean","description":"True when assignment is possible but requires creating a new publisher prefix (the user will pick a block size). Only meaningful when canAssign = true.","example":false},"reason":{"type":"string","description":"Machine-readable reason code when canAssign = false; null when canAssign = true. One of: PUBLISHER_CLOSED, DATA_NOT_CONFIRMED, NO_AGENCY_PREFIX, NO_AVAILABLE_NUMBERS, DECLARATION_PENDING.","nullable":true,"example":"PUBLISHER_CLOSED"},"prefixes":{"type":"array","description":"Active publisher prefixes the user may draw the next ISBN/ISMN from. Populated only when canAssign = true and needsNewPrefix = false; empty otherwise. Each option carries the prefix id to send back on the create-with-number request and a human-readable label.","items":{"$ref":"#/components/schemas/ProductNumberFeasibilityPrefixOption"}}},"description":"Product Number Assignment Feasibility Response"},"PersonCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/Person"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"PersonSearchOption":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"legalForm":{"type":"string","description":"Legal form","enum":["LEGAL","NATURAL"]},"firstName":{"type":"string"},"lastName":{"type":"string"},"birthDate":{"type":"string"},"deathDate":{"type":"string"},"name":{"type":"string"},"biographicalNote":{"type":"string"},"sourceId":{"type":"string"}},"description":"Lightweight person projection for typeahead/search dropdowns"},"OnixCodetableCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/OnixCodetable"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"OnixCodetableItemCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/OnixCodetableItem"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"NaturalPersonCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/NaturalPerson"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"LegalPersonCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/LegalPerson"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"InternationalPrefixCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/InternationalPrefix"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"CollectionCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/Collection"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"CoEditionNumberRequestCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/CoEditionNumberRequest"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"AlternativeTitleDto":{"type":"object","properties":{"name":{"type":"string"},"subtitle":{"type":"string"},"type":{"type":"string"}}},"CodedValueDto":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}}},"CollectionDetailDto":{"type":"object","properties":{"name":{"type":"string"},"part":{"type":"string"},"type":{"type":"string","enum":["PUBLISHER_SERIES","SERIES"]}}},"ContributorDetailDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"displayName":{"type":"string"},"birthDate":{"type":"string"},"deathDate":{"type":"string"},"roles":{"type":"array","items":{"type":"string"}},"anonymized":{"type":"boolean"},"sourceId":{"type":"string"}}},"ExtentDetailDto":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/CodedValueDto"},"value":{"type":"integer","format":"int32"},"unit":{"$ref":"#/components/schemas/CodedValueDto"}}},"MeasuresDetailDto":{"type":"object","properties":{"height":{"type":"integer","format":"int32"},"width":{"type":"integer","format":"int32"},"thickness":{"type":"integer","format":"int32"},"weight":{"type":"integer","format":"int32"}}},"PriceDetailDto":{"type":"object","properties":{"amount":{"type":"integer","format":"int32"},"currency":{"type":"string"}}},"ProductDetailDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"format":{"type":"string","enum":["PRINT","EBOOK","AUDIO","OTHER"]},"productNumbers":{"type":"array","items":{"type":"string"}},"productNumbersFormatted":{"type":"array","items":{"type":"string"}},"numbers":{"type":"array","items":{"$ref":"#/components/schemas/ProductNumberDetailDto"}},"publishedDate":{"type":"string"},"primaryContentType":{"$ref":"#/components/schemas/CodedValueDto"},"formDetails":{"type":"array","items":{"$ref":"#/components/schemas/CodedValueDto"}},"measures":{"$ref":"#/components/schemas/MeasuresDetailDto"},"extents":{"type":"array","items":{"$ref":"#/components/schemas/ExtentDetailDto"}},"composition":{"$ref":"#/components/schemas/CodedValueDto"},"publishingStatus":{"$ref":"#/components/schemas/CodedValueDto"},"price":{"$ref":"#/components/schemas/PriceDetailDto"},"relations":{"type":"array","items":{"$ref":"#/components/schemas/ProductRelationDetailDto"}}}},"ProductNumberDetailDto":{"type":"object","properties":{"value":{"type":"string"},"formatted":{"type":"string"},"note":{"type":"string"}}},"ProductRelationDetailDto":{"type":"object","properties":{"relationType":{"$ref":"#/components/schemas/CodedValueDto"},"relatedProductId":{"type":"string"},"relatedTitleId":{"type":"string"},"relatedTitleName":{"type":"string"}}},"PublisherReferenceDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"SubjectDetailDto":{"type":"object","properties":{"text":{"type":"string"},"code":{"type":"string"},"mainSubject":{"type":"boolean"}}},"TextContentDto":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/CodedValueDto"},"text":{"type":"string"}}},"TitleDetailDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"subtitle":{"type":"string"},"alternativeNames":{"type":"array","items":{"$ref":"#/components/schemas/AlternativeTitleDto"}},"annotation":{"type":"string"},"contents":{"type":"array","items":{"$ref":"#/components/schemas/TextContentDto"}},"publisher":{"$ref":"#/components/schemas/PublisherReferenceDto"},"publishedYear":{"type":"integer","format":"int32"},"publicationPlaces":{"type":"array","items":{"type":"string"}},"imprint":{"type":"string"},"editionStatement":{"type":"string"},"editionNumber":{"type":"integer","format":"int32"},"illustrationsNote":{"type":"string"},"doi":{"type":"string"},"ageFrom":{"type":"integer","format":"int32"},"ageTo":{"type":"integer","format":"int32"},"audiences":{"type":"array","items":{"$ref":"#/components/schemas/CodedValueDto"}},"languages":{"type":"array","items":{"type":"string"}},"coverUrl":{"type":"string"},"tocThumbnailUrl":{"type":"string"},"tocPdfUrl":{"type":"string"},"backlinkUrl":{"type":"string"},"coverSource":{"type":"string","enum":["RECEK","OBALKY_KNIH"]},"collections":{"type":"array","items":{"$ref":"#/components/schemas/CollectionDetailDto"}},"contributors":{"type":"array","items":{"$ref":"#/components/schemas/ContributorDetailDto"}},"products":{"type":"array","items":{"$ref":"#/components/schemas/ProductDetailDto"}},"skcLink":{"type":"string"},"subjects":{"type":"array","items":{"$ref":"#/components/schemas/SubjectDetailDto"}},"permalink":{"type":"string"}}},"ContributorSummaryDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"displayName":{"type":"string"},"roles":{"type":"array","items":{"type":"string"}}}},"ProductNumberSummaryDto":{"type":"object","properties":{"value":{"type":"string"},"formatted":{"type":"string"},"note":{"type":"string"}}},"TitleRecommendationsDto":{"type":"object","properties":{"author":{"type":"array","items":{"$ref":"#/components/schemas/TitleSummaryDto"}},"series":{"type":"array","items":{"$ref":"#/components/schemas/TitleSummaryDto"}},"thema":{"type":"array","items":{"$ref":"#/components/schemas/TitleSummaryDto"}},"publisher":{"type":"array","items":{"$ref":"#/components/schemas/TitleSummaryDto"}}}},"TitleSummaryDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"subtitle":{"type":"string"},"contributors":{"type":"array","items":{"$ref":"#/components/schemas/ContributorSummaryDto"}},"publisher":{"$ref":"#/components/schemas/PublisherReferenceDto"},"year":{"type":"integer","format":"int32"},"publishedDate":{"type":"string"},"language":{"type":"array","items":{"type":"string"}},"formats":{"type":"array","items":{"type":"string","enum":["PRINT","EBOOK","AUDIO","OTHER"]}},"productNumbers":{"type":"array","items":{"type":"string"}},"productNumbersFormatted":{"type":"array","items":{"type":"string"}},"numbers":{"type":"array","items":{"$ref":"#/components/schemas/ProductNumberSummaryDto"}},"coverUrl":{"type":"string"}}},"SitemapEntryDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"lastModified":{"type":"string","format":"date-time"}}},"SitemapResponseDto":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SitemapEntryDto"}},"total":{"type":"integer","format":"int64"}}},"FacetEntryDto":{"type":"object","properties":{"key":{"type":"string"},"count":{"type":"integer","format":"int64"}}},"FacetsDto":{"type":"object","properties":{"format":{"type":"array","items":{"$ref":"#/components/schemas/FacetEntryDto"}},"language":{"type":"array","items":{"$ref":"#/components/schemas/FacetEntryDto"}},"year":{"type":"array","items":{"$ref":"#/components/schemas/FacetEntryDto"}},"publisher":{"type":"array","items":{"$ref":"#/components/schemas/FacetEntryDto"}},"thema":{"type":"array","items":{"$ref":"#/components/schemas/FacetEntryDto"}},"audience":{"type":"array","items":{"$ref":"#/components/schemas/FacetEntryDto"}}}},"TitleSearchResponseDto":{"type":"object","properties":{"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"items":{"type":"array","items":{"$ref":"#/components/schemas/TitleSummaryDto"}},"facets":{"$ref":"#/components/schemas/FacetsDto"},"hasAbsoluteMatch":{"type":"boolean"},"fallback":{"type":"boolean"}}},"CatalogStatsDto":{"type":"object","properties":{"titlesTotal":{"type":"integer","format":"int64"},"publishersTotal":{"type":"integer","format":"int64"},"titlesNewLastYear":{"type":"integer","format":"int64"},"titlesNewThisYear":{"type":"integer","format":"int64"}}},"ActivePeriodDto":{"type":"object","properties":{"from":{"type":"integer","format":"int32"},"to":{"type":"integer","format":"int32"}}},"AddressDto":{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"postalCode":{"type":"string"},"region":{"type":"string"}}},"AlternativeNameDto":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}}},"ContactDto":{"type":"object","properties":{"type":{"type":"string"},"value":{"type":"string"},"info":{"type":"string"}}},"PrefixDto":{"type":"object","properties":{"value":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"}}},"PublisherDetailDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"alternativeNames":{"type":"array","items":{"$ref":"#/components/schemas/AlternativeNameDto"}},"legalForm":{"type":"string"},"status":{"type":"string"},"city":{"type":"string"},"founded":{"type":"integer","format":"int32"},"founder":{"type":"string"},"titleCount":{"type":"integer","format":"int64"},"activePeriod":{"$ref":"#/components/schemas/ActivePeriodDto"},"companyNumber":{"type":"string"},"taxNumber":{"type":"string"},"address":{"$ref":"#/components/schemas/AddressDto"},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/ContactDto"}},"prefixes":{"type":"array","items":{"$ref":"#/components/schemas/PrefixDto"}},"permalink":{"type":"string"}}},"PublisherFacetsDto":{"type":"object","properties":{"legalForm":{"type":"array","items":{"$ref":"#/components/schemas/FacetEntryDto"}},"status":{"type":"array","items":{"$ref":"#/components/schemas/FacetEntryDto"}},"region":{"type":"array","items":{"$ref":"#/components/schemas/FacetEntryDto"}},"active":{"type":"array","items":{"$ref":"#/components/schemas/FacetEntryDto"}}}},"PublisherSearchResponseDto":{"type":"object","properties":{"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PublisherSummaryDto"}},"facets":{"$ref":"#/components/schemas/PublisherFacetsDto"}}},"PublisherSummaryDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"legalForm":{"type":"string"},"status":{"type":"string"},"founded":{"type":"integer","format":"int32"},"active":{"type":"boolean"}}},"AuthorDetailDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"displayName":{"type":"string"},"roles":{"type":"array","items":{"type":"string"}},"titleCount":{"type":"integer","format":"int64"},"titles":{"type":"array","items":{"$ref":"#/components/schemas/TitleSummaryDto"}},"permalink":{"type":"string"},"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalPages":{"type":"integer","format":"int32"}}},"PublisherCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/Publisher"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"PublisherPrefixHistory":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a PublisherPrefix","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"status":{"type":"string","description":"Status of the product","enum":["ACTIVE","CLOSED"]},"publisher":{"$ref":"#/components/schemas/Publisher"},"agency":{"type":"string","description":"Registration agency","enum":["ISBN","ISMN"]},"formattedPublisherPrefix":{"type":"string","description":"Formatted publisher prefix (international-agency-publisher)","example":"978-80-7391"}},"description":"Publisher Prefix History DTO"},"PublisherPrefixHistoryCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/PublisherPrefixHistory"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"GenericProductNumber":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a ProductNumber","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"fullFormattedValue":{"type":"string","description":"Full formatted value with agency prefix (e.g., ISBN 978-80-7482-000-1)"}},"description":"Generic Product Number DTO - product numbers assigned from SPECIAL publisher's generic prefix"},"GenericProductNumberCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/GenericProductNumber"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"PublisherSearch":{"type":"object","properties":{"id":{"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","type":"string","description":"The UUID of a Publisher","readOnly":true,"example":"46669e09-8b45-4ede-afbd-ca73bb89cdb3"},"name":{"type":"string"},"nameSuffix":{"type":"string","description":"Name suffix (doplněk k názvu). Used to distinguish namesake publishers in dropdowns."},"sourceId":{"type":"string"},"qualifier":{"type":"string"},"status":{"type":"string","description":"Status of a publisher","enum":["ACTIVE","CLOSING","CLOSED"]},"activePrefix":{"type":"string","description":"Comma-separated list of currently active publisher prefixes (formatted with hyphens, sorted lexicographically, e.g. \"978-80-253, 978-80-7391\")"},"municipality":{"type":"string","description":"Municipality from publisher main address, synced from mod-br-publishers. Used to distinguish namesake publishers in dropdowns."}},"description":"Publisher search DTO"},"PublisherSearchCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/PublisherSearch"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"SourceIdCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"type":"string","description":"List of items in the collection","format":"uuid"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"AgencyPrefixCollectionResponse":{"type":"object","properties":{"items":{"type":"array","description":"List of items in the collection","items":{"$ref":"#/components/schemas/AgencyPrefix"}},"totalRecords":{"type":"integer","description":"Total number of records","format":"int32"}}},"ValidMagnitudeRangeResponse":{"type":"object","properties":{"minMagnitude":{"type":"integer","description":"Minimum allowed magnitude","format":"int32","example":1},"maxMagnitude":{"type":"integer","description":"Maximum allowed magnitude","format":"int32","example":5}},"description":"Valid Magnitude Range Response"},"SolrCoreStats":{"type":"object","properties":{"name":{"type":"string"},"key":{"type":"string"},"docCount":{"type":"integer","format":"int64"},"sizeInBytes":{"type":"integer","format":"int64"},"numDocs":{"type":"integer","format":"int64"},"segmentCount":{"type":"integer","format":"int32"},"lastModified":{"type":"string","format":"date-time"},"reindexInProgress":{"type":"boolean"},"unreachable":{"type":"boolean"},"error":{"type":"string"},"schemaUpToDate":{"type":"boolean"},"missingFields":{"type":"array","items":{"type":"string"}},"mismatchedFields":{"type":"array","items":{"type":"string"}},"reindexNeeded":{"type":"boolean"},"lastReindexStartedAt":{"type":"string","format":"date-time"},"lastReindexFinishedAt":{"type":"string","format":"date-time"},"lastReindexIndexed":{"type":"integer","format":"int64"},"lastReindexFailed":{"type":"integer","format":"int64"},"lastReindexError":{"type":"string"}}},"SolrStatsResponse":{"type":"object","properties":{"cores":{"type":"array","items":{"$ref":"#/components/schemas/SolrCoreStats"}}}},"EnvironmentVariableDto":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}},"EnvironmentVariableDtoCollection":{"type":"object","properties":{"environmentVariables":{"type":"array","items":{"$ref":"#/components/schemas/EnvironmentVariableDto"}}}}}}}