@ndla/types-taxonomy 1.0.43 → 1.0.44

package/openapi.json

@@ -1 +1 @@
-{"openapi":"3.1.0","info":{"contact":{"email":"hjelp+api@ndla.no","name":"NDLA","url":"https://ndla.no"},"description":"Rest service and graph database for organizing content.\n\nWhen you remove an entity, its associations are also deleted. E.g., if you remove a subject, its associations to any topics are removed. The topics themselves are not affected.","license":{"name":"GPL 3.0","url":"https://www.gnu.org/licenses/gpl-3.0.en.html"},"termsOfService":"https://om.ndla.no/tos","title":"NDLA Taxonomy API","version":"v1"},"servers":[{"url":"http://localhost:5000"}],"paths":{"/v1/admin/buildAverageTree":{"post":{"operationId":"buildAverageTree","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates average tree for all nodes. Requires taxonomy:admin access.","tags":["admin"]}},"/v1/admin/buildAverageTree/{id}":{"post":{"operationId":"buildAverageTree_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates average tree for the provided node. Requires taxonomy:admin access.","tags":["admin"]}},"/v1/admin/buildContexts":{"get":{"operationId":"buildAllContexts","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"202":{"description":"Accepted"}},"security":[{"oauth":[]}],"summary":"Updates contexts for all roots. Requires taxonomy:admin access.","tags":["admin"]}},"/v1/contexts":{"get":{"operationId":"getAllContexts","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Context"}}}},"description":"OK"}},"summary":"Gets id of all nodes registered as context","tags":["contexts"]},"post":{"description":"All subjects are already contexts and may not be added again. The node to register as context must exist already.","operationId":"createContext","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextPOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Registers a new node as context","tags":["contexts"]}},"/v1/contexts/":{"get":{"operationId":"getAllContexts_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Context"}}}},"description":"OK"}},"summary":"Gets id of all nodes registered as context","tags":["contexts"]},"post":{"description":"All subjects are already contexts and may not be added again. The node to register as context must exist already.","operationId":"createContext_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextPOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Registers a new node as context","tags":["contexts"]}},"/v1/contexts/{id}":{"delete":{"description":"Does not remove the underlying node, only marks it as not being a context","operationId":"deleteContext","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes context registration from node","tags":["contexts"]}},"/v1/node-connections":{"get":{"operationId":"getAllNodeConnections","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeConnection"}}}},"description":"OK"}},"summary":"Gets all connections between node and children","tags":["node-connections"]},"post":{"operationId":"createNodeConnection","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeConnectionPOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a node to a parent","tags":["node-connections"]}},"/v1/node-connections/":{"get":{"operationId":"getAllNodeConnections_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeConnection"}}}},"description":"OK"}},"summary":"Gets all connections between node and children","tags":["node-connections"]},"post":{"operationId":"createNodeConnection_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeConnectionPOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a node to a parent","tags":["node-connections"]}},"/v1/node-connections/page":{"get":{"operationId":"getNodeConnectionsPage","parameters":[{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all connections between node and children paginated","tags":["node-connections"]}},"/v1/node-connections/{id}":{"delete":{"operationId":"deleteEntity_7","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a connection between a node and a child","tags":["node-connections"]},"get":{"operationId":"getNodeConnection","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NodeConnection"}}},"description":"OK"}},"summary":"Gets a single connection between a node and a child","tags":["node-connections"]},"put":{"description":"Use to update which node is primary to a child or to alter sorting order","operationId":"updateNodeConnection","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeConnectionPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a connection between a node and a child","tags":["node-connections"]}},"/v1/node-connections/{id}/metadata":{"get":{"operationId":"getMetadata_5","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["node-connections"]},"put":{"operationId":"putMetadata_5","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["node-connections"]}},"/v1/node-resources":{"get":{"operationId":"getAllNodeResources","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeResource"}}}},"description":"OK"}},"summary":"Gets all connections between node and resources","tags":["node-resources"]},"post":{"operationId":"createNodeResource","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeResourcePOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a resource to a node","tags":["node-resources"]}},"/v1/node-resources/":{"get":{"operationId":"getAllNodeResources_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeResource"}}}},"description":"OK"}},"summary":"Gets all connections between node and resources","tags":["node-resources"]},"post":{"operationId":"createNodeResource_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeResourcePOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a resource to a node","tags":["node-resources"]}},"/v1/node-resources/page":{"get":{"operationId":"getNodeResourcesPage","parameters":[{"description":"The page to fetch","in":"query","name":"page","required":true,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":true,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all connections between node and resources paginated","tags":["node-resources"]}},"/v1/node-resources/{id}":{"delete":{"operationId":"deleteEntity_6","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a resource from a node","tags":["node-resources"]},"get":{"operationId":"getNodeResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NodeResource"}}},"description":"OK"}},"summary":"Gets a specific connection between a node and a resource","tags":["node-resources"]},"put":{"description":"Use to update which node is primary to the resource or to change sorting order.","operationId":"updateNodeResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeResourcePUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a connection between a node and a resource","tags":["node-resources"]}},"/v1/node-resources/{id}/metadata":{"get":{"operationId":"getMetadata_4","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["node-resources"]},"put":{"operationId":"putMetadata_4","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["node-resources"]}},"/v1/nodes":{"get":{"operationId":"getAllNodes","parameters":[{"description":"Filter by nodeType, could be a comma separated list, defaults to Topics and Subjects (Resources are quite slow). :^)","in":"query","name":"nodeType","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeType"}}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Ids to filter by","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string","format":"uri"}}},{"deprecated":true,"description":"Only root level contexts","in":"query","name":"isRoot","required":false,"schema":{"type":"boolean"}},{"description":"Only contexts","in":"query","name":"isContext","required":false,"schema":{"type":"boolean"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter by context id. Beware: handled separately from other parameters!","in":"query","name":"contextId","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Id to root id in context.","in":"query","name":"rootId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Id to parent id in context.","in":"query","name":"parentId","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all nodes","tags":["nodes"]},"post":{"operationId":"createNode","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodePostPut"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Creates a new node","tags":["nodes"]}},"/v1/nodes/":{"get":{"operationId":"getAllNodes_1","parameters":[{"description":"Filter by nodeType, could be a comma separated list, defaults to Topics and Subjects (Resources are quite slow). :^)","in":"query","name":"nodeType","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeType"}}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Ids to filter by","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string","format":"uri"}}},{"deprecated":true,"description":"Only root level contexts","in":"query","name":"isRoot","required":false,"schema":{"type":"boolean"}},{"description":"Only contexts","in":"query","name":"isContext","required":false,"schema":{"type":"boolean"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter by context id. Beware: handled separately from other parameters!","in":"query","name":"contextId","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Id to root id in context.","in":"query","name":"rootId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Id to parent id in context.","in":"query","name":"parentId","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all nodes","tags":["nodes"]},"post":{"operationId":"createNode_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodePostPut"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Creates a new node","tags":["nodes"]}},"/v1/nodes/page":{"get":{"operationId":"getNodePage","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"description":"Filter by nodeType","in":"query","name":"nodeType","required":false,"schema":{"$ref":"#/components/schemas/NodeType"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean","default":true}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all nodes paginated","tags":["nodes"]}},"/v1/nodes/search":{"get":{"operationId":"searchNodes","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"How many results to return per page","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"description":"Which page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Query to search names","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Ids to fetch for query","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"ContentURIs to fetch for query","in":"query","name":"contentUris","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Filter by nodeType","in":"query","name":"nodeType","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeType"}}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Id to root id in context to select. Does not affect search results","in":"query","name":"rootId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Id to parent id in context to select. Does not affect search results","in":"query","name":"parentId","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Search all nodes","tags":["nodes"]},"post":{"operationId":"searchNodes_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeSearchBody"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Search all nodes","tags":["nodes"]}},"/v1/nodes/{id}":{"delete":{"operationId":"deleteEntity_5","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a single node by id","tags":["nodes"]},"get":{"operationId":"getNode","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"Id to root id in context.","in":"query","name":"rootId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Id to parent id in context.","in":"query","name":"parentId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean","default":true}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Node"}}},"description":"OK"}},"summary":"Gets a single node","tags":["nodes"]},"put":{"operationId":"updateNode","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodePostPut"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a single node","tags":["nodes"]}},"/v1/nodes/{id}/clone":{"post":{"operationId":"cloneResource_1","parameters":[{"description":"Id of node to clone","example":"urn:resource:1","in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodePostPut"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Clones a node, presumably a resource, including resource-types and translations","tags":["nodes"]}},"/v1/nodes/{id}/connections":{"get":{"operationId":"getAllConnections","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Connection"}}}},"description":"OK"}},"summary":"Gets all parents and children this node is connected to","tags":["nodes"]}},"/v1/nodes/{id}/full":{"get":{"deprecated":true,"operationId":"getNodeFull","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NodeWithParents"}}},"description":"OK"}},"summary":"Gets node including information about all parents, and resourceTypes for this resource. Can be replaced with regular get-endpoint and traversing contexts","tags":["nodes"]}},"/v1/nodes/{id}/makeResourcesPrimary":{"put":{"operationId":"makeResourcesPrimary_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"If true, children are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"boolean"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Makes all connected resources primary","tags":["nodes"]}},"/v1/nodes/{id}/metadata":{"get":{"operationId":"getMetadata_3","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["nodes"]},"put":{"operationId":"putMetadata_3","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["nodes"]}},"/v1/nodes/{id}/nodes":{"get":{"operationId":"getChildren","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"Filter by nodeType, could be a comma separated list, defaults to Topics and Subjects (Resources are quite slow). :^)","in":"query","name":"nodeType","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeType"}}},{"description":"Only connections of given type are returned","in":"query","name":"connectionTypes","required":false,"schema":{"type":"array","default":["BRANCH"],"items":{"$ref":"#/components/schemas/NodeConnectionType"}}},{"description":"If true, children are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean","default":true}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all children for this node","tags":["nodes"]}},"/v1/nodes/{id}/publish":{"put":{"deprecated":true,"operationId":"publishNode","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"Version id to publish from. Can be omitted to publish from default.","example":"urn:version:1","in":"query","name":"sourceId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Version id to publish to.","example":"urn:version:2","in":"query","name":"targetId","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"202":{"description":"Accepted"}},"security":[{"oauth":[]}],"summary":"Publishes a node hierarchy to a version","tags":["nodes"]}},"/v1/nodes/{id}/resources":{"get":{"operationId":"getResources","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean","default":true}},{"description":"If true, resources from children are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"description":"Select by resource type id(s). If not specified, resources of all types will be returned. Multiple ids may be separated with comma or the parameter may be repeated for each id.","in":"query","name":"type","required":false,"schema":{"type":"array","items":{"type":"string","format":"uri"}}},{"description":"Select by relevance. If not specified, all resources will be returned.","in":"query","name":"relevance","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all resources for the given node","tags":["nodes"]}},"/v1/nodes/{id}/translations":{"get":{"operationId":"getAllNodeTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all translations for a single node","tags":["node-translations"]}},"/v1/nodes/{id}/translations/":{"get":{"operationId":"getAllNodeTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all translations for a single node","tags":["node-translations"]}},"/v1/nodes/{id}/translations/{language}":{"delete":{"operationId":"deleteNodeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a translation","tags":["node-translations"]},"get":{"operationId":"getNodeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single node","tags":["node-translations"]},"put":{"operationId":"createUpdateNodeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Creates or updates a translation of a node","tags":["node-translations"]}},"/v1/queries/contextId":{"get":{"operationId":"contextByContextId","parameters":[{"in":"query","name":"contextId","required":false,"schema":{"type":"string"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaxonomyContext"}}}},"description":"OK"}},"summary":"Gets a list of contexts matching given contextId, empty list if no matches are found.","tags":["queries"]}},"/v1/queries/path":{"get":{"operationId":"queryPath","parameters":[{"in":"query","name":"path","required":false,"schema":{"type":"string"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaxonomyContext"}}}},"description":"OK"}},"summary":"Gets a list of contexts matching given pretty url with contextId, empty list if no matches are found.","tags":["queries"]}},"/v1/queries/resources":{"get":{"deprecated":true,"operationId":"queryResources","parameters":[{"in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Fitler by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter by visible","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets a list of resources matching given contentURI, empty list of no matches are found. DEPRECATED: Use /v1/resources?contentURI= instead","tags":["queries"]}},"/v1/queries/topics":{"get":{"deprecated":true,"operationId":"queryTopics","parameters":[{"in":"query","name":"contentURI","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Fitler by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter by visible","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets a list of topics matching given contentURI, empty list of no matches are found. DEPRECATED: Use /v1/topics?contentURI= instead","tags":["queries"]}},"/v1/queries/{contentURI}":{"get":{"operationId":"contextByContentURI","parameters":[{"in":"path","name":"contentURI","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Whether to filter out contexts if a parent (or the node itself) is non-visible","in":"query","name":"filterVisibles","required":false,"schema":{"type":"boolean","default":true}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaxonomyContext"}}}},"description":"OK"}},"summary":"Gets a list of contexts matching given contentURI, empty list if no matches are found.","tags":["queries"]}},"/v1/relevances":{"get":{"operationId":"getAllRelevances","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Relevance"}}}},"description":"OK"}},"summary":"Gets all relevances","tags":["relevances"]}},"/v1/relevances/":{"get":{"operationId":"getAllRelevances_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Relevance"}}}},"description":"OK"}},"summary":"Gets all relevances","tags":["relevances"]}},"/v1/relevances/{id}":{"get":{"description":"Default language will be returned if desired language not found or if parameter is omitted.","operationId":"getRelevance","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Relevance"}}},"description":"OK"}},"summary":"Gets a single relevance","tags":["relevances"]}},"/v1/relevances/{id}/translations":{"get":{"operationId":"getAllRelevanceTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single relevance","tags":["relevance-translations"]}},"/v1/relevances/{id}/translations/":{"get":{"operationId":"getAllRelevanceTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single relevance","tags":["relevance-translations"]}},"/v1/relevances/{id}/translations/{language}":{"get":{"operationId":"getRelevanceTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single relevance","tags":["relevance-translations"]}},"/v1/resource-resourcetypes":{"get":{"operationId":"getAllResourceResourceTypes","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceResourceType"}}}},"description":"OK"}},"summary":"Gets all connections between resources and resource types","tags":["resource-resource-types"]},"post":{"operationId":"createResourceResourceType","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceResourceTypePOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a resource type to a resource","tags":["resource-resource-types"]}},"/v1/resource-resourcetypes/":{"get":{"operationId":"getAllResourceResourceTypes_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceResourceType"}}}},"description":"OK"}},"summary":"Gets all connections between resources and resource types","tags":["resource-resource-types"]},"post":{"operationId":"createResourceResourceType_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceResourceTypePOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a resource type to a resource","tags":["resource-resource-types"]}},"/v1/resource-resourcetypes/{id}":{"delete":{"operationId":"deleteResourceResourceType","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a resource type from a resource","tags":["resource-resource-types"]},"get":{"operationId":"getResourceResourceType","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResourceResourceType"}}},"description":"OK"}},"summary":"Gets a single connection between resource and resource type","tags":["resource-resource-types"]}},"/v1/resource-types":{"get":{"operationId":"getAllResourceTypes","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceType"}}}},"description":"OK"}},"summary":"Gets a list of all resource types","tags":["resource-types"]},"post":{"operationId":"createResourceType","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceTypePUT"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a new resource type","tags":["resource-types"]}},"/v1/resource-types/":{"get":{"operationId":"getAllResourceTypes_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceType"}}}},"description":"OK"}},"summary":"Gets a list of all resource types","tags":["resource-types"]},"post":{"operationId":"createResourceType_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceTypePUT"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a new resource type","tags":["resource-types"]}},"/v1/resource-types/{id}":{"delete":{"operationId":"deleteEntity_4","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a single entity by id","tags":["resource-types"]},"get":{"operationId":"getResourceType","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResourceType"}}},"description":"OK"}},"summary":"Gets a single resource type","tags":["resource-types"]},"put":{"operationId":"updateResourceType","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceTypePUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a resource type. Use to update which resource type is parent. You can also update the id, take care!","tags":["resource-types"]}},"/v1/resource-types/{id}/subtypes":{"get":{"operationId":"getResourceTypeSubtypes","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"description":"If true, sub resource types are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceType"}}}},"description":"OK"}},"summary":"Gets subtypes of one resource type","tags":["resource-types"]}},"/v1/resource-types/{id}/translations":{"get":{"operationId":"getAllResourceTypeTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single resource type","tags":["resource-type-translations"]}},"/v1/resource-types/{id}/translations/":{"get":{"operationId":"getAllResourceTypeTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single resource type","tags":["resource-type-translations"]}},"/v1/resource-types/{id}/translations/{language}":{"delete":{"operationId":"deleteResourceTypeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a translation","tags":["resource-type-translations"]},"get":{"operationId":"getResourceTypeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single resource type","tags":["resource-type-translations"]},"put":{"operationId":"createUpdateResourceTypeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Creates or updates a translation of a resource type","tags":["resource-type-translations"]}},"/v1/resources":{"get":{"deprecated":true,"operationId":"getAllResources","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Lists all resources","tags":["resources"]},"post":{"deprecated":true,"operationId":"createResource","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourcePUT"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a new resource","tags":["resources"]}},"/v1/resources/":{"get":{"deprecated":true,"operationId":"getAllResources_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Lists all resources","tags":["resources"]},"post":{"deprecated":true,"operationId":"createResource_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourcePUT"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a new resource","tags":["resources"]}},"/v1/resources/page":{"get":{"deprecated":true,"operationId":"getResourcePage","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all resources paginated","tags":["resources"]}},"/v1/resources/search":{"get":{"deprecated":true,"operationId":"searchResources","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"How many results to return per page","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"description":"Which page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Query to search names","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Ids to fetch for query","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"ContentURIs to fetch for query","in":"query","name":"contentUris","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Search all resources","tags":["resources"]}},"/v1/resources/{id}":{"delete":{"deprecated":true,"operationId":"deleteEntity_3","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a single entity by id","tags":["resources"]},"get":{"deprecated":true,"operationId":"getResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Node"}}},"description":"OK"}},"summary":"Gets a single resource","tags":["resources"]},"put":{"deprecated":true,"operationId":"updateResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourcePOST"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a resource","tags":["resources"]}},"/v1/resources/{id}/clone":{"post":{"deprecated":true,"operationId":"cloneResource","parameters":[{"description":"Id of resource to clone","example":"urn:resource:1","in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourcePOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Clones a resource, including resource-types and translations","tags":["resources"]}},"/v1/resources/{id}/full":{"get":{"deprecated":true,"operationId":"getResourceFull","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NodeWithParents"}}},"description":"OK"}},"summary":"Gets all parent topics, all filters and resourceTypes for this resource","tags":["resources"]}},"/v1/resources/{id}/metadata":{"get":{"operationId":"getMetadata_2","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["resources"]},"put":{"operationId":"putMetadata_2","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["resources"]}},"/v1/resources/{id}/resource-types":{"get":{"deprecated":true,"operationId":"getResourceTypes","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceTypeWithConnection"}}}},"description":"OK"}},"summary":"Gets all resource types associated with this resource","tags":["resources"]}},"/v1/resources/{id}/translations":{"get":{"deprecated":true,"operationId":"getAllResourceTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single resource","tags":["resource-translations"]}},"/v1/resources/{id}/translations/":{"get":{"deprecated":true,"operationId":"getAllResourceTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single resource","tags":["resource-translations"]}},"/v1/resources/{id}/translations/{language}":{"delete":{"deprecated":true,"operationId":"deleteResourceTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a translation","tags":["resource-translations"]},"get":{"deprecated":true,"operationId":"getResourceTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single resource","tags":["resource-translations"]},"put":{"deprecated":true,"operationId":"createUpdateResourceTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Creates or updates a translation of a resource","tags":["resource-translations"]}},"/v1/subject-topics":{"get":{"deprecated":true,"operationId":"getAllSubjectTopics","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SubjectTopic"}}}},"description":"OK"}},"summary":"Gets all connections between subjects and topics","tags":["subject-topics"]},"post":{"deprecated":true,"operationId":"createSubjectTopic","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectTopicPOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a new topic to a subject","tags":["subject-topics"]}},"/v1/subject-topics/":{"get":{"deprecated":true,"operationId":"getAllSubjectTopics_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SubjectTopic"}}}},"description":"OK"}},"summary":"Gets all connections between subjects and topics","tags":["subject-topics"]},"post":{"deprecated":true,"operationId":"createSubjectTopic_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectTopicPOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a new topic to a subject","tags":["subject-topics"]}},"/v1/subject-topics/page":{"get":{"deprecated":true,"operationId":"getSubjectTopicPage","parameters":[{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all connections between subjects and topics paginated","tags":["subject-topics"]}},"/v1/subject-topics/{id}":{"delete":{"deprecated":true,"operationId":"deleteSubjectTopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a topic from a subject","tags":["subject-topics"]},"get":{"deprecated":true,"operationId":"getSubjectTopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SubjectTopic"}}},"description":"OK"}},"summary":"Get a specific connection between a subject and a topic","tags":["subject-topics"]},"put":{"deprecated":true,"description":"Use to update which subject is primary to a topic or to change sorting order.","operationId":"updateSubjectTopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectTopicPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a connection between subject and topic","tags":["subject-topics"]}},"/v1/subjects":{"get":{"deprecated":true,"operationId":"getAllSubjects","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all subjects","tags":["subjects"]},"post":{"deprecated":true,"operationId":"createSubject","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectPUT"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Creates a new subject","tags":["subjects"]}},"/v1/subjects/":{"get":{"deprecated":true,"operationId":"getAllSubjects_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all subjects","tags":["subjects"]},"post":{"deprecated":true,"operationId":"createSubject_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectPUT"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Creates a new subject","tags":["subjects"]}},"/v1/subjects/page":{"get":{"deprecated":true,"operationId":"getSubjectPage","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all nodes paginated","tags":["subjects"]}},"/v1/subjects/search":{"get":{"deprecated":true,"operationId":"searchSubjects","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"How many results to return per page","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"description":"Which page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Query to search names","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Ids to fetch for query","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"ContentURIs to fetch for query","in":"query","name":"contentUris","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Search all subjects","tags":["subjects"]}},"/v1/subjects/{id}":{"delete":{"deprecated":true,"operationId":"deleteEntity_2","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a single entity by id","tags":["subjects"]},"get":{"deprecated":true,"description":"Default language will be returned if desired language not found or if parameter is omitted.","operationId":"getSubject","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Node"}}},"description":"OK"}},"summary":"Gets a single subject","tags":["subjects"]},"put":{"deprecated":true,"operationId":"updateSubject","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectPOST"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a subject","tags":["subjects"]}},"/v1/subjects/{id}/metadata":{"get":{"operationId":"getMetadata_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["subjects"]},"put":{"operationId":"putMetadata_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["subjects"]}},"/v1/subjects/{id}/topics":{"get":{"deprecated":true,"description":"This resource is read-only. To update the relationship between nodes, use the resource /subject-topics.","operationId":"getSubjectChildren","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"If true, subtopics are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"description":"Select by relevance. If not specified, all nodes will be returned.","in":"query","name":"relevance","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all children associated with a subject","tags":["subjects"]}},"/v1/subjects/{id}/translations":{"get":{"deprecated":true,"operationId":"getAllSubjectTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single subject","tags":["subject-translations"]}},"/v1/subjects/{id}/translations/":{"get":{"deprecated":true,"operationId":"getAllSubjectTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single subject","tags":["subject-translations"]}},"/v1/subjects/{id}/translations/{language}":{"delete":{"deprecated":true,"operationId":"deleteSubjectTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a translation","tags":["subject-translations"]},"get":{"deprecated":true,"operationId":"getSubjectTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single subject","tags":["subject-translations"]},"put":{"deprecated":true,"operationId":"createUpdateSubjectTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Creates or updates a translation of a subject","tags":["subject-translations"]}},"/v1/subjects/{subjectId}/resources":{"get":{"deprecated":true,"operationId":"getSubjectResources","parameters":[{"in":"path","name":"subjectId","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by resource type id(s). If not specified, resources of all types will be returned.Multiple ids may be separated with comma or the parameter may be repeated for each id.","in":"query","name":"type","required":false,"schema":{"type":"array","items":{"type":"string","format":"uri"}}},{"description":"Select by relevance. If not specified, all resources will be returned.","in":"query","name":"relevance","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all resources for a subject. Searches recursively in all children of this node.The ordering of resources will be based on the rank of resources relative to the node they belong to.","tags":["subjects"]}},"/v1/topic-resources":{"get":{"deprecated":true,"operationId":"getAllTopicResources","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TopicResource"}}}},"description":"OK"}},"summary":"Gets all connections between topics and resources","tags":["topic-resources"]},"post":{"deprecated":true,"operationId":"createTopicResource","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicResourcePOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a resource to a topic","tags":["topic-resources"]}},"/v1/topic-resources/":{"get":{"deprecated":true,"operationId":"getAllTopicResources_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TopicResource"}}}},"description":"OK"}},"summary":"Gets all connections between topics and resources","tags":["topic-resources"]},"post":{"deprecated":true,"operationId":"createTopicResource_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicResourcePOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a resource to a topic","tags":["topic-resources"]}},"/v1/topic-resources/page":{"get":{"deprecated":true,"operationId":"getTopicResourcePage","parameters":[{"description":"The page to fetch","in":"query","name":"page","required":true,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":true,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all connections between topic and resources paginated","tags":["topic-resources"]}},"/v1/topic-resources/{id}":{"delete":{"deprecated":true,"operationId":"deleteTopicResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a resource from a topic","tags":["topic-resources"]},"get":{"deprecated":true,"operationId":"getTopicResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/TopicResource"}}},"description":"OK"}},"summary":"Gets a specific connection between a topic and a resource","tags":["topic-resources"]},"put":{"deprecated":true,"description":"Use to update which topic is primary to the resource or to change sorting order.","operationId":"updateTopicResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicResourcePUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a connection between a topic and a resource","tags":["topic-resources"]}},"/v1/topic-subtopics":{"get":{"deprecated":true,"operationId":"getAllTopicSubtopics","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TopicSubtopic"}}}},"description":"OK"}},"summary":"Gets all connections between topics and subtopics","tags":["topic-subtopics"]},"post":{"deprecated":true,"operationId":"createTopicSubtopic","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicSubtopicPOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a subtopic to a topic","tags":["topic-subtopics"]}},"/v1/topic-subtopics/":{"get":{"deprecated":true,"operationId":"getAllTopicSubtopics_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TopicSubtopic"}}}},"description":"OK"}},"summary":"Gets all connections between topics and subtopics","tags":["topic-subtopics"]},"post":{"deprecated":true,"operationId":"createTopicSubtopic_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicSubtopicPOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Adds a subtopic to a topic","tags":["topic-subtopics"]}},"/v1/topic-subtopics/page":{"get":{"deprecated":true,"operationId":"getTopicSubtopicPage","parameters":[{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all connections between topics and subtopics paginated","tags":["topic-subtopics"]}},"/v1/topic-subtopics/{id}":{"delete":{"deprecated":true,"operationId":"deleteTopicSubtopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a connection between a topic and a subtopic","tags":["topic-subtopics"]},"get":{"deprecated":true,"operationId":"getTopicSubtopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/TopicSubtopic"}}},"description":"OK"}},"summary":"Gets a single connection between a topic and a subtopic","tags":["topic-subtopics"]},"put":{"deprecated":true,"description":"Use to update which topic is primary to a subtopic or to alter sorting order","operationId":"updateTopicSubtopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicSubtopicPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a connection between a topic and a subtopic","tags":["topic-subtopics"]}},"/v1/topics":{"get":{"deprecated":true,"operationId":"getAllTopics","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all topics","tags":["topics"]},"post":{"deprecated":true,"operationId":"createTopic","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicPOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Creates a new topic","tags":["topics"]}},"/v1/topics/":{"get":{"deprecated":true,"operationId":"getAllTopics_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all topics","tags":["topics"]},"post":{"deprecated":true,"operationId":"createTopic_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicPOST"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Creates a new topic","tags":["topics"]}},"/v1/topics/page":{"get":{"deprecated":true,"operationId":"getTopicsPage","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all topics paginated","tags":["topics"]}},"/v1/topics/search":{"get":{"deprecated":true,"operationId":"searchTopics","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"How many results to return per page","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"description":"Which page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Query to search names","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Ids to fetch for query","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"ContentURIs to fetch for query","in":"query","name":"contentUris","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Search all topics","tags":["topics"]}},"/v1/topics/{id}":{"delete":{"deprecated":true,"description":"Deletes a single entity by id","operationId":"deleteEntity_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"tags":["topics"]},"get":{"deprecated":true,"operationId":"getTopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Node"}}},"description":"OK"}},"summary":"Gets a single topic","tags":["topics"]},"put":{"deprecated":true,"operationId":"updateTopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicPostPut"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a single topic","tags":["topics"]}},"/v1/topics/{id}/connections":{"get":{"deprecated":true,"operationId":"getAllTopicConnections","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Connection"}}}},"description":"OK"}},"summary":"Gets all subjects and subtopics this topic is connected to","tags":["topics"]}},"/v1/topics/{id}/makeResourcesPrimary":{"put":{"deprecated":true,"operationId":"makeResourcesPrimary","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"If true, children are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"boolean"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Makes all connected resources primary","tags":["topics"]}},"/v1/topics/{id}/metadata":{"get":{"operationId":"getMetadata","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["topics"]},"put":{"operationId":"putMetadata","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["topics"]}},"/v1/topics/{id}/resources":{"get":{"deprecated":true,"operationId":"getTopicResources","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"If true, resources from subtopics are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"description":"Select by resource type id(s). If not specified, resources of all types will be returned.Multiple ids may be separated with comma or the parameter may be repeated for each id.","in":"query","name":"type","required":false,"schema":{"type":"array","items":{"type":"string","format":"uri"}}},{"description":"Select by relevance. If not specified, all resources will be returned.","in":"query","name":"relevance","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all resources for the given topic","tags":["topics"]}},"/v1/topics/{id}/topics":{"get":{"deprecated":true,"operationId":"getTopicSubTopics","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"Select filters by subject id if filter list is empty. Used as alternative to specify filters.","in":"query","name":"subject","required":false,"schema":{"type":"string","format":"uri","default":""}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all subtopics for this topic","tags":["topics"]}},"/v1/topics/{id}/translations":{"get":{"deprecated":true,"operationId":"getAllTopicTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single topic","tags":["topic-translations"]}},"/v1/topics/{id}/translations/":{"get":{"deprecated":true,"operationId":"getAllTopicTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single topic","tags":["topic-translations"]}},"/v1/topics/{id}/translations/{language}":{"delete":{"deprecated":true,"operationId":"deleteTopicTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a translation","tags":["topic-translations"]},"get":{"deprecated":true,"operationId":"getTopicTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single topic","tags":["topic-translations"]},"put":{"deprecated":true,"operationId":"createUpdateTopicTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Creates or updates a translation of a topic","tags":["topic-translations"]}},"/v1/url/mapping":{"get":{"operationId":"getTaxonomyPathForUrl","parameters":[{"description":"url in old rig except 'https://'","example":"ndla.no/nb/node/142542?fag=52253","in":"query","name":"url","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResolvedOldUrl"}}},"description":"OK"}},"summary":"Returns path for an url or HTTP 404","tags":["url-resolver"]},"put":{"operationId":"putTaxonomyNodeAndSubjectForOldUrl","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlMapping"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Inserts or updates a mapping from url to nodeId and optionally subjectId","tags":["url-resolver"]}},"/v1/url/resolve":{"get":{"operationId":"resolve","parameters":[{"in":"query","name":"path","required":true,"schema":{"type":"string"}},{"in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResolvedUrl"}}},"description":"OK"}},"tags":["url-resolver"]}},"/v1/versions":{"get":{"operationId":"getAllVersions","parameters":[{"description":"Version type","example":"PUBLISHED","in":"query","name":"type","required":false,"schema":{"$ref":"#/components/schemas/VersionType","default":null}},{"description":"Version hash","example":"ndla","in":"query","name":"hash","required":false,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Version"}}}},"description":"OK"}},"summary":"Gets all versions","tags":["versions"]},"post":{"operationId":"createVersion","parameters":[{"description":"Base new version on version with this id","in":"query","name":"sourceId","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionPostPut"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Creates a new version","tags":["versions"]}},"/v1/versions/":{"get":{"operationId":"getAllVersions_1","parameters":[{"description":"Version type","example":"PUBLISHED","in":"query","name":"type","required":false,"schema":{"$ref":"#/components/schemas/VersionType","default":null}},{"description":"Version hash","example":"ndla","in":"query","name":"hash","required":false,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Version"}}}},"description":"OK"}},"summary":"Gets all versions","tags":["versions"]},"post":{"operationId":"createVersion_1","parameters":[{"description":"Base new version on version with this id","in":"query","name":"sourceId","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionPostPut"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Creates a new version","tags":["versions"]}},"/v1/versions/{id}":{"delete":{"operationId":"deleteEntity","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a version by publicId","tags":["versions"]},"get":{"operationId":"getVersion","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Version"}}},"description":"OK"}},"summary":"Gets a single version","tags":["versions"]},"put":{"operationId":"updateVersion","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionPostPut"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a version","tags":["versions"]}},"/v1/versions/{id}/publish":{"put":{"operationId":"publishVersion","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Publishes a version","tags":["versions"]}}},"components":{"headers":{"versionHash":{"description":"versionHash","schema":{"type":"string"}}},"parameters":{"versionHash":{"in":"header","name":"versionHash","schema":{"type":"string"}}},"schemas":{"Connection":{"type":"object","properties":{"connectionId":{"type":"string","format":"uri","description":"The id of the subject-topic or topic-subtopic connection","example":"urn:subject-topic:1"},"isPrimary":{"type":"boolean","deprecated":true,"description":"True if owned by this topic, false if it has its primary connection elsewhere","example":true},"paths":{"type":"array","deprecated":true,"description":"The path part of the url for the subject or subtopic connected to this topic","example":"/subject:1/topic:1","items":{"type":"string"},"uniqueItems":true},"targetId":{"type":"string","format":"uri","description":"The id of the connected subject or topic","example":"urn:subject:1"},"type":{"type":"string","description":"The type of connection (parent, child, referrer or target"}},"required":["connectionId","isPrimary","paths","targetId","type"]},"Context":{"type":"object","properties":{"id":{"type":"string","format":"uri"},"name":{"type":"string"},"path":{"type":"string"}},"required":["id","name","path"]},"ContextPOST":{"type":"object","description":"object containing public id of the node to be registered as context","properties":{"id":{"type":"string","format":"uri"}},"required":["id"]},"Grade":{"type":"integer","format":"int32","enum":[1,2,3,4,5]},"GradeAverage":{"type":"object","properties":{"averageValue":{"type":"number","format":"double"},"count":{"type":"integer","format":"int32"}},"required":["averageValue","count"]},"Metadata":{"type":"object","properties":{"customFields":{"type":"object","additionalProperties":{"type":"string"}},"grepCodes":{"type":"array","items":{"type":"string"},"uniqueItems":true},"visible":{"type":"boolean"}},"required":["customFields","grepCodes","visible"]},"Node":{"type":"object","properties":{"baseName":{"type":"string","description":"The stored name of the node","example":"Trigonometry"},"breadcrumbs":{"type":"array","description":"List of names in the path","items":{"type":"string"}},"contentUri":{"type":"string","format":"uri","description":"ID of content introducing this node. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"context":{"$ref":"#/components/schemas/TaxonomyContext","description":"The context object selected when fetching node"},"contextId":{"type":"string","description":"An id unique for this context."},"contextids":{"type":"array","description":"A list of all contextids this node has ever had","items":{"type":"string"},"uniqueItems":true},"contexts":{"type":"array","description":"A list of all contexts this node is part of","items":{"$ref":"#/components/schemas/TaxonomyContext"}},"gradeAverage":{"$ref":"#/components/schemas/GradeAverage","description":"A number representing the average grade of all children nodes recursively."},"id":{"type":"string","format":"uri","description":"Node id","example":"urn:topic:234"},"language":{"type":"string","description":"The language code for which name is returned","example":"nb"},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Metadata for entity. Read only."},"name":{"type":"string","description":"The possibly translated name of the node","example":"Trigonometry"},"nodeType":{"$ref":"#/components/schemas/NodeType","description":"The type of node","example":"resource"},"path":{"type":"string","description":"The primary path for this node. Can be empty if no context","example":"/subject:1/topic:1"},"paths":{"type":"array","description":"List of all paths to this node","items":{"type":"string"}},"qualityEvaluation":{"$ref":"#/components/schemas/QualityEvaluationDTO","description":"Quality evaluation of the article"},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceTypes":{"type":"array","description":"Resource type(s)","example":[{"id":"urn:resourcetype:1","name":"lecture"}],"items":{"$ref":"#/components/schemas/ResourceTypeWithConnection"},"uniqueItems":true},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"},"uniqueItems":true},"translations":{"type":"array","description":"All translations of this node","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true},"url":{"type":"string","description":"A pretty url based on name and context. Empty if no context."}},"required":["baseName","breadcrumbs","contextids","contexts","id","language","metadata","name","nodeType","paths","resourceTypes","supportedLanguages","translations"]},"NodeChild":{"type":"object","properties":{"baseName":{"type":"string","description":"The stored name of the node","example":"Trigonometry"},"breadcrumbs":{"type":"array","description":"List of names in the path","items":{"type":"string"}},"connectionId":{"type":"string","format":"uri","description":"The id of the node connection which causes this node to be included in the result set.","example":"urn:node-connection:1"},"contentUri":{"type":"string","format":"uri","description":"ID of content introducing this node. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"context":{"$ref":"#/components/schemas/TaxonomyContext","description":"The context object selected when fetching node"},"contextId":{"type":"string","description":"An id unique for this context."},"contextids":{"type":"array","description":"A list of all contextids this node has ever had","items":{"type":"string"},"uniqueItems":true},"contexts":{"type":"array","description":"A list of all contexts this node is part of","items":{"$ref":"#/components/schemas/TaxonomyContext"}},"gradeAverage":{"$ref":"#/components/schemas/GradeAverage","description":"A number representing the average grade of all children nodes recursively."},"id":{"type":"string","format":"uri","description":"Node id","example":"urn:topic:234"},"isPrimary":{"type":"boolean"},"language":{"type":"string","description":"The language code for which name is returned","example":"nb"},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Metadata for entity. Read only."},"name":{"type":"string","description":"The possibly translated name of the node","example":"Trigonometry"},"nodeType":{"$ref":"#/components/schemas/NodeType","description":"The type of node","example":"resource"},"parentId":{"type":"string","format":"uri","description":"Parent id in the current context, null if none exists"},"path":{"type":"string","description":"The primary path for this node. Can be empty if no context","example":"/subject:1/topic:1"},"paths":{"type":"array","description":"List of all paths to this node","items":{"type":"string"}},"qualityEvaluation":{"$ref":"#/components/schemas/QualityEvaluationDTO","description":"Quality evaluation of the article"},"rank":{"type":"integer","format":"int32","description":"The order in which to sort the node within it's level.","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceTypes":{"type":"array","description":"Resource type(s)","example":[{"id":"urn:resourcetype:1","name":"lecture"}],"items":{"$ref":"#/components/schemas/ResourceTypeWithConnection"},"uniqueItems":true},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"},"uniqueItems":true},"translations":{"type":"array","description":"All translations of this node","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true},"url":{"type":"string","description":"A pretty url based on name and context. Empty if no context."}},"required":["baseName","breadcrumbs","connectionId","contextids","contexts","id","isPrimary","language","metadata","name","nodeType","parentId","paths","rank","resourceTypes","supportedLanguages","translations"]},"NodeConnection":{"type":"object","properties":{"childId":{"type":"string","format":"uri","description":"Child id","example":"urn:topic:234"},"connectionType":{"$ref":"#/components/schemas/NodeConnectionType","description":"Connection type"},"id":{"type":"string","format":"uri","description":"Connection id","example":"urn:topic-has-subtopics:345"},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Metadata for entity. Read only."},"parentId":{"type":"string","format":"uri","description":"Parent id","example":"urn:topic:234"},"primary":{"type":"boolean","description":"Is this connection primary","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which subtopic is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}},"required":["childId","connectionType","id","metadata","parentId","primary","rank"]},"NodeConnectionPOST":{"type":"object","description":"The new connection","properties":{"childId":{"type":"string","format":"uri","description":"Child id","example":"urn:topic:234"},"connectionType":{"$ref":"#/components/schemas/NodeConnectionType","default":"BRANCH","description":"Connection type","example":"BRANCH"},"parentId":{"type":"string","format":"uri","example":"urn:topic:234","title":"Parent id"},"primary":{"type":"boolean","description":"If this connection is primary.","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which to sort the child for the parent","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}},"required":["childId","parentId"]},"NodeConnectionPUT":{"type":"object","description":"The updated connection","properties":{"primary":{"type":"boolean","description":"If this connection is primary.","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which subtopic is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}}},"NodeConnectionType":{"type":"string","enum":["BRANCH","LINK"]},"NodePostPut":{"type":"object","description":"The new node","properties":{"contentUri":{"type":"string","format":"uri","description":"ID of content introducing this node. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"context":{"type":"boolean","description":"The node is the root in a context. Default is false. Only used if present."},"language":{"type":"string","description":"The language used at create time. Used to set default translation.","example":"nb"},"name":{"type":"string","description":"The name of the node. Required on create.","example":"Trigonometry"},"nodeId":{"type":"string","description":"If specified, set the node_id to this value. If omitted, an uuid will be assigned automatically."},"nodeType":{"$ref":"#/components/schemas/NodeType","description":"Type of node.","example":"topic"},"qualityEvaluation":{"type":["object","null"],"$ref":"#/components/schemas/QualityEvaluationDTO","description":"The quality evaluation of the node. Consist of a score from 1 to 5 and a comment. Can be null to remove existing evaluation."},"root":{"type":"boolean","deprecated":true,"description":"The node is a root node. Default is false. Only used if present."},"visible":{"type":"boolean","description":"The node is visible. Default is true."}},"required":["language","nodeType"]},"NodeResource":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Node resource connection id","example":"urn:node-resource:123"},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Metadata for entity. Read only."},"nodeId":{"type":"string","format":"uri","description":"Node id","example":"urn:node:345"},"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the resource is sorted for the node","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceId":{"type":"string","format":"uri","description":"Resource id","example":"urn:resource:345"}},"required":["id","metadata","nodeId","primary","rank","resourceId"]},"NodeResourcePOST":{"type":"object","description":"new node/resource connection ","properties":{"nodeId":{"type":"string","format":"uri","description":"Node id","example":"urn:node:345"},"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which resource is sorted for the node","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceId":{"type":"string","format":"uri","description":"Resource id","example":"urn:resource:345"}},"required":["nodeId","resourceId"]},"NodeResourcePUT":{"type":"object","description":"Updated node/resource connection","properties":{"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the resource will be sorted for this node.","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}}},"NodeSearchBody":{"type":"object","properties":{"contentUris":{"type":"array","description":"ContentURIs to fetch for query","items":{"type":"string"}},"customFields":{"type":"object","additionalProperties":{"type":"string"},"description":"If specified, the search result will be filtered by whether they include the key,value combination provided. If more than one provided only one will be required (OR)"},"filterProgrammes":{"type":"boolean","description":"Filter out programme contexts"},"ids":{"type":"array","description":"Ids to fetch for query","items":{"type":"string"}},"includeContexts":{"type":"boolean","description":"Include all contexts"},"language":{"type":"string","description":"ISO-639-1 language code","example":"nb"},"nodeType":{"type":"array","description":"Filter by nodeType","items":{"$ref":"#/components/schemas/NodeType"}},"page":{"type":"integer","format":"int32","description":"Which page to fetch"},"pageSize":{"type":"integer","format":"int32","description":"How many results to return per page"},"parentId":{"type":"string","format":"uri","description":"Id to parent id in context."},"query":{"type":"string","description":"Query to search names"},"rootId":{"type":"string","format":"uri","description":"Id to root id in context."}},"required":["filterProgrammes","includeContexts","language","page","pageSize"]},"NodeType":{"type":"string","enum":["NODE","SUBJECT","TOPIC","CASE","RESOURCE","PROGRAMME"]},"NodeWithParents":{"type":"object","properties":{"baseName":{"type":"string","description":"The stored name of the node","example":"Trigonometry"},"breadcrumbs":{"type":"array","description":"List of names in the path","items":{"type":"string"}},"contentUri":{"type":"string","format":"uri","description":"ID of content introducing this node. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"context":{"$ref":"#/components/schemas/TaxonomyContext","description":"The context object selected when fetching node"},"contextId":{"type":"string","description":"An id unique for this context."},"contextids":{"type":"array","description":"A list of all contextids this node has ever had","items":{"type":"string"},"uniqueItems":true},"contexts":{"type":"array","description":"A list of all contexts this node is part of","items":{"$ref":"#/components/schemas/TaxonomyContext"}},"gradeAverage":{"$ref":"#/components/schemas/GradeAverage","description":"A number representing the average grade of all children nodes recursively."},"id":{"type":"string","format":"uri","description":"Node id","example":"urn:topic:234"},"language":{"type":"string","description":"The language code for which name is returned","example":"nb"},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Metadata for entity. Read only."},"name":{"type":"string","description":"The possibly translated name of the node","example":"Trigonometry"},"nodeType":{"$ref":"#/components/schemas/NodeType","description":"The type of node","example":"resource"},"parents":{"type":"array","description":"Parent topology nodes and whether or not connection type is primary","example":[{"id":"urn:topic:1:181900","name":"I dyrehagen","contentUri":"urn:article:6662","path":"/subject:2/topic:1:181900","primary":"true"}],"items":{"$ref":"#/components/schemas/NodeChild"},"uniqueItems":true},"path":{"type":"string","description":"The primary path for this node. Can be empty if no context","example":"/subject:1/topic:1"},"paths":{"type":"array","description":"List of all paths to this node","items":{"type":"string"}},"qualityEvaluation":{"$ref":"#/components/schemas/QualityEvaluationDTO","description":"Quality evaluation of the article"},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceTypes":{"type":"array","description":"Resource type(s)","example":[{"id":"urn:resourcetype:1","name":"lecture"}],"items":{"$ref":"#/components/schemas/ResourceTypeWithConnection"},"uniqueItems":true},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"},"uniqueItems":true},"translations":{"type":"array","description":"All translations of this node","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true},"url":{"type":"string","description":"A pretty url based on name and context. Empty if no context."}},"required":["parents"]},"QualityEvaluationDTO":{"type":"object","properties":{"grade":{"$ref":"#/components/schemas/Grade","description":"The grade (1-5) of the article"},"note":{"type":"string","description":"Note explaining the score"}},"required":["grade"]},"Relevance":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Specifies if node is core or supplementary","example":"urn:relevance:core"},"name":{"type":"string","description":"The name of the relevance","example":"Core"},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"},"uniqueItems":true},"translations":{"type":"array","description":"All translations of this relevance","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true}},"required":["id","name","supportedLanguages","translations"]},"ResolvedOldUrl":{"type":"object","properties":{"path":{"type":"string","description":"URL path for resource","example":"'/subject:1/topic:12/resource:12'"}},"required":["path"]},"ResolvedUrl":{"type":"object","properties":{"contentUri":{"type":"string","format":"uri","description":"The ID of this element in the system where the content is stored. This ID should be of the form 'urn:<system>:<id>', where <system> is a short identifier for the system, and <id> is the id of this content in that system.","example":"urn:article:1"},"exactMatch":{"type":"boolean","description":"Is this an exact match for the provided path? False if this is another path to the same resource."},"id":{"type":"string","format":"uri","description":"ID of the element referred to by the given path","example":"urn:resource:1"},"name":{"type":"string","description":"Element name. For performance reasons, this name is for informational purposes only. To get a translated name, please fetch the resolved resource using its rest resource.","example":"Basic physics"},"parents":{"type":"array","description":"Parent elements of the resolved element. The first element is the parent, the second is the grandparent, etc.","items":{"type":"string","format":"uri"}},"path":{"type":"string","description":"URL path for resource","example":"'/subject:1/topic:12/resource:12'"},"url":{"type":"string","description":"Pretty url resource","example":"'/r/subject-name/resource-name/hash'"}},"required":["contentUri","exactMatch","id","name","parents","path","url"]},"ResourcePOST":{"type":"object","description":"Object containing contentUri. Other values are ignored.","properties":{"contentUri":{"type":"string","format":"uri","description":"The ID of this resource in the system where the content is stored. This ID should be of the form 'urn:<system>:<id>', where <system> is a short identifier for the system, and <id> is the id of this content in that system.","example":"urn:article:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:resource: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:resource:2"},"name":{"type":"string","description":"The name of the resource","example":"Introduction to integration"}},"required":["contentUri","name"]},"ResourcePUT":{"type":"object","description":"the new resource","properties":{"contentUri":{"type":"string","format":"uri","description":"The ID of this resource in the system where the content is stored. This ID should be of the form 'urn:<system>:<id>', where <system> is a short identifier for the system, and <id> is the id of this content in that system.","example":"urn:article:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:resource: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:resource:2"},"name":{"type":"string","description":"The name of the resource","example":"Introduction to integration"}},"required":["contentUri","name"]},"ResourceResourceType":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Resource to resource type connection id","example":"urn:resource-has-resourcetypes:12"},"resourceId":{"type":"string","format":"uri","description":"Resource type id","example":"urn:resource:123"},"resourceTypeId":{"type":"string","format":"uri","description":"Resource type id","example":"urn:resourcetype:234"}},"required":["id","resourceId","resourceTypeId"]},"ResourceResourceTypePOST":{"type":"object","description":"The new resource/resource type connection","properties":{"resourceId":{"type":"string","format":"uri","description":"Resource id","example":"urn:resource:123"},"resourceTypeId":{"type":"string","format":"uri","description":"Resource type id","example":"urn:resourcetype:234"}},"required":["resourceId","resourceTypeId"]},"ResourceType":{"type":"object","properties":{"id":{"type":"string","format":"uri","example":"urn:resourcetype:1"},"name":{"type":"string","description":"The name of the resource type","example":"Lecture"},"subtypes":{"type":"array","description":"Sub resource types","items":{"$ref":"#/components/schemas/ResourceType"}},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"},"uniqueItems":true},"translations":{"type":"array","description":"All translations of this resource type","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true}},"required":["id","name","supportedLanguages","translations"]},"ResourceTypePUT":{"type":"object","description":"The new resource type","properties":{"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:resourcetype: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:resourcetype:1"},"name":{"type":"string","description":"The name of the resource type","example":"Lecture"},"order":{"type":"integer","format":"int32","description":"Order in which the resource type should be sorted among its siblings"},"parentId":{"type":"string","format":"uri","description":"If specified, the new resource type will be a child of the mentioned resource type."}},"required":["id","name","parentId"]},"ResourceTypeWithConnection":{"type":"object","properties":{"connectionId":{"type":"string","format":"uri","description":"The id of the resource resource type connection","example":"urn:resource-resourcetype:1"},"id":{"type":"string","format":"uri","example":"urn:resourcetype:2"},"name":{"type":"string","description":"The name of the resource type","example":"Lecture"},"order":{"type":"integer","format":"int32","description":"Internal order of the resource types"},"parentId":{"type":"string","format":"uri","example":"urn:resourcetype:1"},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"}},"translations":{"type":"array","description":"All translations of this resource type","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true}},"required":["connectionId","id","name","supportedLanguages","translations"]},"SearchResult":{"type":"object","properties":{"page":{"type":"integer","format":"int32","example":"The page number"},"pageSize":{"type":"integer","format":"int32","example":"The page size"},"results":{"type":"array","example":"List of search results","items":{"$ref":"#/components/schemas/Node"}},"totalCount":{"type":"integer","format":"int64","example":"Total search result count, useful for fetching multiple pages"}},"required":["page","pageSize","results","totalCount"]},"SearchableTaxonomyResourceType":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"object","additionalProperties":{"type":"string"}},"order":{"type":"integer","format":"int32"},"parentId":{"type":"string"}},"required":["id","name"]},"SubjectPOST":{"type":"object","description":"The updated subject. Fields not included will be set to null.","properties":{"contentUri":{"type":"string","format":"uri","description":"ID of frontpage connected to this subject. Must be a valid URI, but preferably not a URL.","example":"urn:frontpage:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:subject: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:subject:1"},"name":{"type":"string","description":"The name of the subject","example":"Mathematics"}},"required":["name"]},"SubjectPUT":{"type":"object","description":"The new subject","properties":{"contentUri":{"type":"string","format":"uri","description":"ID of frontpage connected to this subject. Must be a valid URI, but preferably not a URL.","example":"urn:frontpage:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:subject: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:subject:1"},"name":{"type":"string","description":"The name of the subject","example":"Mathematics"}},"required":["name"]},"SubjectTopic":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Connection id","example":"urn:subject-has-topics:34"},"primary":{"type":"boolean","description":"primary","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the topic is sorted under the subject","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"subjectid":{"type":"string","format":"uri","description":"Subject id","example":"urn:subject:123"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:345"}},"required":["id","primary","rank","subjectid","topicid"]},"SubjectTopicPOST":{"type":"object","description":"The subject and topic getting connected.","properties":{"primary":{"type":"boolean","description":"Backwards compatibility: Always true, ignored on insert/update.","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the topic should be sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"subjectid":{"type":"string","format":"uri","description":"Subject id","example":"urn:subject:123"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:234"}},"required":["subjectid","topicid"]},"SubjectTopicPUT":{"type":"object","description":"updated subject/topic connection","properties":{"primary":{"type":"boolean","description":"If true, set this subject as the primary subject for this topic. This will replace any other primary subject for this topic. You must have one primary subject, so it is not allowed to set the currently primary subject to not be primary any more.","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the topic should be sorted for the subject","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}}},"TaxonomyContext":{"type":"object","properties":{"breadcrumbs":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"A breadcrumb of the names of the context's parents"},"connectionId":{"type":"string","description":"The id of the parent connection object"},"contextId":{"type":"string","description":"Unique id of context based on root + parent connection"},"contextType":{"type":"string","description":"Whether a 'standard'-article, 'topic-article'-article or a 'learningpath'"},"id":{"type":"string","format":"uri","description":"The publicId of the node connected via content-uri"},"isActive":{"type":"boolean","description":"Whether the parent connection is marked as active"},"isArchived":{"type":"boolean","description":"Whether the root is marked as archived"},"isPrimary":{"type":"boolean","description":"Whether the parent connection is primary or not"},"isVisible":{"type":"boolean","description":"Whether the parent connection is visible or not"},"parentContextIds":{"type":"array","description":"List of all parent contextIds","items":{"type":"string"}},"parentIds":{"type":"array","description":"List of all parent ids","items":{"type":"string","format":"uri"}},"parents":{"type":"array","description":"List of all parents to this context. Empty if node is fetched as child","items":{"$ref":"#/components/schemas/TaxonomyCrumb"}},"path":{"type":"string","description":"The context path"},"publicId":{"type":"string","format":"uri","deprecated":true,"description":"The publicId of the node connected via content-uri"},"rank":{"type":"integer","format":"int32","description":"The rank of the parent connection object"},"relevance":{"type":"object","additionalProperties":{"type":"string"},"description":"Name of the relevance of the parent connection"},"relevanceId":{"type":"string","format":"uri","description":"Id of the relevance of the parent connection"},"resourceTypes":{"type":"array","description":"Resource-types of the node","items":{"$ref":"#/components/schemas/SearchableTaxonomyResourceType"}},"root":{"type":"object","additionalProperties":{"type":"string"},"description":"The name of the root parent of the context"},"rootId":{"type":"string","format":"uri","description":"The publicId of the root parent of the context"},"url":{"type":"string","description":"Pretty-url of this particular context"}},"required":["breadcrumbs","connectionId","contextId","id","isActive","isArchived","isPrimary","isVisible","parentContextIds","parentIds","parents","path","publicId","rank","relevance","relevanceId","resourceTypes","root","rootId","url"]},"TaxonomyCrumb":{"type":"object","properties":{"contextId":{"type":"string","description":"Unique id of context based on root + parent connection"},"id":{"type":"string","format":"uri","description":"The publicId of the node"},"name":{"type":"object","additionalProperties":{"type":"string"},"description":"The name of the node"},"path":{"type":"string","description":"The context path"},"url":{"type":"string","description":"The context url"}},"required":["contextId","id","name","path","url"]},"TopicPOST":{"type":"object","description":"The new topic","properties":{"contentUri":{"type":"string","format":"uri","description":"ID of article introducing this topic. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:topic: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:topic:1"},"name":{"type":"string","description":"The name of the topic","example":"Trigonometry"}},"required":["contentUri","name"]},"TopicPostPut":{"type":"object","description":"The updated topic. Fields not included will be set to null.","properties":{"contentUri":{"type":"string","format":"uri","description":"ID of article introducing this topic. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:topic: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:topic:1"},"name":{"type":"string","description":"The name of the topic","example":"Trigonometry"}},"required":["contentUri","name"]},"TopicResource":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Topic resource connection id","example":"urn:topic-has-resources:123"},"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the resource is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceId":{"type":"string","format":"uri","description":"Resource id","example":"urn:resource:345"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:345"}},"required":["id","primary","rank","resourceId","topicid"]},"TopicResourcePOST":{"type":"object","description":"new topic/resource connection ","properties":{"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which resource is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceId":{"type":"string","format":"uri","description":"Resource id","example":"urn:resource:345"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:345"}},"required":["resourceId","topicid"]},"TopicResourcePUT":{"type":"object","description":"Updated topic/resource connection","properties":{"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the resource will be sorted for this topic.","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}}},"TopicSubtopic":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Connection id","example":"urn:topic-has-subtopics:345"},"primary":{"type":"boolean","description":"Backwards compatibility: Always true. Ignored on insert/update","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which subtopic is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"subtopicid":{"type":"string","format":"uri","description":"Subtopic id","example":"urn:topic:234"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:234"}},"required":["id","primary","rank","subtopicid","topicid"]},"TopicSubtopicPOST":{"type":"object","description":"The new connection","properties":{"primary":{"type":"boolean","description":"Is this connection primary","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which to sort the subtopic for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"subtopicid":{"type":"string","format":"uri","description":"Subtopic id","example":"urn:topic:234"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:234"}},"required":["subtopicid","topicid"]},"TopicSubtopicPUT":{"type":"object","description":"The updated connection","properties":{"primary":{"type":"boolean","description":"Is this connection primary","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which subtopic is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}}},"Translation":{"type":"object","properties":{"language":{"type":"string","description":"ISO 639-1 language code","example":"en"},"name":{"type":"string","description":"The translated name of the node","example":"Trigonometry"}},"required":["language","name"]},"TranslationPUT":{"type":"object","description":"The new or updated translation","properties":{"name":{"type":"string","description":"The translated name of the element. Used wherever translated texts are used.","example":"Trigonometry"}},"required":["name"]},"UrlMapping":{"type":"object","properties":{"nodeId":{"type":"string","description":"Node URN for resource in new system","example":"urn:topic:1:183926"},"subjectId":{"type":"string","description":"Subject URN for resource in new system (optional)","example":"urn:subject:5"},"url":{"type":"string","description":"URL for resource in old system","example":"ndla.no/nb/node/183926?fag=127013"}},"required":["nodeId","subjectId","url"]},"Version":{"type":"object","properties":{"archived":{"type":"string","format":"date-time","description":"Timestamp for when version was archived"},"created":{"type":"string","format":"date-time","description":"Timestamp for when version was created"},"hash":{"type":"string","description":"Unique hash for the version"},"id":{"type":"string","format":"uri","example":"urn:version:1"},"locked":{"type":"boolean","description":"Is the version locked"},"name":{"type":"string","description":"Name for the version"},"published":{"type":"string","format":"date-time","description":"Timestamp for when version was published"},"versionType":{"$ref":"#/components/schemas/VersionType","example":"BETA"}},"required":["created","hash","id","locked","name","versionType"]},"VersionPostPut":{"type":"object","description":"The new version","properties":{"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:version: and be a valid URI. If ommitted, an id will be assigned automatically.","example":"urn:version:1"},"locked":{"type":"boolean","description":"If specified, set the locked property to this value."},"name":{"type":"string","description":"If specified, set the name to this value.","example":"Beta 2022"}},"required":["name"]},"VersionType":{"type":"string","enum":["BETA","PUBLISHED","ARCHIVED"]}},"securitySchemes":{"oauth":{"flows":{"implicit":{"authorizationUrl":"https://ndla-test.eu.auth0.com/authorize"}},"type":"oauth2"}}}}
+{"openapi":"3.1.0","info":{"contact":{"email":"hjelp+api@ndla.no","name":"NDLA","url":"https://ndla.no"},"description":"Rest service and graph database for organizing content.\n\nWhen you remove an entity, its associations are also deleted. E.g., if you remove a subject, its associations to any topics are removed. The topics themselves are not affected.","license":{"name":"GPL 3.0","url":"https://www.gnu.org/licenses/gpl-3.0.en.html"},"termsOfService":"https://om.ndla.no/tos","title":"NDLA Taxonomy API","version":"v1"},"servers":[{"url":"http://localhost:5000"}],"paths":{"/v1/admin/buildAverageTree":{"post":{"operationId":"buildAverageTree","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates average tree for all nodes. Requires taxonomy:admin access.","tags":["admin"]}},"/v1/admin/buildAverageTree/{id}":{"post":{"operationId":"buildAverageTree_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates average tree for the provided node. Requires taxonomy:admin access.","tags":["admin"]}},"/v1/admin/buildContexts":{"get":{"operationId":"buildAllContexts","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"202":{"description":"Accepted"}},"security":[{"oauth":[]}],"summary":"Updates contexts for all roots. Requires taxonomy:admin access.","tags":["admin"]}},"/v1/contexts":{"get":{"operationId":"getAllContexts","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Context"}}}},"description":"OK"}},"summary":"Gets id of all nodes registered as context","tags":["contexts"]},"post":{"description":"All subjects are already contexts and may not be added again. The node to register as context must exist already.","operationId":"createContext","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextPOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Registers a new node as context","tags":["contexts"]}},"/v1/contexts/":{"get":{"operationId":"getAllContexts_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Context"}}}},"description":"OK"}},"summary":"Gets id of all nodes registered as context","tags":["contexts"]},"post":{"description":"All subjects are already contexts and may not be added again. The node to register as context must exist already.","operationId":"createContext_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextPOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Registers a new node as context","tags":["contexts"]}},"/v1/contexts/{id}":{"delete":{"description":"Does not remove the underlying node, only marks it as not being a context","operationId":"deleteContext","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes context registration from node","tags":["contexts"]}},"/v1/node-connections":{"get":{"operationId":"getAllNodeConnections","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeConnection"}}}},"description":"OK"}},"summary":"Gets all connections between node and children","tags":["node-connections"]},"post":{"operationId":"createNodeConnection","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeConnectionPOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a node to a parent","tags":["node-connections"]}},"/v1/node-connections/":{"get":{"operationId":"getAllNodeConnections_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeConnection"}}}},"description":"OK"}},"summary":"Gets all connections between node and children","tags":["node-connections"]},"post":{"operationId":"createNodeConnection_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeConnectionPOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a node to a parent","tags":["node-connections"]}},"/v1/node-connections/page":{"get":{"operationId":"getNodeConnectionsPage","parameters":[{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all connections between node and children paginated","tags":["node-connections"]}},"/v1/node-connections/{id}":{"delete":{"operationId":"deleteEntity_7","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a connection between a node and a child","tags":["node-connections"]},"get":{"operationId":"getNodeConnection","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NodeConnection"}}},"description":"OK"}},"summary":"Gets a single connection between a node and a child","tags":["node-connections"]},"put":{"description":"Use to update which node is primary to a child or to alter sorting order","operationId":"updateNodeConnection","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeConnectionPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a connection between a node and a child","tags":["node-connections"]}},"/v1/node-connections/{id}/metadata":{"get":{"operationId":"getMetadata_5","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["node-connections"]},"put":{"operationId":"putMetadata_5","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataPUT"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["node-connections"]}},"/v1/node-resources":{"get":{"operationId":"getAllNodeResources","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeResource"}}}},"description":"OK"}},"summary":"Gets all connections between node and resources","tags":["node-resources"]},"post":{"operationId":"createNodeResource","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeResourcePOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a resource to a node","tags":["node-resources"]}},"/v1/node-resources/":{"get":{"operationId":"getAllNodeResources_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeResource"}}}},"description":"OK"}},"summary":"Gets all connections between node and resources","tags":["node-resources"]},"post":{"operationId":"createNodeResource_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeResourcePOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a resource to a node","tags":["node-resources"]}},"/v1/node-resources/page":{"get":{"operationId":"getNodeResourcesPage","parameters":[{"description":"The page to fetch","in":"query","name":"page","required":true,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":true,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all connections between node and resources paginated","tags":["node-resources"]}},"/v1/node-resources/{id}":{"delete":{"operationId":"deleteEntity_6","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a resource from a node","tags":["node-resources"]},"get":{"operationId":"getNodeResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NodeResource"}}},"description":"OK"}},"summary":"Gets a specific connection between a node and a resource","tags":["node-resources"]},"put":{"description":"Use to update which node is primary to the resource or to change sorting order.","operationId":"updateNodeResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeResourcePUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a connection between a node and a resource","tags":["node-resources"]}},"/v1/node-resources/{id}/metadata":{"get":{"operationId":"getMetadata_4","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["node-resources"]},"put":{"operationId":"putMetadata_4","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataPUT"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["node-resources"]}},"/v1/nodes":{"get":{"operationId":"getAllNodes","parameters":[{"description":"Filter by nodeType, could be a comma separated list, defaults to Topics and Subjects (Resources are quite slow). :^)","in":"query","name":"nodeType","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeType"}}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Ids to filter by","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string","format":"uri"}}},{"deprecated":true,"description":"Only root level contexts","in":"query","name":"isRoot","required":false,"schema":{"type":"boolean"}},{"description":"Only contexts","in":"query","name":"isContext","required":false,"schema":{"type":"boolean"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter by context id. Beware: handled separately from other parameters!","in":"query","name":"contextId","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Id to root id in context.","in":"query","name":"rootId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Id to parent id in context.","in":"query","name":"parentId","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all nodes","tags":["nodes"]},"post":{"operationId":"createNode","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodePostPut"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Creates a new node","tags":["nodes"]}},"/v1/nodes/":{"get":{"operationId":"getAllNodes_1","parameters":[{"description":"Filter by nodeType, could be a comma separated list, defaults to Topics and Subjects (Resources are quite slow). :^)","in":"query","name":"nodeType","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeType"}}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Ids to filter by","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string","format":"uri"}}},{"deprecated":true,"description":"Only root level contexts","in":"query","name":"isRoot","required":false,"schema":{"type":"boolean"}},{"description":"Only contexts","in":"query","name":"isContext","required":false,"schema":{"type":"boolean"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter by context id. Beware: handled separately from other parameters!","in":"query","name":"contextId","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Id to root id in context.","in":"query","name":"rootId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Id to parent id in context.","in":"query","name":"parentId","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all nodes","tags":["nodes"]},"post":{"operationId":"createNode_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodePostPut"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Creates a new node","tags":["nodes"]}},"/v1/nodes/page":{"get":{"operationId":"getNodePage","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"description":"Filter by nodeType","in":"query","name":"nodeType","required":false,"schema":{"$ref":"#/components/schemas/NodeType"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean","default":true}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all nodes paginated","tags":["nodes"]}},"/v1/nodes/search":{"get":{"operationId":"searchNodes","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"How many results to return per page","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"description":"Which page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Query to search names","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Ids to fetch for query","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"ContentURIs to fetch for query","in":"query","name":"contentUris","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Filter by nodeType","in":"query","name":"nodeType","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeType"}}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Id to root id in context to select. Does not affect search results","in":"query","name":"rootId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Id to parent id in context to select. Does not affect search results","in":"query","name":"parentId","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Search all nodes","tags":["nodes"]},"post":{"operationId":"searchNodes_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeSearchBody"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Search all nodes","tags":["nodes"]}},"/v1/nodes/{id}":{"delete":{"operationId":"deleteEntity_5","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a single node by id","tags":["nodes"]},"get":{"operationId":"getNode","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"Id to root id in context.","in":"query","name":"rootId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Id to parent id in context.","in":"query","name":"parentId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean","default":true}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Node"}}},"description":"OK"}},"summary":"Gets a single node","tags":["nodes"]},"put":{"operationId":"updateNode","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodePostPut"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a single node","tags":["nodes"]}},"/v1/nodes/{id}/clone":{"post":{"operationId":"cloneResource_1","parameters":[{"description":"Id of node to clone","example":"urn:resource:1","in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodePostPut"}}},"required":true},"responses":{"200":{"description":"OK"}},"security":[{"oauth":[]}],"summary":"Clones a node, presumably a resource, including resource-types and translations","tags":["nodes"]}},"/v1/nodes/{id}/connections":{"get":{"operationId":"getAllConnections","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Connection"}}}},"description":"OK"}},"summary":"Gets all parents and children this node is connected to","tags":["nodes"]}},"/v1/nodes/{id}/full":{"get":{"deprecated":true,"operationId":"getNodeFull","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NodeWithParents"}}},"description":"OK"}},"summary":"Gets node including information about all parents, and resourceTypes for this resource. Can be replaced with regular get-endpoint and traversing contexts","tags":["nodes"]}},"/v1/nodes/{id}/makeResourcesPrimary":{"put":{"operationId":"makeResourcesPrimary_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"If true, children are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"boolean"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Makes all connected resources primary","tags":["nodes"]}},"/v1/nodes/{id}/metadata":{"get":{"operationId":"getMetadata_3","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["nodes"]},"put":{"operationId":"putMetadata_3","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataPUT"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["nodes"]}},"/v1/nodes/{id}/nodes":{"get":{"operationId":"getChildren","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"Filter by nodeType, could be a comma separated list, defaults to Topics and Subjects (Resources are quite slow). :^)","in":"query","name":"nodeType","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeType"}}},{"description":"Only connections of given type are returned","in":"query","name":"connectionTypes","required":false,"schema":{"type":"array","default":["BRANCH"],"items":{"$ref":"#/components/schemas/NodeConnectionType"}}},{"description":"If true, children are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean","default":true}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all children for this node","tags":["nodes"]}},"/v1/nodes/{id}/publish":{"put":{"deprecated":true,"operationId":"publishNode","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"Version id to publish from. Can be omitted to publish from default.","example":"urn:version:1","in":"query","name":"sourceId","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Version id to publish to.","example":"urn:version:2","in":"query","name":"targetId","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"202":{"description":"Accepted"}},"security":[{"oauth":[]}],"summary":"Publishes a node hierarchy to a version","tags":["nodes"]}},"/v1/nodes/{id}/resources":{"get":{"operationId":"getResources","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Include all contexts","in":"query","name":"includeContexts","required":false,"schema":{"type":"boolean","default":true}},{"description":"Filter out programme contexts","in":"query","name":"filterProgrammes","required":false,"schema":{"type":"boolean","default":false}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean","default":true}},{"description":"If true, resources from children are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"description":"Select by resource type id(s). If not specified, resources of all types will be returned. Multiple ids may be separated with comma or the parameter may be repeated for each id.","in":"query","name":"type","required":false,"schema":{"type":"array","items":{"type":"string","format":"uri"}}},{"description":"Select by relevance. If not specified, all resources will be returned.","in":"query","name":"relevance","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all resources for the given node","tags":["nodes"]}},"/v1/nodes/{id}/translations":{"get":{"operationId":"getAllNodeTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all translations for a single node","tags":["node-translations"]}},"/v1/nodes/{id}/translations/":{"get":{"operationId":"getAllNodeTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all translations for a single node","tags":["node-translations"]}},"/v1/nodes/{id}/translations/{language}":{"delete":{"operationId":"deleteNodeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a translation","tags":["node-translations"]},"get":{"operationId":"getNodeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single node","tags":["node-translations"]},"put":{"operationId":"createUpdateNodeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Creates or updates a translation of a node","tags":["node-translations"]}},"/v1/queries/contextId":{"get":{"operationId":"contextByContextId","parameters":[{"in":"query","name":"contextId","required":false,"schema":{"type":"string"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaxonomyContext"}}}},"description":"OK"}},"summary":"Gets a list of contexts matching given contextId, empty list if no matches are found.","tags":["queries"]}},"/v1/queries/path":{"get":{"operationId":"queryPath","parameters":[{"in":"query","name":"path","required":false,"schema":{"type":"string"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaxonomyContext"}}}},"description":"OK"}},"summary":"Gets a list of contexts matching given pretty url with contextId, empty list if no matches are found.","tags":["queries"]}},"/v1/queries/resources":{"get":{"deprecated":true,"operationId":"queryResources","parameters":[{"in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Fitler by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter by visible","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets a list of resources matching given contentURI, empty list of no matches are found. DEPRECATED: Use /v1/resources?contentURI= instead","tags":["queries"]}},"/v1/queries/topics":{"get":{"deprecated":true,"operationId":"queryTopics","parameters":[{"in":"query","name":"contentURI","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Fitler by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter by visible","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets a list of topics matching given contentURI, empty list of no matches are found. DEPRECATED: Use /v1/topics?contentURI= instead","tags":["queries"]}},"/v1/queries/{contentURI}":{"get":{"operationId":"contextByContentURI","parameters":[{"in":"path","name":"contentURI","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Whether to filter out contexts if a parent (or the node itself) is non-visible","in":"query","name":"filterVisibles","required":false,"schema":{"type":"boolean","default":true}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TaxonomyContext"}}}},"description":"OK"}},"summary":"Gets a list of contexts matching given contentURI, empty list if no matches are found.","tags":["queries"]}},"/v1/relevances":{"get":{"operationId":"getAllRelevances","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Relevance"}}}},"description":"OK"}},"summary":"Gets all relevances","tags":["relevances"]}},"/v1/relevances/":{"get":{"operationId":"getAllRelevances_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Relevance"}}}},"description":"OK"}},"summary":"Gets all relevances","tags":["relevances"]}},"/v1/relevances/{id}":{"get":{"description":"Default language will be returned if desired language not found or if parameter is omitted.","operationId":"getRelevance","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Relevance"}}},"description":"OK"}},"summary":"Gets a single relevance","tags":["relevances"]}},"/v1/relevances/{id}/translations":{"get":{"operationId":"getAllRelevanceTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single relevance","tags":["relevance-translations"]}},"/v1/relevances/{id}/translations/":{"get":{"operationId":"getAllRelevanceTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single relevance","tags":["relevance-translations"]}},"/v1/relevances/{id}/translations/{language}":{"get":{"operationId":"getRelevanceTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single relevance","tags":["relevance-translations"]}},"/v1/resource-resourcetypes":{"get":{"operationId":"getAllResourceResourceTypes","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceResourceType"}}}},"description":"OK"}},"summary":"Gets all connections between resources and resource types","tags":["resource-resource-types"]},"post":{"operationId":"createResourceResourceType","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceResourceTypePOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a resource type to a resource","tags":["resource-resource-types"]}},"/v1/resource-resourcetypes/":{"get":{"operationId":"getAllResourceResourceTypes_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceResourceType"}}}},"description":"OK"}},"summary":"Gets all connections between resources and resource types","tags":["resource-resource-types"]},"post":{"operationId":"createResourceResourceType_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceResourceTypePOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a resource type to a resource","tags":["resource-resource-types"]}},"/v1/resource-resourcetypes/{id}":{"delete":{"operationId":"deleteResourceResourceType","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a resource type from a resource","tags":["resource-resource-types"]},"get":{"operationId":"getResourceResourceType","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResourceResourceType"}}},"description":"OK"}},"summary":"Gets a single connection between resource and resource type","tags":["resource-resource-types"]}},"/v1/resource-types":{"get":{"operationId":"getAllResourceTypes","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceType"}}}},"description":"OK"}},"summary":"Gets a list of all resource types","tags":["resource-types"]},"post":{"operationId":"createResourceType","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceTypePUT"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a new resource type","tags":["resource-types"]}},"/v1/resource-types/":{"get":{"operationId":"getAllResourceTypes_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceType"}}}},"description":"OK"}},"summary":"Gets a list of all resource types","tags":["resource-types"]},"post":{"operationId":"createResourceType_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceTypePUT"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a new resource type","tags":["resource-types"]}},"/v1/resource-types/{id}":{"delete":{"operationId":"deleteEntity_4","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a single entity by id","tags":["resource-types"]},"get":{"operationId":"getResourceType","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResourceType"}}},"description":"OK"}},"summary":"Gets a single resource type","tags":["resource-types"]},"put":{"operationId":"updateResourceType","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourceTypePUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a resource type. Use to update which resource type is parent. You can also update the id, take care!","tags":["resource-types"]}},"/v1/resource-types/{id}/subtypes":{"get":{"operationId":"getResourceTypeSubtypes","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":""}},{"description":"If true, sub resource types are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceType"}}}},"description":"OK"}},"summary":"Gets subtypes of one resource type","tags":["resource-types"]}},"/v1/resource-types/{id}/translations":{"get":{"operationId":"getAllResourceTypeTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single resource type","tags":["resource-type-translations"]}},"/v1/resource-types/{id}/translations/":{"get":{"operationId":"getAllResourceTypeTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single resource type","tags":["resource-type-translations"]}},"/v1/resource-types/{id}/translations/{language}":{"delete":{"operationId":"deleteResourceTypeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a translation","tags":["resource-type-translations"]},"get":{"operationId":"getResourceTypeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single resource type","tags":["resource-type-translations"]},"put":{"operationId":"createUpdateResourceTypeTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Creates or updates a translation of a resource type","tags":["resource-type-translations"]}},"/v1/resources":{"get":{"deprecated":true,"operationId":"getAllResources","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Lists all resources","tags":["resources"]},"post":{"deprecated":true,"operationId":"createResource","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourcePUT"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a new resource","tags":["resources"]}},"/v1/resources/":{"get":{"deprecated":true,"operationId":"getAllResources_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Lists all resources","tags":["resources"]},"post":{"deprecated":true,"operationId":"createResource_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourcePUT"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a new resource","tags":["resources"]}},"/v1/resources/page":{"get":{"deprecated":true,"operationId":"getResourcePage","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all resources paginated","tags":["resources"]}},"/v1/resources/search":{"get":{"deprecated":true,"operationId":"searchResources","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"How many results to return per page","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"description":"Which page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Query to search names","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Ids to fetch for query","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"ContentURIs to fetch for query","in":"query","name":"contentUris","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Search all resources","tags":["resources"]}},"/v1/resources/{id}":{"delete":{"deprecated":true,"operationId":"deleteEntity_3","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a single entity by id","tags":["resources"]},"get":{"deprecated":true,"operationId":"getResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Node"}}},"description":"OK"}},"summary":"Gets a single resource","tags":["resources"]},"put":{"deprecated":true,"operationId":"updateResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourcePOST"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a resource","tags":["resources"]}},"/v1/resources/{id}/clone":{"post":{"deprecated":true,"operationId":"cloneResource","parameters":[{"description":"Id of resource to clone","example":"urn:resource:1","in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResourcePOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Clones a resource, including resource-types and translations","tags":["resources"]}},"/v1/resources/{id}/full":{"get":{"deprecated":true,"operationId":"getResourceFull","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NodeWithParents"}}},"description":"OK"}},"summary":"Gets all parent topics, all filters and resourceTypes for this resource","tags":["resources"]}},"/v1/resources/{id}/metadata":{"get":{"operationId":"getMetadata_2","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["resources"]},"put":{"operationId":"putMetadata_2","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataPUT"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["resources"]}},"/v1/resources/{id}/resource-types":{"get":{"deprecated":true,"operationId":"getResourceTypes","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResourceTypeWithConnection"}}}},"description":"OK"}},"summary":"Gets all resource types associated with this resource","tags":["resources"]}},"/v1/resources/{id}/translations":{"get":{"deprecated":true,"operationId":"getAllResourceTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single resource","tags":["resource-translations"]}},"/v1/resources/{id}/translations/":{"get":{"deprecated":true,"operationId":"getAllResourceTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single resource","tags":["resource-translations"]}},"/v1/resources/{id}/translations/{language}":{"delete":{"deprecated":true,"operationId":"deleteResourceTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a translation","tags":["resource-translations"]},"get":{"deprecated":true,"operationId":"getResourceTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single resource","tags":["resource-translations"]},"put":{"deprecated":true,"operationId":"createUpdateResourceTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Creates or updates a translation of a resource","tags":["resource-translations"]}},"/v1/subject-topics":{"get":{"deprecated":true,"operationId":"getAllSubjectTopics","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SubjectTopic"}}}},"description":"OK"}},"summary":"Gets all connections between subjects and topics","tags":["subject-topics"]},"post":{"deprecated":true,"operationId":"createSubjectTopic","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectTopicPOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a new topic to a subject","tags":["subject-topics"]}},"/v1/subject-topics/":{"get":{"deprecated":true,"operationId":"getAllSubjectTopics_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SubjectTopic"}}}},"description":"OK"}},"summary":"Gets all connections between subjects and topics","tags":["subject-topics"]},"post":{"deprecated":true,"operationId":"createSubjectTopic_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectTopicPOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a new topic to a subject","tags":["subject-topics"]}},"/v1/subject-topics/page":{"get":{"deprecated":true,"operationId":"getSubjectTopicPage","parameters":[{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all connections between subjects and topics paginated","tags":["subject-topics"]}},"/v1/subject-topics/{id}":{"delete":{"deprecated":true,"operationId":"deleteSubjectTopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a topic from a subject","tags":["subject-topics"]},"get":{"deprecated":true,"operationId":"getSubjectTopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SubjectTopic"}}},"description":"OK"}},"summary":"Get a specific connection between a subject and a topic","tags":["subject-topics"]},"put":{"deprecated":true,"description":"Use to update which subject is primary to a topic or to change sorting order.","operationId":"updateSubjectTopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectTopicPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a connection between subject and topic","tags":["subject-topics"]}},"/v1/subjects":{"get":{"deprecated":true,"operationId":"getAllSubjects","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all subjects","tags":["subjects"]},"post":{"deprecated":true,"operationId":"createSubject","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectPUT"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Creates a new subject","tags":["subjects"]}},"/v1/subjects/":{"get":{"deprecated":true,"operationId":"getAllSubjects_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all subjects","tags":["subjects"]},"post":{"deprecated":true,"operationId":"createSubject_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectPUT"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Creates a new subject","tags":["subjects"]}},"/v1/subjects/page":{"get":{"deprecated":true,"operationId":"getSubjectPage","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all nodes paginated","tags":["subjects"]}},"/v1/subjects/search":{"get":{"deprecated":true,"operationId":"searchSubjects","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"How many results to return per page","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"description":"Which page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Query to search names","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Ids to fetch for query","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"ContentURIs to fetch for query","in":"query","name":"contentUris","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Search all subjects","tags":["subjects"]}},"/v1/subjects/{id}":{"delete":{"deprecated":true,"operationId":"deleteEntity_2","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a single entity by id","tags":["subjects"]},"get":{"deprecated":true,"description":"Default language will be returned if desired language not found or if parameter is omitted.","operationId":"getSubject","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Node"}}},"description":"OK"}},"summary":"Gets a single subject","tags":["subjects"]},"put":{"deprecated":true,"operationId":"updateSubject","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubjectPOST"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a subject","tags":["subjects"]}},"/v1/subjects/{id}/metadata":{"get":{"operationId":"getMetadata_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["subjects"]},"put":{"operationId":"putMetadata_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataPUT"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["subjects"]}},"/v1/subjects/{id}/topics":{"get":{"deprecated":true,"description":"This resource is read-only. To update the relationship between nodes, use the resource /subject-topics.","operationId":"getSubjectChildren","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"If true, subtopics are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"description":"Select by relevance. If not specified, all nodes will be returned.","in":"query","name":"relevance","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all children associated with a subject","tags":["subjects"]}},"/v1/subjects/{id}/translations":{"get":{"deprecated":true,"operationId":"getAllSubjectTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single subject","tags":["subject-translations"]}},"/v1/subjects/{id}/translations/":{"get":{"deprecated":true,"operationId":"getAllSubjectTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single subject","tags":["subject-translations"]}},"/v1/subjects/{id}/translations/{language}":{"delete":{"deprecated":true,"operationId":"deleteSubjectTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a translation","tags":["subject-translations"]},"get":{"deprecated":true,"operationId":"getSubjectTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single subject","tags":["subject-translations"]},"put":{"deprecated":true,"operationId":"createUpdateSubjectTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Creates or updates a translation of a subject","tags":["subject-translations"]}},"/v1/subjects/{subjectId}/resources":{"get":{"deprecated":true,"operationId":"getSubjectResources","parameters":[{"in":"path","name":"subjectId","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by resource type id(s). If not specified, resources of all types will be returned.Multiple ids may be separated with comma or the parameter may be repeated for each id.","in":"query","name":"type","required":false,"schema":{"type":"array","items":{"type":"string","format":"uri"}}},{"description":"Select by relevance. If not specified, all resources will be returned.","in":"query","name":"relevance","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all resources for a subject. Searches recursively in all children of this node.The ordering of resources will be based on the rank of resources relative to the node they belong to.","tags":["subjects"]}},"/v1/topic-resources":{"get":{"deprecated":true,"operationId":"getAllTopicResources","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TopicResource"}}}},"description":"OK"}},"summary":"Gets all connections between topics and resources","tags":["topic-resources"]},"post":{"deprecated":true,"operationId":"createTopicResource","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicResourcePOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a resource to a topic","tags":["topic-resources"]}},"/v1/topic-resources/":{"get":{"deprecated":true,"operationId":"getAllTopicResources_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TopicResource"}}}},"description":"OK"}},"summary":"Gets all connections between topics and resources","tags":["topic-resources"]},"post":{"deprecated":true,"operationId":"createTopicResource_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicResourcePOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a resource to a topic","tags":["topic-resources"]}},"/v1/topic-resources/page":{"get":{"deprecated":true,"operationId":"getTopicResourcePage","parameters":[{"description":"The page to fetch","in":"query","name":"page","required":true,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":true,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all connections between topic and resources paginated","tags":["topic-resources"]}},"/v1/topic-resources/{id}":{"delete":{"deprecated":true,"operationId":"deleteTopicResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a resource from a topic","tags":["topic-resources"]},"get":{"deprecated":true,"operationId":"getTopicResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/TopicResource"}}},"description":"OK"}},"summary":"Gets a specific connection between a topic and a resource","tags":["topic-resources"]},"put":{"deprecated":true,"description":"Use to update which topic is primary to the resource or to change sorting order.","operationId":"updateTopicResource","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicResourcePUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a connection between a topic and a resource","tags":["topic-resources"]}},"/v1/topic-subtopics":{"get":{"deprecated":true,"operationId":"getAllTopicSubtopics","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TopicSubtopic"}}}},"description":"OK"}},"summary":"Gets all connections between topics and subtopics","tags":["topic-subtopics"]},"post":{"deprecated":true,"operationId":"createTopicSubtopic","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicSubtopicPOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a subtopic to a topic","tags":["topic-subtopics"]}},"/v1/topic-subtopics/":{"get":{"deprecated":true,"operationId":"getAllTopicSubtopics_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TopicSubtopic"}}}},"description":"OK"}},"summary":"Gets all connections between topics and subtopics","tags":["topic-subtopics"]},"post":{"deprecated":true,"operationId":"createTopicSubtopic_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicSubtopicPOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Adds a subtopic to a topic","tags":["topic-subtopics"]}},"/v1/topic-subtopics/page":{"get":{"deprecated":true,"operationId":"getTopicSubtopicPage","parameters":[{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all connections between topics and subtopics paginated","tags":["topic-subtopics"]}},"/v1/topic-subtopics/{id}":{"delete":{"deprecated":true,"operationId":"deleteTopicSubtopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Removes a connection between a topic and a subtopic","tags":["topic-subtopics"]},"get":{"deprecated":true,"operationId":"getTopicSubtopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/TopicSubtopic"}}},"description":"OK"}},"summary":"Gets a single connection between a topic and a subtopic","tags":["topic-subtopics"]},"put":{"deprecated":true,"description":"Use to update which topic is primary to a subtopic or to alter sorting order","operationId":"updateTopicSubtopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicSubtopicPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a connection between a topic and a subtopic","tags":["topic-subtopics"]}},"/v1/topics":{"get":{"deprecated":true,"operationId":"getAllTopics","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all topics","tags":["topics"]},"post":{"deprecated":true,"operationId":"createTopic","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicPOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Creates a new topic","tags":["topics"]}},"/v1/topics/":{"get":{"deprecated":true,"operationId":"getAllTopics_1","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"Filter by contentUri","in":"query","name":"contentURI","required":false,"schema":{"type":"string","format":"uri"}},{"description":"Filter by key and value","in":"query","name":"key","required":false,"schema":{"type":"string"}},{"description":"Filter by key and value","in":"query","name":"value","required":false,"schema":{"type":"string"}},{"description":"Filter contexts by visibility","in":"query","name":"isVisible","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Node"}}}},"description":"OK"}},"summary":"Gets all topics","tags":["topics"]},"post":{"deprecated":true,"operationId":"createTopic_1","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicPOST"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Creates a new topic","tags":["topics"]}},"/v1/topics/page":{"get":{"deprecated":true,"operationId":"getTopicsPage","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"The page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Size of page to fetch","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Gets all topics paginated","tags":["topics"]}},"/v1/topics/search":{"get":{"deprecated":true,"operationId":"searchTopics","parameters":[{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"How many results to return per page","in":"query","name":"pageSize","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"description":"Which page to fetch","in":"query","name":"page","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"description":"Query to search names","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Ids to fetch for query","in":"query","name":"ids","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"ContentURIs to fetch for query","in":"query","name":"contentUris","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/SearchResult"}}},"description":"OK"}},"summary":"Search all topics","tags":["topics"]}},"/v1/topics/{id}":{"delete":{"deprecated":true,"description":"Deletes a single entity by id","operationId":"deleteEntity_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"tags":["topics"]},"get":{"deprecated":true,"operationId":"getTopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Node"}}},"description":"OK"}},"summary":"Gets a single topic","tags":["topics"]},"put":{"deprecated":true,"operationId":"updateTopic","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicPostPut"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a single topic","tags":["topics"]}},"/v1/topics/{id}/connections":{"get":{"deprecated":true,"operationId":"getAllTopicConnections","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Connection"}}}},"description":"OK"}},"summary":"Gets all subjects and subtopics this topic is connected to","tags":["topics"]}},"/v1/topics/{id}/makeResourcesPrimary":{"put":{"deprecated":true,"operationId":"makeResourcesPrimary","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"If true, children are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"boolean"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Makes all connected resources primary","tags":["topics"]}},"/v1/topics/{id}/metadata":{"get":{"operationId":"getMetadata","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"summary":"Gets metadata for entity","tags":["topics"]},"put":{"operationId":"putMetadata","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetadataPUT"}}},"required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Metadata"}}},"description":"OK"}},"security":[{"oauth":[]}],"summary":"Updates metadata for entity","tags":["topics"]}},"/v1/topics/{id}/resources":{"get":{"deprecated":true,"operationId":"getTopicResources","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"description":"If true, resources from subtopics are fetched recursively","in":"query","name":"recursive","required":false,"schema":{"type":"boolean","default":false}},{"description":"Select by resource type id(s). If not specified, resources of all types will be returned.Multiple ids may be separated with comma or the parameter may be repeated for each id.","in":"query","name":"type","required":false,"schema":{"type":"array","items":{"type":"string","format":"uri"}}},{"description":"Select by relevance. If not specified, all resources will be returned.","in":"query","name":"relevance","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all resources for the given topic","tags":["topics"]}},"/v1/topics/{id}/topics":{"get":{"deprecated":true,"operationId":"getTopicSubTopics","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"Select filters by subject id if filter list is empty. Used as alternative to specify filters.","in":"query","name":"subject","required":false,"schema":{"type":"string","format":"uri","default":""}},{"description":"ISO-639-1 language code","example":"nb","in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NodeChild"}}}},"description":"OK"}},"summary":"Gets all subtopics for this topic","tags":["topics"]}},"/v1/topics/{id}/translations":{"get":{"deprecated":true,"operationId":"getAllTopicTranslations","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single topic","tags":["topic-translations"]}},"/v1/topics/{id}/translations/":{"get":{"deprecated":true,"operationId":"getAllTopicTranslations_1","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Translation"}}}},"description":"OK"}},"summary":"Gets all relevanceTranslations for a single topic","tags":["topic-translations"]}},"/v1/topics/{id}/translations/{language}":{"delete":{"deprecated":true,"operationId":"deleteTopicTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a translation","tags":["topic-translations"]},"get":{"deprecated":true,"operationId":"getTopicTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Translation"}}},"description":"OK"}},"summary":"Gets a single translation for a single topic","tags":["topic-translations"]},"put":{"deprecated":true,"operationId":"createUpdateTopicTranslation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"description":"ISO-639-1 language code","example":"nb","in":"path","name":"language","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationPUT"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Creates or updates a translation of a topic","tags":["topic-translations"]}},"/v1/url/mapping":{"get":{"operationId":"getTaxonomyPathForUrl","parameters":[{"description":"url in old rig except 'https://'","example":"ndla.no/nb/node/142542?fag=52253","in":"query","name":"url","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResolvedOldUrl"}}},"description":"OK"}},"summary":"Returns path for an url or HTTP 404","tags":["url-resolver"]},"put":{"operationId":"putTaxonomyNodeAndSubjectForOldUrl","parameters":[{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlMapping"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Inserts or updates a mapping from url to nodeId and optionally subjectId","tags":["url-resolver"]}},"/v1/url/resolve":{"get":{"operationId":"resolve","parameters":[{"in":"query","name":"path","required":true,"schema":{"type":"string"}},{"in":"query","name":"language","required":false,"schema":{"type":"string","default":"nb"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResolvedUrl"}}},"description":"OK"}},"tags":["url-resolver"]}},"/v1/versions":{"get":{"operationId":"getAllVersions","parameters":[{"description":"Version type","example":"PUBLISHED","in":"query","name":"type","required":false,"schema":{"$ref":"#/components/schemas/VersionType","default":null}},{"description":"Version hash","example":"ndla","in":"query","name":"hash","required":false,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Version"}}}},"description":"OK"}},"summary":"Gets all versions","tags":["versions"]},"post":{"operationId":"createVersion","parameters":[{"description":"Base new version on version with this id","in":"query","name":"sourceId","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionPostPut"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Creates a new version","tags":["versions"]}},"/v1/versions/":{"get":{"operationId":"getAllVersions_1","parameters":[{"description":"Version type","example":"PUBLISHED","in":"query","name":"type","required":false,"schema":{"$ref":"#/components/schemas/VersionType","default":null}},{"description":"Version hash","example":"ndla","in":"query","name":"hash","required":false,"schema":{"type":"string"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Version"}}}},"description":"OK"}},"summary":"Gets all versions","tags":["versions"]},"post":{"operationId":"createVersion_1","parameters":[{"description":"Base new version on version with this id","in":"query","name":"sourceId","required":false,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionPostPut"}}},"required":true},"responses":{"201":{"description":"Created","headers":{"Location":{"schema":{"type":"string"},"style":"simple"}}}},"security":[{"oauth":[]}],"summary":"Creates a new version","tags":["versions"]}},"/v1/versions/{id}":{"delete":{"operationId":"deleteEntity","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Deletes a version by publicId","tags":["versions"]},"get":{"operationId":"getVersion","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Version"}}},"description":"OK"}},"summary":"Gets a single version","tags":["versions"]},"put":{"operationId":"updateVersion","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionPostPut"}}},"required":true},"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Updates a version","tags":["versions"]}},"/v1/versions/{id}/publish":{"put":{"operationId":"publishVersion","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uri"}},{"$ref":"#/components/parameters/versionHash","in":"header"}],"responses":{"204":{"description":"No Content"}},"security":[{"oauth":[]}],"summary":"Publishes a version","tags":["versions"]}}},"components":{"headers":{"versionHash":{"description":"versionHash","schema":{"type":"string"}}},"parameters":{"versionHash":{"in":"header","name":"versionHash","schema":{"type":"string"}}},"schemas":{"Connection":{"type":"object","properties":{"connectionId":{"type":"string","format":"uri","description":"The id of the subject-topic or topic-subtopic connection","example":"urn:subject-topic:1"},"isPrimary":{"type":"boolean","deprecated":true,"description":"True if owned by this topic, false if it has its primary connection elsewhere","example":true},"paths":{"type":"array","deprecated":true,"description":"The path part of the url for the subject or subtopic connected to this topic","example":"/subject:1/topic:1","items":{"type":"string"},"uniqueItems":true},"targetId":{"type":"string","format":"uri","description":"The id of the connected subject or topic","example":"urn:subject:1"},"type":{"type":"string","description":"The type of connection (parent, child, referrer or target"}},"required":["connectionId","isPrimary","paths","targetId","type"]},"Context":{"type":"object","properties":{"id":{"type":"string","format":"uri"},"name":{"type":"string"},"path":{"type":"string"}},"required":["id","name","path"]},"ContextPOST":{"type":"object","description":"object containing public id of the node to be registered as context","properties":{"id":{"type":"string","format":"uri"}},"required":["id"]},"Grade":{"type":"integer","format":"int32","enum":[1,2,3,4,5]},"GradeAverage":{"type":"object","properties":{"averageValue":{"type":"number","format":"double"},"count":{"type":"integer","format":"int32"}},"required":["averageValue","count"]},"Metadata":{"type":"object","properties":{"customFields":{"type":"object","additionalProperties":{"type":"string"}},"grepCodes":{"type":"array","items":{"type":"string"},"uniqueItems":true},"visible":{"type":"boolean"}},"required":["customFields","grepCodes","visible"]},"MetadataPUT":{"type":"object","properties":{"customFields":{"type":"object","additionalProperties":{"type":"string"},"description":"Custom fields, Only updated if present"},"grepCodes":{"type":"array","description":"Set of grep codes, Only updated if present","items":{"type":"string"},"uniqueItems":true},"visible":{"type":"boolean","description":"Visibility of the node, Only updated if present"}}},"Node":{"type":"object","properties":{"baseName":{"type":"string","description":"The stored name of the node","example":"Trigonometry"},"breadcrumbs":{"type":"array","description":"List of names in the path","items":{"type":"string"}},"contentUri":{"type":"string","format":"uri","description":"ID of content introducing this node. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"context":{"$ref":"#/components/schemas/TaxonomyContext","description":"The context object selected when fetching node"},"contextId":{"type":"string","description":"An id unique for this context."},"contextids":{"type":"array","description":"A list of all contextids this node has ever had","items":{"type":"string"},"uniqueItems":true},"contexts":{"type":"array","description":"A list of all contexts this node is part of","items":{"$ref":"#/components/schemas/TaxonomyContext"}},"gradeAverage":{"$ref":"#/components/schemas/GradeAverage","description":"A number representing the average grade of all children nodes recursively."},"id":{"type":"string","format":"uri","description":"Node id","example":"urn:topic:234"},"language":{"type":"string","description":"The language code for which name is returned","example":"nb"},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Metadata for entity. Read only."},"name":{"type":"string","description":"The possibly translated name of the node","example":"Trigonometry"},"nodeType":{"$ref":"#/components/schemas/NodeType","description":"The type of node","example":"resource"},"path":{"type":"string","description":"The primary path for this node. Can be empty if no context","example":"/subject:1/topic:1"},"paths":{"type":"array","description":"List of all paths to this node","items":{"type":"string"}},"qualityEvaluation":{"$ref":"#/components/schemas/QualityEvaluationDTO","description":"Quality evaluation of the article"},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceTypes":{"type":"array","description":"Resource type(s)","example":[{"id":"urn:resourcetype:1","name":"lecture"}],"items":{"$ref":"#/components/schemas/ResourceTypeWithConnection"},"uniqueItems":true},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"},"uniqueItems":true},"translations":{"type":"array","description":"All translations of this node","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true},"url":{"type":"string","description":"A pretty url based on name and context. Empty if no context."}},"required":["baseName","breadcrumbs","contextids","contexts","id","language","metadata","name","nodeType","paths","resourceTypes","supportedLanguages","translations"]},"NodeChild":{"type":"object","properties":{"baseName":{"type":"string","description":"The stored name of the node","example":"Trigonometry"},"breadcrumbs":{"type":"array","description":"List of names in the path","items":{"type":"string"}},"connectionId":{"type":"string","format":"uri","description":"The id of the node connection which causes this node to be included in the result set.","example":"urn:node-connection:1"},"contentUri":{"type":"string","format":"uri","description":"ID of content introducing this node. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"context":{"$ref":"#/components/schemas/TaxonomyContext","description":"The context object selected when fetching node"},"contextId":{"type":"string","description":"An id unique for this context."},"contextids":{"type":"array","description":"A list of all contextids this node has ever had","items":{"type":"string"},"uniqueItems":true},"contexts":{"type":"array","description":"A list of all contexts this node is part of","items":{"$ref":"#/components/schemas/TaxonomyContext"}},"gradeAverage":{"$ref":"#/components/schemas/GradeAverage","description":"A number representing the average grade of all children nodes recursively."},"id":{"type":"string","format":"uri","description":"Node id","example":"urn:topic:234"},"isPrimary":{"type":"boolean"},"language":{"type":"string","description":"The language code for which name is returned","example":"nb"},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Metadata for entity. Read only."},"name":{"type":"string","description":"The possibly translated name of the node","example":"Trigonometry"},"nodeType":{"$ref":"#/components/schemas/NodeType","description":"The type of node","example":"resource"},"parentId":{"type":"string","format":"uri","description":"Parent id in the current context, null if none exists"},"path":{"type":"string","description":"The primary path for this node. Can be empty if no context","example":"/subject:1/topic:1"},"paths":{"type":"array","description":"List of all paths to this node","items":{"type":"string"}},"qualityEvaluation":{"$ref":"#/components/schemas/QualityEvaluationDTO","description":"Quality evaluation of the article"},"rank":{"type":"integer","format":"int32","description":"The order in which to sort the node within it's level.","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceTypes":{"type":"array","description":"Resource type(s)","example":[{"id":"urn:resourcetype:1","name":"lecture"}],"items":{"$ref":"#/components/schemas/ResourceTypeWithConnection"},"uniqueItems":true},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"},"uniqueItems":true},"translations":{"type":"array","description":"All translations of this node","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true},"url":{"type":"string","description":"A pretty url based on name and context. Empty if no context."}},"required":["baseName","breadcrumbs","connectionId","contextids","contexts","id","isPrimary","language","metadata","name","nodeType","parentId","paths","rank","resourceTypes","supportedLanguages","translations"]},"NodeConnection":{"type":"object","properties":{"childId":{"type":"string","format":"uri","description":"Child id","example":"urn:topic:234"},"connectionType":{"$ref":"#/components/schemas/NodeConnectionType","description":"Connection type"},"id":{"type":"string","format":"uri","description":"Connection id","example":"urn:topic-has-subtopics:345"},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Metadata for entity. Read only."},"parentId":{"type":"string","format":"uri","description":"Parent id","example":"urn:topic:234"},"primary":{"type":"boolean","description":"Is this connection primary","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which subtopic is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}},"required":["childId","connectionType","id","metadata","parentId","primary","rank"]},"NodeConnectionPOST":{"type":"object","description":"The new connection","properties":{"childId":{"type":"string","format":"uri","description":"Child id","example":"urn:topic:234"},"connectionType":{"$ref":"#/components/schemas/NodeConnectionType","default":"BRANCH","description":"Connection type","example":"BRANCH"},"parentId":{"type":"string","format":"uri","example":"urn:topic:234","title":"Parent id"},"primary":{"type":"boolean","description":"If this connection is primary.","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which to sort the child for the parent","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}},"required":["childId","parentId"]},"NodeConnectionPUT":{"type":"object","description":"The updated connection","properties":{"primary":{"type":"boolean","description":"If this connection is primary.","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which subtopic is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}}},"NodeConnectionType":{"type":"string","enum":["BRANCH","LINK"]},"NodePostPut":{"type":"object","description":"The new node","properties":{"contentUri":{"type":"string","format":"uri","description":"ID of content introducing this node. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"context":{"type":"boolean","description":"The node is the root in a context. Default is false. Only used if present."},"language":{"type":"string","description":"The language used at create time. Used to set default translation.","example":"nb"},"name":{"type":"string","description":"The name of the node. Required on create.","example":"Trigonometry"},"nodeId":{"type":"string","description":"If specified, set the node_id to this value. If omitted, an uuid will be assigned automatically."},"nodeType":{"$ref":"#/components/schemas/NodeType","description":"Type of node.","example":"topic"},"qualityEvaluation":{"type":["object","null"],"$ref":"#/components/schemas/QualityEvaluationDTO","description":"The quality evaluation of the node. Consist of a score from 1 to 5 and a comment. Can be null to remove existing evaluation."},"root":{"type":"boolean","deprecated":true,"description":"The node is a root node. Default is false. Only used if present."},"visible":{"type":"boolean","description":"The node is visible. Default is true."}}},"NodeResource":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Node resource connection id","example":"urn:node-resource:123"},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Metadata for entity. Read only."},"nodeId":{"type":"string","format":"uri","description":"Node id","example":"urn:node:345"},"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the resource is sorted for the node","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceId":{"type":"string","format":"uri","description":"Resource id","example":"urn:resource:345"}},"required":["id","metadata","nodeId","primary","rank","resourceId"]},"NodeResourcePOST":{"type":"object","description":"new node/resource connection ","properties":{"nodeId":{"type":"string","format":"uri","description":"Node id","example":"urn:node:345"},"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which resource is sorted for the node","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceId":{"type":"string","format":"uri","description":"Resource id","example":"urn:resource:345"}},"required":["nodeId","resourceId"]},"NodeResourcePUT":{"type":"object","description":"Updated node/resource connection","properties":{"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the resource will be sorted for this node.","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}}},"NodeSearchBody":{"type":"object","properties":{"contentUris":{"type":"array","description":"ContentURIs to fetch for query","items":{"type":"string"}},"customFields":{"type":"object","additionalProperties":{"type":"string"},"description":"If specified, the search result will be filtered by whether they include the key,value combination provided. If more than one provided only one will be required (OR)"},"filterProgrammes":{"type":"boolean","description":"Filter out programme contexts"},"ids":{"type":"array","description":"Ids to fetch for query","items":{"type":"string"}},"includeContexts":{"type":"boolean","description":"Include all contexts"},"language":{"type":"string","description":"ISO-639-1 language code","example":"nb"},"nodeType":{"type":"array","description":"Filter by nodeType","items":{"$ref":"#/components/schemas/NodeType"}},"page":{"type":"integer","format":"int32","description":"Which page to fetch"},"pageSize":{"type":"integer","format":"int32","description":"How many results to return per page"},"parentId":{"type":"string","format":"uri","description":"Id to parent id in context."},"query":{"type":"string","description":"Query to search names"},"rootId":{"type":"string","format":"uri","description":"Id to root id in context."}}},"NodeType":{"type":"string","enum":["NODE","SUBJECT","TOPIC","CASE","RESOURCE","PROGRAMME"]},"NodeWithParents":{"type":"object","properties":{"baseName":{"type":"string","description":"The stored name of the node","example":"Trigonometry"},"breadcrumbs":{"type":"array","description":"List of names in the path","items":{"type":"string"}},"contentUri":{"type":"string","format":"uri","description":"ID of content introducing this node. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"context":{"$ref":"#/components/schemas/TaxonomyContext","description":"The context object selected when fetching node"},"contextId":{"type":"string","description":"An id unique for this context."},"contextids":{"type":"array","description":"A list of all contextids this node has ever had","items":{"type":"string"},"uniqueItems":true},"contexts":{"type":"array","description":"A list of all contexts this node is part of","items":{"$ref":"#/components/schemas/TaxonomyContext"}},"gradeAverage":{"$ref":"#/components/schemas/GradeAverage","description":"A number representing the average grade of all children nodes recursively."},"id":{"type":"string","format":"uri","description":"Node id","example":"urn:topic:234"},"language":{"type":"string","description":"The language code for which name is returned","example":"nb"},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Metadata for entity. Read only."},"name":{"type":"string","description":"The possibly translated name of the node","example":"Trigonometry"},"nodeType":{"$ref":"#/components/schemas/NodeType","description":"The type of node","example":"resource"},"parents":{"type":"array","description":"Parent topology nodes and whether or not connection type is primary","example":[{"id":"urn:topic:1:181900","name":"I dyrehagen","contentUri":"urn:article:6662","path":"/subject:2/topic:1:181900","primary":"true"}],"items":{"$ref":"#/components/schemas/NodeChild"},"uniqueItems":true},"path":{"type":"string","description":"The primary path for this node. Can be empty if no context","example":"/subject:1/topic:1"},"paths":{"type":"array","description":"List of all paths to this node","items":{"type":"string"}},"qualityEvaluation":{"$ref":"#/components/schemas/QualityEvaluationDTO","description":"Quality evaluation of the article"},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceTypes":{"type":"array","description":"Resource type(s)","example":[{"id":"urn:resourcetype:1","name":"lecture"}],"items":{"$ref":"#/components/schemas/ResourceTypeWithConnection"},"uniqueItems":true},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"},"uniqueItems":true},"translations":{"type":"array","description":"All translations of this node","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true},"url":{"type":"string","description":"A pretty url based on name and context. Empty if no context."}},"required":["parents"]},"QualityEvaluationDTO":{"type":"object","properties":{"grade":{"$ref":"#/components/schemas/Grade","description":"The grade (1-5) of the article"},"note":{"type":"string","description":"Note explaining the score"}},"required":["grade"]},"Relevance":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Specifies if node is core or supplementary","example":"urn:relevance:core"},"name":{"type":"string","description":"The name of the relevance","example":"Core"},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"},"uniqueItems":true},"translations":{"type":"array","description":"All translations of this relevance","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true}},"required":["id","name","supportedLanguages","translations"]},"ResolvedOldUrl":{"type":"object","properties":{"path":{"type":"string","description":"URL path for resource","example":"'/subject:1/topic:12/resource:12'"}},"required":["path"]},"ResolvedUrl":{"type":"object","properties":{"contentUri":{"type":"string","format":"uri","description":"The ID of this element in the system where the content is stored. This ID should be of the form 'urn:<system>:<id>', where <system> is a short identifier for the system, and <id> is the id of this content in that system.","example":"urn:article:1"},"exactMatch":{"type":"boolean","description":"Is this an exact match for the provided path? False if this is another path to the same resource."},"id":{"type":"string","format":"uri","description":"ID of the element referred to by the given path","example":"urn:resource:1"},"name":{"type":"string","description":"Element name. For performance reasons, this name is for informational purposes only. To get a translated name, please fetch the resolved resource using its rest resource.","example":"Basic physics"},"parents":{"type":"array","description":"Parent elements of the resolved element. The first element is the parent, the second is the grandparent, etc.","items":{"type":"string","format":"uri"}},"path":{"type":"string","description":"URL path for resource","example":"'/subject:1/topic:12/resource:12'"},"url":{"type":"string","description":"Pretty url resource","example":"'/r/subject-name/resource-name/hash'"}},"required":["contentUri","exactMatch","id","name","parents","path","url"]},"ResourcePOST":{"type":"object","description":"Object containing contentUri. Other values are ignored.","properties":{"contentUri":{"type":"string","format":"uri","description":"The ID of this resource in the system where the content is stored. This ID should be of the form 'urn:<system>:<id>', where <system> is a short identifier for the system, and <id> is the id of this content in that system.","example":"urn:article:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:resource: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:resource:2"},"name":{"type":"string","description":"The name of the resource","example":"Introduction to integration"}},"required":["contentUri","name"]},"ResourcePUT":{"type":"object","description":"the new resource","properties":{"contentUri":{"type":"string","format":"uri","description":"The ID of this resource in the system where the content is stored. This ID should be of the form 'urn:<system>:<id>', where <system> is a short identifier for the system, and <id> is the id of this content in that system.","example":"urn:article:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:resource: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:resource:2"},"name":{"type":"string","description":"The name of the resource","example":"Introduction to integration"}},"required":["contentUri","name"]},"ResourceResourceType":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Resource to resource type connection id","example":"urn:resource-has-resourcetypes:12"},"resourceId":{"type":"string","format":"uri","description":"Resource type id","example":"urn:resource:123"},"resourceTypeId":{"type":"string","format":"uri","description":"Resource type id","example":"urn:resourcetype:234"}},"required":["id","resourceId","resourceTypeId"]},"ResourceResourceTypePOST":{"type":"object","description":"The new resource/resource type connection","properties":{"resourceId":{"type":"string","format":"uri","description":"Resource id","example":"urn:resource:123"},"resourceTypeId":{"type":"string","format":"uri","description":"Resource type id","example":"urn:resourcetype:234"}},"required":["resourceId","resourceTypeId"]},"ResourceType":{"type":"object","properties":{"id":{"type":"string","format":"uri","example":"urn:resourcetype:1"},"name":{"type":"string","description":"The name of the resource type","example":"Lecture"},"subtypes":{"type":"array","description":"Sub resource types","items":{"$ref":"#/components/schemas/ResourceType"}},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"},"uniqueItems":true},"translations":{"type":"array","description":"All translations of this resource type","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true}},"required":["id","name","supportedLanguages","translations"]},"ResourceTypePUT":{"type":"object","description":"The new resource type","properties":{"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:resourcetype: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:resourcetype:1"},"name":{"type":"string","description":"The name of the resource type","example":"Lecture"},"order":{"type":"integer","format":"int32","description":"Order in which the resource type should be sorted among its siblings"},"parentId":{"type":"string","format":"uri","description":"If specified, the new resource type will be a child of the mentioned resource type."}},"required":["id","name","parentId"]},"ResourceTypeWithConnection":{"type":"object","properties":{"connectionId":{"type":"string","format":"uri","description":"The id of the resource resource type connection","example":"urn:resource-resourcetype:1"},"id":{"type":"string","format":"uri","example":"urn:resourcetype:2"},"name":{"type":"string","description":"The name of the resource type","example":"Lecture"},"order":{"type":"integer","format":"int32","description":"Internal order of the resource types"},"parentId":{"type":"string","format":"uri","example":"urn:resourcetype:1"},"supportedLanguages":{"type":"array","description":"List of language codes supported by translations","items":{"type":"string"}},"translations":{"type":"array","description":"All translations of this resource type","items":{"$ref":"#/components/schemas/Translation"},"uniqueItems":true}},"required":["connectionId","id","name","supportedLanguages","translations"]},"SearchResult":{"type":"object","properties":{"page":{"type":"integer","format":"int32","example":"The page number"},"pageSize":{"type":"integer","format":"int32","example":"The page size"},"results":{"type":"array","example":"List of search results","items":{"$ref":"#/components/schemas/Node"}},"totalCount":{"type":"integer","format":"int64","example":"Total search result count, useful for fetching multiple pages"}},"required":["page","pageSize","results","totalCount"]},"SearchableTaxonomyResourceType":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"object","additionalProperties":{"type":"string"}},"order":{"type":"integer","format":"int32"},"parentId":{"type":"string"}},"required":["id","name"]},"SubjectPOST":{"type":"object","description":"The updated subject. Fields not included will be set to null.","properties":{"contentUri":{"type":"string","format":"uri","description":"ID of frontpage connected to this subject. Must be a valid URI, but preferably not a URL.","example":"urn:frontpage:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:subject: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:subject:1"},"name":{"type":"string","description":"The name of the subject","example":"Mathematics"}},"required":["name"]},"SubjectPUT":{"type":"object","description":"The new subject","properties":{"contentUri":{"type":"string","format":"uri","description":"ID of frontpage connected to this subject. Must be a valid URI, but preferably not a URL.","example":"urn:frontpage:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:subject: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:subject:1"},"name":{"type":"string","description":"The name of the subject","example":"Mathematics"}},"required":["name"]},"SubjectTopic":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Connection id","example":"urn:subject-has-topics:34"},"primary":{"type":"boolean","description":"primary","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the topic is sorted under the subject","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"subjectid":{"type":"string","format":"uri","description":"Subject id","example":"urn:subject:123"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:345"}},"required":["id","primary","rank","subjectid","topicid"]},"SubjectTopicPOST":{"type":"object","description":"The subject and topic getting connected.","properties":{"primary":{"type":"boolean","description":"Backwards compatibility: Always true, ignored on insert/update.","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the topic should be sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"subjectid":{"type":"string","format":"uri","description":"Subject id","example":"urn:subject:123"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:234"}},"required":["subjectid","topicid"]},"SubjectTopicPUT":{"type":"object","description":"updated subject/topic connection","properties":{"primary":{"type":"boolean","description":"If true, set this subject as the primary subject for this topic. This will replace any other primary subject for this topic. You must have one primary subject, so it is not allowed to set the currently primary subject to not be primary any more.","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the topic should be sorted for the subject","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}}},"TaxonomyContext":{"type":"object","properties":{"breadcrumbs":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"A breadcrumb of the names of the context's parents"},"connectionId":{"type":"string","description":"The id of the parent connection object"},"contextId":{"type":"string","description":"Unique id of context based on root + parent connection"},"contextType":{"type":"string","description":"Whether a 'standard'-article, 'topic-article'-article or a 'learningpath'"},"id":{"type":"string","format":"uri","description":"The publicId of the node connected via content-uri"},"isActive":{"type":"boolean","description":"Whether the parent connection is marked as active"},"isArchived":{"type":"boolean","description":"Whether the root is marked as archived"},"isPrimary":{"type":"boolean","description":"Whether the parent connection is primary or not"},"isVisible":{"type":"boolean","description":"Whether the parent connection is visible or not"},"parentContextIds":{"type":"array","description":"List of all parent contextIds","items":{"type":"string"}},"parentIds":{"type":"array","description":"List of all parent ids","items":{"type":"string","format":"uri"}},"parents":{"type":"array","description":"List of all parents to this context. Empty if node is fetched as child","items":{"$ref":"#/components/schemas/TaxonomyCrumb"}},"path":{"type":"string","description":"The context path"},"publicId":{"type":"string","format":"uri","deprecated":true,"description":"The publicId of the node connected via content-uri"},"rank":{"type":"integer","format":"int32","description":"The rank of the parent connection object"},"relevance":{"type":"object","additionalProperties":{"type":"string"},"description":"Name of the relevance of the parent connection"},"relevanceId":{"type":"string","format":"uri","description":"Id of the relevance of the parent connection"},"resourceTypes":{"type":"array","description":"Resource-types of the node","items":{"$ref":"#/components/schemas/SearchableTaxonomyResourceType"}},"root":{"type":"object","additionalProperties":{"type":"string"},"description":"The name of the root parent of the context"},"rootId":{"type":"string","format":"uri","description":"The publicId of the root parent of the context"},"url":{"type":"string","description":"Pretty-url of this particular context"}},"required":["breadcrumbs","connectionId","contextId","id","isActive","isArchived","isPrimary","isVisible","parentContextIds","parentIds","parents","path","publicId","rank","relevance","relevanceId","resourceTypes","root","rootId","url"]},"TaxonomyCrumb":{"type":"object","properties":{"contextId":{"type":"string","description":"Unique id of context based on root + parent connection"},"id":{"type":"string","format":"uri","description":"The publicId of the node"},"name":{"type":"object","additionalProperties":{"type":"string"},"description":"The name of the node"},"path":{"type":"string","description":"The context path"},"url":{"type":"string","description":"The context url"}},"required":["contextId","id","name","path","url"]},"TopicPOST":{"type":"object","description":"The new topic","properties":{"contentUri":{"type":"string","format":"uri","description":"ID of article introducing this topic. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:topic: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:topic:1"},"name":{"type":"string","description":"The name of the topic","example":"Trigonometry"}},"required":["contentUri","name"]},"TopicPostPut":{"type":"object","description":"The updated topic. Fields not included will be set to null.","properties":{"contentUri":{"type":"string","format":"uri","description":"ID of article introducing this topic. Must be a valid URI, but preferably not a URL.","example":"urn:article:1"},"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:topic: and be a valid URI. If omitted, an id will be assigned automatically.","example":"urn:topic:1"},"name":{"type":"string","description":"The name of the topic","example":"Trigonometry"}},"required":["contentUri","name"]},"TopicResource":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Topic resource connection id","example":"urn:topic-has-resources:123"},"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the resource is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceId":{"type":"string","format":"uri","description":"Resource id","example":"urn:resource:345"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:345"}},"required":["id","primary","rank","resourceId","topicid"]},"TopicResourcePOST":{"type":"object","description":"new topic/resource connection ","properties":{"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which resource is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"resourceId":{"type":"string","format":"uri","description":"Resource id","example":"urn:resource:345"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:345"}},"required":["resourceId","topicid"]},"TopicResourcePUT":{"type":"object","description":"Updated topic/resource connection","properties":{"primary":{"type":"boolean","description":"Primary connection","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which the resource will be sorted for this topic.","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}}},"TopicSubtopic":{"type":"object","properties":{"id":{"type":"string","format":"uri","description":"Connection id","example":"urn:topic-has-subtopics:345"},"primary":{"type":"boolean","description":"Backwards compatibility: Always true. Ignored on insert/update","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which subtopic is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"subtopicid":{"type":"string","format":"uri","description":"Subtopic id","example":"urn:topic:234"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:234"}},"required":["id","primary","rank","subtopicid","topicid"]},"TopicSubtopicPOST":{"type":"object","description":"The new connection","properties":{"primary":{"type":"boolean","description":"Is this connection primary","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which to sort the subtopic for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"},"subtopicid":{"type":"string","format":"uri","description":"Subtopic id","example":"urn:topic:234"},"topicid":{"type":"string","format":"uri","description":"Topic id","example":"urn:topic:234"}},"required":["subtopicid","topicid"]},"TopicSubtopicPUT":{"type":"object","description":"The updated connection","properties":{"primary":{"type":"boolean","description":"Is this connection primary","example":true},"rank":{"type":"integer","format":"int32","description":"Order in which subtopic is sorted for the topic","example":1},"relevanceId":{"type":"string","format":"uri","description":"Relevance id","example":"urn:relevance:core"}}},"Translation":{"type":"object","properties":{"language":{"type":"string","description":"ISO 639-1 language code","example":"en"},"name":{"type":"string","description":"The translated name of the node","example":"Trigonometry"}},"required":["language","name"]},"TranslationPUT":{"type":"object","description":"The new or updated translation","properties":{"name":{"type":"string","description":"The translated name of the element. Used wherever translated texts are used.","example":"Trigonometry"}},"required":["name"]},"UrlMapping":{"type":"object","properties":{"nodeId":{"type":"string","description":"Node URN for resource in new system","example":"urn:topic:1:183926"},"subjectId":{"type":"string","description":"Subject URN for resource in new system (optional)","example":"urn:subject:5"},"url":{"type":"string","description":"URL for resource in old system","example":"ndla.no/nb/node/183926?fag=127013"}},"required":["nodeId","subjectId","url"]},"Version":{"type":"object","properties":{"archived":{"type":"string","format":"date-time","description":"Timestamp for when version was archived"},"created":{"type":"string","format":"date-time","description":"Timestamp for when version was created"},"hash":{"type":"string","description":"Unique hash for the version"},"id":{"type":"string","format":"uri","example":"urn:version:1"},"locked":{"type":"boolean","description":"Is the version locked"},"name":{"type":"string","description":"Name for the version"},"published":{"type":"string","format":"date-time","description":"Timestamp for when version was published"},"versionType":{"$ref":"#/components/schemas/VersionType","example":"BETA"}},"required":["created","hash","id","locked","name","versionType"]},"VersionPostPut":{"type":"object","description":"The new version","properties":{"id":{"type":"string","format":"uri","description":"If specified, set the id to this value. Must start with urn:version: and be a valid URI. If ommitted, an id will be assigned automatically.","example":"urn:version:1"},"locked":{"type":"boolean","description":"If specified, set the locked property to this value."},"name":{"type":"string","description":"If specified, set the name to this value.","example":"Beta 2022"}},"required":["name"]},"VersionType":{"type":"string","enum":["BETA","PUBLISHED","ARCHIVED"]}},"securitySchemes":{"oauth":{"flows":{"implicit":{"authorizationUrl":"https://ndla-test.eu.auth0.com/authorize"}},"type":"oauth2"}}}}