[{"data":1,"prerenderedAt":2062},["ShallowReactive",2],{"\u002Ftools\u002Fid_manager\u002Fdocs\u002Flinksendpoints\u002F":3},{"id":4,"title":5,"body":6,"description":86,"extension":2050,"isRevision":2051,"lastUpdated":2052,"meta":2053,"navigation":2054,"path":2055,"revision":2056,"seo":2057,"slug":2058,"stem":2059,"subtitle":2060,"__hash__":2061},"docs\u002Fdocs\u002Fid_manager\u002Flinksendpoints\u002Findex.md","ID Management Service",{"type":7,"value":8,"toc":2041},"minimark",[9,14,18,23,33,44,52,58,64,69,77,80,348,352,360,364,371,374,385,388,456,459,466,477,480,483,486,493,501,507,511,515,519,522,530,533,539,553,560,563,570,573,576,579,584,591,933,941,1105,1109,1116,1196,1199,1279,1283,1290,1293,1297,1300,1303,1309,1316,1320,1325,1328,1340,1425,1428,1434,1440,1444,1447,1453,1457,1460,1463,1478,1481,1484,1488,1491,1499,1505,1511,1516,1521,1524,1527,1596,1603,1606,1662,1665,1758,1762,1765,1775,1778,1789,1792,1796,1802,1805,1811,1814,1817,1824,1832,1839,1843,1848,1851,1857,1861,1921,1928,1932,2022,2037],[10,11,13],"h2",{"id":12},"api-links-endpoints","API - Links endpoints",[15,16,17],"p",{},"Used for querying, creating and updating links in the system.",[19,20,22],"h3",{"id":21},"get-information-for-a-link","Get information for a link",[15,24,25,26,32],{},"If a valid id is specified in the URL, this returns a JSON-LD response containing the link (a Web Annotation Model Annotation object - ",[27,28,29],"a",{"href":29,"rel":30},"https:\u002F\u002Fwww.w3.org\u002FTR\u002Fannotation-vocab\u002F#annotation",[31],"nofollow",")",[15,34,35,39,40],{},[36,37,38],"strong",{},"URL"," : ",[41,42,43],"code",{},"\u002Flinks\u002F{LINK UUID}",[15,45,46,39,49],{},[36,47,48],{},"Method",[41,50,51],{},"GET",[15,53,54,57],{},[36,55,56],{},"Auth required"," : No",[15,59,60,63],{},[36,61,62],{},"HTML\u002FJSON"," : Both",[65,66,68],"h4",{"id":67},"success-response","Success Response",[15,70,71,39,74],{},[36,72,73],{},"Code",[41,75,76],{},"200 Okay",[15,78,79],{},"Example:",[81,82,87],"pre",{"className":83,"code":84,"language":85,"meta":86,"style":86},"language-json shiki shiki-themes github-light github-dark","{\n  \"@context\": \"http:\u002F\u002Fwww.w3.org\u002Fns\u002Fanno.jsonld\",\n  \"body\": {\n    \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Faspace\",\n    \"id\": \"urn:getty-local:repositories\u002F3\u002Fresources\u002F1150\",\n    \"format\": null,\n  },\n  \"created\": \"2020-07-07T17:44:19Z\",\n  \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F883310f6-d759-4ec7-8d48-cb77e1c15882\",\n  \"label\": \"testgroup\",\n  \"dcterms:title\": \"Test Title\",\n  \"dcterms:alternative\": \"Test Reverse Title\",\n  \"modified\": \"2020-07-07T17:44:19Z\",\n  \"creator\": {\n    \"name\": \"Test User\"\n  },\n  \"motivation\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-accno\",\n  \"target\": {\n    \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Forganizations\u002FGRI\",\n    \"id\": \"urn:getty-local:2003.M.46\",\n    \"format\": null,\n  },\n  \"type\": \"Annotation\"\n}\n","json","",[41,88,89,98,115,124,137,150,163,169,182,195,208,221,234,246,254,265,270,283,291,303,315,326,331,342],{"__ignoreMap":86},[90,91,94],"span",{"class":92,"line":93},"line",1,[90,95,97],{"class":96},"sVt8B","{\n",[90,99,101,105,108,112],{"class":92,"line":100},2,[90,102,104],{"class":103},"sj4cs","  \"@context\"",[90,106,107],{"class":96},": ",[90,109,111],{"class":110},"sZZnC","\"http:\u002F\u002Fwww.w3.org\u002Fns\u002Fanno.jsonld\"",[90,113,114],{"class":96},",\n",[90,116,118,121],{"class":92,"line":117},3,[90,119,120],{"class":103},"  \"body\"",[90,122,123],{"class":96},": {\n",[90,125,127,130,132,135],{"class":92,"line":126},4,[90,128,129],{"class":103},"    \"generator\"",[90,131,107],{"class":96},[90,133,134],{"class":110},"\"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Faspace\"",[90,136,114],{"class":96},[90,138,140,143,145,148],{"class":92,"line":139},5,[90,141,142],{"class":103},"    \"id\"",[90,144,107],{"class":96},[90,146,147],{"class":110},"\"urn:getty-local:repositories\u002F3\u002Fresources\u002F1150\"",[90,149,114],{"class":96},[90,151,153,156,158,161],{"class":92,"line":152},6,[90,154,155],{"class":103},"    \"format\"",[90,157,107],{"class":96},[90,159,160],{"class":103},"null",[90,162,114],{"class":96},[90,164,166],{"class":92,"line":165},7,[90,167,168],{"class":96},"  },\n",[90,170,172,175,177,180],{"class":92,"line":171},8,[90,173,174],{"class":103},"  \"created\"",[90,176,107],{"class":96},[90,178,179],{"class":110},"\"2020-07-07T17:44:19Z\"",[90,181,114],{"class":96},[90,183,185,188,190,193],{"class":92,"line":184},9,[90,186,187],{"class":103},"  \"id\"",[90,189,107],{"class":96},[90,191,192],{"class":110},"\"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F883310f6-d759-4ec7-8d48-cb77e1c15882\"",[90,194,114],{"class":96},[90,196,198,201,203,206],{"class":92,"line":197},10,[90,199,200],{"class":103},"  \"label\"",[90,202,107],{"class":96},[90,204,205],{"class":110},"\"testgroup\"",[90,207,114],{"class":96},[90,209,211,214,216,219],{"class":92,"line":210},11,[90,212,213],{"class":103},"  \"dcterms:title\"",[90,215,107],{"class":96},[90,217,218],{"class":110},"\"Test Title\"",[90,220,114],{"class":96},[90,222,224,227,229,232],{"class":92,"line":223},12,[90,225,226],{"class":103},"  \"dcterms:alternative\"",[90,228,107],{"class":96},[90,230,231],{"class":110},"\"Test Reverse Title\"",[90,233,114],{"class":96},[90,235,237,240,242,244],{"class":92,"line":236},13,[90,238,239],{"class":103},"  \"modified\"",[90,241,107],{"class":96},[90,243,179],{"class":110},[90,245,114],{"class":96},[90,247,249,252],{"class":92,"line":248},14,[90,250,251],{"class":103},"  \"creator\"",[90,253,123],{"class":96},[90,255,257,260,262],{"class":92,"line":256},15,[90,258,259],{"class":103},"    \"name\"",[90,261,107],{"class":96},[90,263,264],{"class":110},"\"Test User\"\n",[90,266,268],{"class":92,"line":267},16,[90,269,168],{"class":96},[90,271,273,276,278,281],{"class":92,"line":272},17,[90,274,275],{"class":103},"  \"motivation\"",[90,277,107],{"class":96},[90,279,280],{"class":110},"\"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-accno\"",[90,282,114],{"class":96},[90,284,286,289],{"class":92,"line":285},18,[90,287,288],{"class":103},"  \"target\"",[90,290,123],{"class":96},[90,292,294,296,298,301],{"class":92,"line":293},19,[90,295,129],{"class":103},[90,297,107],{"class":96},[90,299,300],{"class":110},"\"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Forganizations\u002FGRI\"",[90,302,114],{"class":96},[90,304,306,308,310,313],{"class":92,"line":305},20,[90,307,142],{"class":103},[90,309,107],{"class":96},[90,311,312],{"class":110},"\"urn:getty-local:2003.M.46\"",[90,314,114],{"class":96},[90,316,318,320,322,324],{"class":92,"line":317},21,[90,319,155],{"class":103},[90,321,107],{"class":96},[90,323,160],{"class":103},[90,325,114],{"class":96},[90,327,329],{"class":92,"line":328},22,[90,330,168],{"class":96},[90,332,334,337,339],{"class":92,"line":333},23,[90,335,336],{"class":103},"  \"type\"",[90,338,107],{"class":96},[90,340,341],{"class":110},"\"Annotation\"\n",[90,343,345],{"class":92,"line":344},24,[90,346,347],{"class":96},"}\n",[65,349,351],{"id":350},"error-responses","Error Responses",[15,353,354,107,356,359],{},[36,355,73],{},[41,357,358],{},"404"," - if the link does not exist",[19,361,363],{"id":362},"query-for-a-set-of-links-get-params","Query for a set of links (GET Params)",[15,365,366,367,370],{},"This endpoint supports querying using simple GET url-encoded parameters. There is another endpoint ",[41,368,369],{},"\u002Fquery\u002F"," (see below) which supports queries using JSON (which makes it easy to specify multiple ids for some fields).",[15,372,373],{},"(Returns a JSON-LD AnnotationCollection\u002FAnnotationPage type response.)",[15,375,376,377,380,381,32],{},"If page is not specified, this will respond with an ",[41,378,379],{},"AnnotationCollection"," response that embeds the first page of results in the \"first\" property. (context for the WebAnnotation response standard: ",[27,382,383],{"href":383,"rel":384},"http:\u002F\u002Fwww.w3.org\u002Fns\u002Fanno.jsonld",[31],[15,386,387],{},"The request can be filtered by passing GET parameters:",[389,390,391,401,407,413,419,425,431,450],"ul",{},[392,393,394,397,398,32],"li",{},[41,395,396],{},"target_id"," The identifier URI for the target (this parameter can be included multiple times in a single request eg ",[41,399,400],{},"target_id=...&target_id=...&target_id=...",[392,402,403,406],{},[41,404,405],{},"body_id"," The identifier URI for the body (this parameter can be included multiple times in a single request)",[392,408,409,412],{},[41,410,411],{},"any_id"," The identifier must be in EITHER the body id OR the target ID. This is the most useful parameter to use when exploring what links involve a given URI.",[392,414,415,418],{},[41,416,417],{},"target_generator"," the generator for the target",[392,420,421,424],{},[41,422,423],{},"body_generator"," the generator for the body",[392,426,427,430],{},[41,428,429],{},"motivation"," The URI of the motivation (oa:linking, or subclass - full URI)",[392,432,433,436,437,440,441,443,444,446,447],{},[41,434,435],{},"group_id"," The ",[41,438,439],{},"label"," assigned to a link as its ",[41,442,435],{},". This is the ",[41,445,439],{}," in the ",[41,448,449],{},"Annotation",[392,451,452,455],{},[41,453,454],{},"creator_name"," The name of the agent\u002Fsystem that created the link",[15,457,458],{},"Note that these are exact filters and the results will only include links that match each parameter given exactly.",[15,460,461,462],{},"Generator is being used from the Lifecycle information in the Annotation model. It is not strictly an intended fit for this, but the target and body IDs are not readily expressible as URIs. There are many use cases to filter by generator however, as this encodes the source of this identifier. ",[27,463,464],{"href":464,"rel":465},"https:\u002F\u002Fwww.w3.org\u002FTR\u002Fannotation-model\u002F#lifecycle-information",[31],[15,467,468,469,472,473,476],{},"These filters will be combined into the final query, and the response will be the intersection of all of the applied filters. The items returned will satisfy all of the filters provided. The exception is when multiple values have been supplied as a target_id or body_id, the returned links only have to match one of these values for each term. Eg if multiple ids for target_id were in the request: ",[41,470,471],{},"?target_id=ID1&target_id=ID2... target_id=ID10",", then the response will be all the links that have any one of these IDs as its target_id. Further parameters will filter this list as a whole. Adding a ",[41,474,475],{},"motivation=..."," will filter out any links that do not have that motivation, for any of the links that match the list of target_ids given.",[15,478,479],{},"What filters were applied will be in the \"label\" of the AnnotationCollection\u002FPage objects as a convenience. If a Generator URI or Motivation URI is not found in the system, it will NOT be included in the filter and it will return an HTTP 400 error response.",[15,481,482],{},"The amount of entries returned in the list is limited by a configuration parameter LINK_PAGE_LIMIT which is by default set to 500.",[15,484,485],{},"Example JSON body for the AnnotationCollection for a filtered list of links:",[15,487,488,39,490],{},[36,489,38],{},[41,491,492],{},"\u002Flinks\u002F",[15,494,495,39,497,500],{},[36,496,38],{},[41,498,499],{},"\u002Flinks\u002Fpage\u002F{page number}"," - pagination API of a query that exceeds the page response limit.",[15,502,503,39,505],{},[36,504,48],{},[41,506,51],{},[15,508,509,57],{},[36,510,56],{},[15,512,513,63],{},[36,514,62],{},[65,516,518],{"id":517},"data-requirements","Data requirements",[15,520,521],{},"GET parameter values MUST be URL encoded.",[81,523,528],{"className":524,"code":526,"language":527},[525],"language-text","GET \u002Flinks?any_id=urn%3Agetty-local%3Atms%3Aobject%3Aid%2F61343\n","text",[41,529,526],{"__ignoreMap":86},[65,531,68],{"id":532},"success-response-1",[15,534,535,39,537],{},[36,536,73],{},[41,538,76],{},[15,540,541,542,546,547,552],{},"The JSON-LD response will be an ",[27,543,379],{"href":544,"rel":545},"https:\u002F\u002Fwww.w3.org\u002FTR\u002Fannotation-protocol\u002F#container-representations",[31]," object, which comprises a set of ",[27,548,551],{"href":549,"rel":550},"https:\u002F\u002Fwww.w3.org\u002FTR\u002Fannotation-protocol\u002F#annotation-pages",[31],"AnnotationPage"," object containing a set of links. This is to allow pagination of very large sets of data (10,000 links or more) which would not be feasible to return in one response.",[15,554,555,556,559],{},"As the list of links is the most important use of this endpoint, the first AnnotationPage object is embedded in the ",[27,557,379],{"href":544,"rel":558},[31]," response. This provides the first page of links within the initial response to the end user, without requiring them to make a second request to get the first page of responses. Within normal use-cases, the set of links will fit comfortably within a single page so the aim with this is for it to be a single request.",[15,561,562],{},"The AnnotationCollection responses will always have an embedded “first” property which contains the core part of first AnnotationPage response.",[15,564,565,566,569],{},"The AnnotationCollection or AnnotationPage response will only include a \"next\" property if there is another page of results to return, and this will hold the value of the URI to that page. If it is not present, then all of the results will be contained in the ",[41,567,568],{},"'first'"," value.",[15,571,572],{},"The responses are queries on a live database and they are stateless queries.  The responses from the URIs are not stable, and will change when the underlining data changes.",[15,574,575],{},"(Note that LDP container accept requests to shape the response are not supported - the list of annotations will be given with full description in an AnnotationCollection as described above.)",[15,577,578],{},"Example responses:",[580,581,583],"h5",{"id":582},"an-unfiltered-query","An unfiltered query",[15,585,586,587,590],{},"This shows the response for an parameter-less query. It will attempt to show all of the links in the instance, presented in JSON-LD as a ",[27,588,379],{"href":544,"rel":589},[31],". This unfiltered response is not particularly useful as the system will contain millions of links in normal use.",[81,592,596],{"className":593,"code":594,"language":595,"meta":86,"style":86},"language-json5 shiki shiki-themes github-light github-dark","{\n  \"@context\": \"http:\u002F\u002Fwww.w3.org\u002Fns\u002Fanno.jsonld\",\n  \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F\",\n  \"label\": \"Collection of Link Annotations\",\n  \"last\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F10225\",\n  \"next\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F2\",\n  \"total\": 2044986,\n  \"type\": \"AnnotationCollection\"\n  \"first\": {\n    \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F1\",\n    \"items\": [\n      {\n        \"body\": {\n          \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Fgcis\",\n          \"id\": \"https:\u002F\u002Fmedia.getty.edu\u002Fiiif\u002Fimage\u002Fee8db855-5367-4932-9015-3e49f78aee53\",\n          \"format\": null\n        },\n        \"created\": \"2020-06-24T23:27:40Z\",\n        \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Ff5b9c890-ea30-4c32-8969-9a4ccc8c60e4\",\n        \"label\": \"testdata\",\n        \"dcterms:title\": \"Test Link\",\n        \"dcterms:alternative\": \"Test Reverse Link\",\n        \"creator\": {\n          \"name\": \"Test User\"\n        },\n        \"modified\": \"2020-06-24T23:27:40Z\",\n        \"motivation\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fiiif_image_of\",\n        \"target\": {\n          \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Fotmm\",\n          \"id\": \"urn:getty-local:8f1ea3128622c8d9d43a0f05d5b59864076e25c3\",\n          \"format\": null\n        },\n        \"type\": \"Annotation\"\n      },\n      \u002F\u002F ... RESULTS TRUNCATED ...\n      {\n        \"body\": {\n          \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Fgcis\",\n          \"id\": \"urn:getty-local:76104111-4bcd-4b23-b9ee-0af99da8c038\",\n          \"format\": null\n        },\n        \"created\": \"2020-06-25T00:46:21Z\",\n        \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Ff981c4bc-a9bb-4bc0-9a46-6a095af273e6\",\n        \"label\": \"newgroup\",\n        \"dcterms:title\": \"Test Title\",\n        \"dcterms:alternative\": \"Test Reverse Title\",\n        \"modified\": \"2020-06-25T00:46:21Z\",\n        \"creator\": {\n          \"name\": \"Test User\"\n        },\n        \"motivation\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fiiif_ap_collection_of\",\n        \"target\": {\n          \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Frosetta\",\n          \"id\": \"urn:getty-local:IE207628\",\n          \"format\": null\n        },\n        \"type\": \"Annotation\"\n      },\n    ],\n    \"startIndex\": 0,\n    \"type\": \"AnnotationPage\"\n  },\n}\n","json5",[41,597,598,602,607,612,617,622,627,632,637,642,647,652,657,662,667,672,677,682,687,692,697,702,707,712,717,722,728,734,740,746,752,757,762,768,774,780,785,790,795,801,806,811,817,823,829,835,841,847,852,857,862,868,873,879,885,890,895,900,905,911,917,923,928],{"__ignoreMap":86},[90,599,600],{"class":92,"line":93},[90,601,97],{},[90,603,604],{"class":92,"line":100},[90,605,606],{},"  \"@context\": \"http:\u002F\u002Fwww.w3.org\u002Fns\u002Fanno.jsonld\",\n",[90,608,609],{"class":92,"line":117},[90,610,611],{},"  \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F\",\n",[90,613,614],{"class":92,"line":126},[90,615,616],{},"  \"label\": \"Collection of Link Annotations\",\n",[90,618,619],{"class":92,"line":139},[90,620,621],{},"  \"last\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F10225\",\n",[90,623,624],{"class":92,"line":152},[90,625,626],{},"  \"next\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F2\",\n",[90,628,629],{"class":92,"line":165},[90,630,631],{},"  \"total\": 2044986,\n",[90,633,634],{"class":92,"line":171},[90,635,636],{},"  \"type\": \"AnnotationCollection\"\n",[90,638,639],{"class":92,"line":184},[90,640,641],{},"  \"first\": {\n",[90,643,644],{"class":92,"line":197},[90,645,646],{},"    \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F1\",\n",[90,648,649],{"class":92,"line":210},[90,650,651],{},"    \"items\": [\n",[90,653,654],{"class":92,"line":223},[90,655,656],{},"      {\n",[90,658,659],{"class":92,"line":236},[90,660,661],{},"        \"body\": {\n",[90,663,664],{"class":92,"line":248},[90,665,666],{},"          \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Fgcis\",\n",[90,668,669],{"class":92,"line":256},[90,670,671],{},"          \"id\": \"https:\u002F\u002Fmedia.getty.edu\u002Fiiif\u002Fimage\u002Fee8db855-5367-4932-9015-3e49f78aee53\",\n",[90,673,674],{"class":92,"line":267},[90,675,676],{},"          \"format\": null\n",[90,678,679],{"class":92,"line":272},[90,680,681],{},"        },\n",[90,683,684],{"class":92,"line":285},[90,685,686],{},"        \"created\": \"2020-06-24T23:27:40Z\",\n",[90,688,689],{"class":92,"line":293},[90,690,691],{},"        \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Ff5b9c890-ea30-4c32-8969-9a4ccc8c60e4\",\n",[90,693,694],{"class":92,"line":305},[90,695,696],{},"        \"label\": \"testdata\",\n",[90,698,699],{"class":92,"line":317},[90,700,701],{},"        \"dcterms:title\": \"Test Link\",\n",[90,703,704],{"class":92,"line":328},[90,705,706],{},"        \"dcterms:alternative\": \"Test Reverse Link\",\n",[90,708,709],{"class":92,"line":333},[90,710,711],{},"        \"creator\": {\n",[90,713,714],{"class":92,"line":344},[90,715,716],{},"          \"name\": \"Test User\"\n",[90,718,720],{"class":92,"line":719},25,[90,721,681],{},[90,723,725],{"class":92,"line":724},26,[90,726,727],{},"        \"modified\": \"2020-06-24T23:27:40Z\",\n",[90,729,731],{"class":92,"line":730},27,[90,732,733],{},"        \"motivation\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fiiif_image_of\",\n",[90,735,737],{"class":92,"line":736},28,[90,738,739],{},"        \"target\": {\n",[90,741,743],{"class":92,"line":742},29,[90,744,745],{},"          \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Fotmm\",\n",[90,747,749],{"class":92,"line":748},30,[90,750,751],{},"          \"id\": \"urn:getty-local:8f1ea3128622c8d9d43a0f05d5b59864076e25c3\",\n",[90,753,755],{"class":92,"line":754},31,[90,756,676],{},[90,758,760],{"class":92,"line":759},32,[90,761,681],{},[90,763,765],{"class":92,"line":764},33,[90,766,767],{},"        \"type\": \"Annotation\"\n",[90,769,771],{"class":92,"line":770},34,[90,772,773],{},"      },\n",[90,775,777],{"class":92,"line":776},35,[90,778,779],{},"      \u002F\u002F ... RESULTS TRUNCATED ...\n",[90,781,783],{"class":92,"line":782},36,[90,784,656],{},[90,786,788],{"class":92,"line":787},37,[90,789,661],{},[90,791,793],{"class":92,"line":792},38,[90,794,666],{},[90,796,798],{"class":92,"line":797},39,[90,799,800],{},"          \"id\": \"urn:getty-local:76104111-4bcd-4b23-b9ee-0af99da8c038\",\n",[90,802,804],{"class":92,"line":803},40,[90,805,676],{},[90,807,809],{"class":92,"line":808},41,[90,810,681],{},[90,812,814],{"class":92,"line":813},42,[90,815,816],{},"        \"created\": \"2020-06-25T00:46:21Z\",\n",[90,818,820],{"class":92,"line":819},43,[90,821,822],{},"        \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Ff981c4bc-a9bb-4bc0-9a46-6a095af273e6\",\n",[90,824,826],{"class":92,"line":825},44,[90,827,828],{},"        \"label\": \"newgroup\",\n",[90,830,832],{"class":92,"line":831},45,[90,833,834],{},"        \"dcterms:title\": \"Test Title\",\n",[90,836,838],{"class":92,"line":837},46,[90,839,840],{},"        \"dcterms:alternative\": \"Test Reverse Title\",\n",[90,842,844],{"class":92,"line":843},47,[90,845,846],{},"        \"modified\": \"2020-06-25T00:46:21Z\",\n",[90,848,850],{"class":92,"line":849},48,[90,851,711],{},[90,853,855],{"class":92,"line":854},49,[90,856,716],{},[90,858,860],{"class":92,"line":859},50,[90,861,681],{},[90,863,865],{"class":92,"line":864},51,[90,866,867],{},"        \"motivation\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fiiif_ap_collection_of\",\n",[90,869,871],{"class":92,"line":870},52,[90,872,739],{},[90,874,876],{"class":92,"line":875},53,[90,877,878],{},"          \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Frosetta\",\n",[90,880,882],{"class":92,"line":881},54,[90,883,884],{},"          \"id\": \"urn:getty-local:IE207628\",\n",[90,886,888],{"class":92,"line":887},55,[90,889,676],{},[90,891,893],{"class":92,"line":892},56,[90,894,681],{},[90,896,898],{"class":92,"line":897},57,[90,899,767],{},[90,901,903],{"class":92,"line":902},58,[90,904,773],{},[90,906,908],{"class":92,"line":907},59,[90,909,910],{},"    ],\n",[90,912,914],{"class":92,"line":913},60,[90,915,916],{},"    \"startIndex\": 0,\n",[90,918,920],{"class":92,"line":919},61,[90,921,922],{},"    \"type\": \"AnnotationPage\"\n",[90,924,926],{"class":92,"line":925},62,[90,927,168],{},[90,929,931],{"class":92,"line":930},63,[90,932,347],{},[15,934,935,936,940],{},"Resolving the 'next' URI \"",[27,937,938],{"href":938,"rel":939},"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F2",[31],"\" will result in a response that is a single AnnotationPage,",[81,942,944],{"className":593,"code":943,"language":595,"meta":86,"style":86},"{\n  \"@context\": \"http:\u002F\u002Fwww.w3.org\u002Fns\u002Fanno.jsonld\",\n  \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F2\",\n  \"items\": [\n    {\n      \"body\": {\n        \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Fgcis\",\n        \"id\": \"https:\u002F\u002Fmedia.getty.edu\u002Fiiif\u002Fmanifest\u002F5b2ecb8f-759a-4d2e-a5fc-057250657e84\"\n      },\n      \"created\": \"2020-06-25T01:14:55Z\",\n      \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F7e9dbc3d-e87c-4a1b-8673-8fa32c2bd3eb\",\n      \"label: \"testdata\",\n      \"modified\": \"2020-06-25T01:14:55Z\",\n      \"motivation\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fiiif_manifest_of\",\n      \"target\": {\n        \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Ftms\",\n        \"id\": \"urn:getty-local:8132\"\n      },\n      \"type\": \"Annotation\"\n    },\n    \u002F\u002F ... RESULTS TRUNCATED ...\n  ],\n  \"label\": \"Full list of Links\",\n  \"next\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F3\",\n  \"partOf\": {\n    \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F\",\n    \"label\": \"Collection of Link Annotations\",\n    \"total\": 2121657,\n    \"type\": \"AnnotationCollection\"\n  },\n  \"startIndex\": 200,\n  \"type\": \"AnnotationPage\"\n}\n",[41,945,946,950,954,959,964,969,974,979,984,988,993,998,1003,1008,1013,1018,1023,1028,1032,1037,1042,1047,1052,1057,1062,1067,1072,1077,1082,1087,1091,1096,1101],{"__ignoreMap":86},[90,947,948],{"class":92,"line":93},[90,949,97],{},[90,951,952],{"class":92,"line":100},[90,953,606],{},[90,955,956],{"class":92,"line":117},[90,957,958],{},"  \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F2\",\n",[90,960,961],{"class":92,"line":126},[90,962,963],{},"  \"items\": [\n",[90,965,966],{"class":92,"line":139},[90,967,968],{},"    {\n",[90,970,971],{"class":92,"line":152},[90,972,973],{},"      \"body\": {\n",[90,975,976],{"class":92,"line":165},[90,977,978],{},"        \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Fgcis\",\n",[90,980,981],{"class":92,"line":171},[90,982,983],{},"        \"id\": \"https:\u002F\u002Fmedia.getty.edu\u002Fiiif\u002Fmanifest\u002F5b2ecb8f-759a-4d2e-a5fc-057250657e84\"\n",[90,985,986],{"class":92,"line":184},[90,987,773],{},[90,989,990],{"class":92,"line":197},[90,991,992],{},"      \"created\": \"2020-06-25T01:14:55Z\",\n",[90,994,995],{"class":92,"line":210},[90,996,997],{},"      \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F7e9dbc3d-e87c-4a1b-8673-8fa32c2bd3eb\",\n",[90,999,1000],{"class":92,"line":223},[90,1001,1002],{},"      \"label: \"testdata\",\n",[90,1004,1005],{"class":92,"line":236},[90,1006,1007],{},"      \"modified\": \"2020-06-25T01:14:55Z\",\n",[90,1009,1010],{"class":92,"line":248},[90,1011,1012],{},"      \"motivation\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fiiif_manifest_of\",\n",[90,1014,1015],{"class":92,"line":256},[90,1016,1017],{},"      \"target\": {\n",[90,1019,1020],{"class":92,"line":267},[90,1021,1022],{},"        \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fgenerators\u002Ftms\",\n",[90,1024,1025],{"class":92,"line":272},[90,1026,1027],{},"        \"id\": \"urn:getty-local:8132\"\n",[90,1029,1030],{"class":92,"line":285},[90,1031,773],{},[90,1033,1034],{"class":92,"line":293},[90,1035,1036],{},"      \"type\": \"Annotation\"\n",[90,1038,1039],{"class":92,"line":305},[90,1040,1041],{},"    },\n",[90,1043,1044],{"class":92,"line":317},[90,1045,1046],{},"    \u002F\u002F ... RESULTS TRUNCATED ...\n",[90,1048,1049],{"class":92,"line":328},[90,1050,1051],{},"  ],\n",[90,1053,1054],{"class":92,"line":333},[90,1055,1056],{},"  \"label\": \"Full list of Links\",\n",[90,1058,1059],{"class":92,"line":344},[90,1060,1061],{},"  \"next\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F3\",\n",[90,1063,1064],{"class":92,"line":719},[90,1065,1066],{},"  \"partOf\": {\n",[90,1068,1069],{"class":92,"line":724},[90,1070,1071],{},"    \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F\",\n",[90,1073,1074],{"class":92,"line":730},[90,1075,1076],{},"    \"label\": \"Collection of Link Annotations\",\n",[90,1078,1079],{"class":92,"line":736},[90,1080,1081],{},"    \"total\": 2121657,\n",[90,1083,1084],{"class":92,"line":742},[90,1085,1086],{},"    \"type\": \"AnnotationCollection\"\n",[90,1088,1089],{"class":92,"line":748},[90,1090,168],{},[90,1092,1093],{"class":92,"line":754},[90,1094,1095],{},"  \"startIndex\": 200,\n",[90,1097,1098],{"class":92,"line":759},[90,1099,1100],{},"  \"type\": \"AnnotationPage\"\n",[90,1102,1103],{"class":92,"line":764},[90,1104,347],{},[580,1106,1108],{"id":1107},"query-with-a-filter","Query with a filter:",[15,1110,1111,1112,1115],{},"This shows the response to the request ",[41,1113,1114],{},"GET \u002Flinks?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid"," which will return only the links that have this specific motivation.",[81,1117,1119],{"className":593,"code":1118,"language":595,"meta":86,"style":86},"{\n  \"@context\": \"http:\u002F\u002Fwww.w3.org\u002Fns\u002Fanno.jsonld\",\n  \"first\": {\n    \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F1?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n    \"items\": [\n      \u002F\u002F RESPONSE ITEMS OMITTED\n    ],\n    \"startIndex\": 0,\n    \"type\": \"AnnotationPage\"\n  },\n  \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n  \"label\": \"Collection of Link Annotations for [[('motivation', 'https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid')]]\",\n  \"last\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F2399?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n  \"next\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F2?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n  \"total\": 479775,\n  \"type\": \"AnnotationCollection\"\n}\n",[41,1120,1121,1125,1129,1133,1138,1142,1147,1151,1155,1159,1163,1168,1173,1178,1183,1188,1192],{"__ignoreMap":86},[90,1122,1123],{"class":92,"line":93},[90,1124,97],{},[90,1126,1127],{"class":92,"line":100},[90,1128,606],{},[90,1130,1131],{"class":92,"line":117},[90,1132,641],{},[90,1134,1135],{"class":92,"line":126},[90,1136,1137],{},"    \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F1?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n",[90,1139,1140],{"class":92,"line":139},[90,1141,651],{},[90,1143,1144],{"class":92,"line":152},[90,1145,1146],{},"      \u002F\u002F RESPONSE ITEMS OMITTED\n",[90,1148,1149],{"class":92,"line":165},[90,1150,910],{},[90,1152,1153],{"class":92,"line":171},[90,1154,916],{},[90,1156,1157],{"class":92,"line":184},[90,1158,922],{},[90,1160,1161],{"class":92,"line":197},[90,1162,168],{},[90,1164,1165],{"class":92,"line":210},[90,1166,1167],{},"  \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n",[90,1169,1170],{"class":92,"line":223},[90,1171,1172],{},"  \"label\": \"Collection of Link Annotations for [[('motivation', 'https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid')]]\",\n",[90,1174,1175],{"class":92,"line":236},[90,1176,1177],{},"  \"last\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F2399?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n",[90,1179,1180],{"class":92,"line":248},[90,1181,1182],{},"  \"next\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F2?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n",[90,1184,1185],{"class":92,"line":256},[90,1186,1187],{},"  \"total\": 479775,\n",[90,1189,1190],{"class":92,"line":267},[90,1191,636],{},[90,1193,1194],{"class":92,"line":272},[90,1195,347],{},[15,1197,1198],{},"And the corresponding 'next' AnnotationPage response:",[81,1200,1202],{"className":593,"code":1201,"language":595,"meta":86,"style":86},"{\n  \"@context\": \"http:\u002F\u002Fwww.w3.org\u002Fns\u002Fanno.jsonld\",\n  \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F2?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n  \"items\": [\n    \u002F\u002F RESPONSE ITEMS OMITTED\n  ],\n  \"label\": \"Filtered list of Links [[('motivation', 'https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid')]]\",\n  \"next\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F3?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n  \"partOf\": {\n    \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n    \"label\": \"Collection of Link Annotations for [[('motivation', 'https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid')]]\",\n    \"total\": 479775,\n    \"type\": \"AnnotationCollection\"\n  },\n  \"startIndex\": 200,\n  \"type\": \"AnnotationPage\"\n}\n",[41,1203,1204,1208,1212,1217,1221,1226,1230,1235,1240,1244,1249,1254,1259,1263,1267,1271,1275],{"__ignoreMap":86},[90,1205,1206],{"class":92,"line":93},[90,1207,97],{},[90,1209,1210],{"class":92,"line":100},[90,1211,606],{},[90,1213,1214],{"class":92,"line":117},[90,1215,1216],{},"  \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F2?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n",[90,1218,1219],{"class":92,"line":126},[90,1220,963],{},[90,1222,1223],{"class":92,"line":139},[90,1224,1225],{},"    \u002F\u002F RESPONSE ITEMS OMITTED\n",[90,1227,1228],{"class":92,"line":152},[90,1229,1051],{},[90,1231,1232],{"class":92,"line":165},[90,1233,1234],{},"  \"label\": \"Filtered list of Links [[('motivation', 'https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid')]]\",\n",[90,1236,1237],{"class":92,"line":171},[90,1238,1239],{},"  \"next\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002Fpage\u002F3?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n",[90,1241,1242],{"class":92,"line":184},[90,1243,1066],{},[90,1245,1246],{"class":92,"line":197},[90,1247,1248],{},"    \"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F?motivation=https%3A\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid\",\n",[90,1250,1251],{"class":92,"line":210},[90,1252,1253],{},"    \"label\": \"Collection of Link Annotations for [[('motivation', 'https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fcontains-refid')]]\",\n",[90,1255,1256],{"class":92,"line":223},[90,1257,1258],{},"    \"total\": 479775,\n",[90,1260,1261],{"class":92,"line":236},[90,1262,1086],{},[90,1264,1265],{"class":92,"line":248},[90,1266,168],{},[90,1268,1269],{"class":92,"line":256},[90,1270,1095],{},[90,1272,1273],{"class":92,"line":267},[90,1274,1100],{},[90,1276,1277],{"class":92,"line":272},[90,1278,347],{},[65,1280,1282],{"id":1281},"error-response","Error Response",[15,1284,1285,107,1287],{},[36,1286,73],{},[41,1288,1289],{},"400 Bad Request",[15,1291,1292],{},"Typically, this will be because the query specifies a motivation or generator that is not registered with the ID Manager instance.",[19,1294,1296],{"id":1295},"query-for-a-set-of-links-post-json","Query for a set of links (POST JSON)",[15,1298,1299],{},"Query endpoint for retrieving Web Annotations using a JSON POSTed query instead of the HTTP GET parameter route. This can be clearer when querying for multiple values for the same fields, and requires only JSON encoding, rather than URL encoding the values.",[15,1301,1302],{},"The prev\u002Fnext\u002Flast links while present are the GET parameter version of the query, and pagination will have to be handled by the client by adding in a 'page' key, set to the page number to retrieve.",[15,1304,1305,39,1307],{},[36,1306,38],{},[41,1308,369],{},[15,1310,1311,39,1313],{},[36,1312,48],{},[41,1314,1315],{},"POST",[15,1317,1318,57],{},[36,1319,56],{},[15,1321,1322,1324],{},[36,1323,62],{}," : JSON",[65,1326,518],{"id":1327},"data-requirements-1",[15,1329,1330,1331,1333,1334,1336,1337,1339],{},"All keys are optional. The query should only need to specify the values for filtering. NB ",[41,1332,411],{}," will take precedence over ",[41,1335,396],{},"\u002F",[41,1338,405],{}," values.",[81,1341,1343],{"className":593,"code":1342,"language":595,"meta":86,"style":86},"{\n  \"target_id\": \"\",        \u002F\u002F Can be a list, [\"URI1\", \"URI2\", ...]. Response will be a inclusive OR on these\n  \"target_generator\": \"\", \u002F\u002F Target Generator URI\n  \"body_id\": \"\",          \u002F\u002F Can be a list, [\"URI1\", \"URI2\", ...]\n  \"body_generator\": \"\",   \u002F\u002F Body Generator URI\n  \"any_id\": \"\",           \u002F\u002F Will match any link with this value as the body or target ID. \n  \"motivation\": \"\",       \u002F\u002F Motivation URI \n  \"group_id\": \"\",         \u002F\u002F Group ID\n  \"creator_name\": \"\",     \u002F\u002F Filter by name of link creator\n  \"page\": \"\"              \u002F\u002F Large responses may be spread over multiple pages\n}\n",[41,1344,1345,1349,1357,1365,1373,1381,1389,1397,1405,1413,1421],{"__ignoreMap":86},[90,1346,1347],{"class":92,"line":93},[90,1348,97],{},[90,1350,1351,1354],{"class":92,"line":100},[90,1352,1353],{},"  \"target_id\": \"\",",[90,1355,1356],{},"        \u002F\u002F Can be a list, [\"URI1\", \"URI2\", ...]. Response will be a inclusive OR on these\n",[90,1358,1359,1362],{"class":92,"line":117},[90,1360,1361],{},"  \"target_generator\": \"\",",[90,1363,1364],{}," \u002F\u002F Target Generator URI\n",[90,1366,1367,1370],{"class":92,"line":126},[90,1368,1369],{},"  \"body_id\": \"\",",[90,1371,1372],{},"          \u002F\u002F Can be a list, [\"URI1\", \"URI2\", ...]\n",[90,1374,1375,1378],{"class":92,"line":139},[90,1376,1377],{},"  \"body_generator\": \"\",",[90,1379,1380],{},"   \u002F\u002F Body Generator URI\n",[90,1382,1383,1386],{"class":92,"line":152},[90,1384,1385],{},"  \"any_id\": \"\",",[90,1387,1388],{},"           \u002F\u002F Will match any link with this value as the body or target ID. \n",[90,1390,1391,1394],{"class":92,"line":165},[90,1392,1393],{},"  \"motivation\": \"\",",[90,1395,1396],{},"       \u002F\u002F Motivation URI \n",[90,1398,1399,1402],{"class":92,"line":171},[90,1400,1401],{},"  \"group_id\": \"\",",[90,1403,1404],{},"         \u002F\u002F Group ID\n",[90,1406,1407,1410],{"class":92,"line":184},[90,1408,1409],{},"  \"creator_name\": \"\",",[90,1411,1412],{},"     \u002F\u002F Filter by name of link creator\n",[90,1414,1415,1418],{"class":92,"line":197},[90,1416,1417],{},"  \"page\": \"\"",[90,1419,1420],{},"              \u002F\u002F Large responses may be spread over multiple pages\n",[90,1422,1423],{"class":92,"line":210},[90,1424,347],{},[65,1426,68],{"id":1427},"success-response-2",[15,1429,1430,39,1432],{},[36,1431,73],{},[41,1433,76],{},[15,1435,1436,1437,1439],{},"The responses will be the same AnnotationCollection\u002FAnnotationPage objects that the ",[41,1438,492],{}," endpoint above described.",[580,1441,1443],{"id":1442},"example-json-query-message","Example JSON query message",[15,1445,1446],{},"Getting the second page of links with multiple named target ids and the given motivation):",[81,1448,1451],{"className":1449,"code":1450,"language":527},[525],"POST \u002Fquery\u002F\n    {\n        \"target_id\": [\"id1\",\"id2\",\"id3\"],\n        \"motivation\": \"https:\u002F\u002Fmotivation.uri\",\n        \"page\": 2\n    }\n",[41,1452,1450],{"__ignoreMap":86},[580,1454,1456],{"id":1455},"query-pagination-details","Query Pagination details",[15,1458,1459],{},"As this no longer can be done by 'following your nose' on the 'first'\u002F'next'\u002F'prev'\u002F'last' GET URLs, a good pattern would be:",[15,1461,1462],{},"Test the response: Is there a 'next' key?",[389,1464,1465,1468],{},[392,1466,1467],{},"No? - this is the final\u002Fonly page",[392,1469,1470,1471,1474,1475,1477],{},"Yes? - There are more pages. Resend the JSON query, but with json",[90,1472,1473],{},"'page'"," = json",[90,1476,1473],{}," + 1",[15,1479,1480],{},"If no page parameter is supplied, page will default to 1",[15,1482,1483],{},"If a request is made for a page without any results, an HTTP 404 error will be returned.",[19,1485,1487],{"id":1486},"createupdate-links","Create\u002FUpdate links",[15,1489,1490],{},"Endpoint for creating or updating links. One request can create or update a single link, or multiple links.",[389,1492,1493,1496],{},[392,1494,1495],{},"Single Link creation: HTTP POST a JSON body with the necessary keys (see data requirements below). Returns HTTP 201 if it created a record.",[392,1497,1498],{},"Bulk Link creation: HTTP POST a JSON list of Link information. Each item on the list MUST be valid for the changes to be committed to the IDM. The list items are the same data as for creating a single Link as described below. This will respond with HTTP 200 as this API call causes multiple new resources to be created.",[15,1500,1501,39,1503],{},[36,1502,38],{},[41,1504,492],{},[15,1506,1507,39,1509],{},[36,1508,48],{},[41,1510,1315],{},[15,1512,1513,1515],{},[36,1514,56],{}," : YES",[15,1517,1518,1520],{},[36,1519,62],{}," : Both (HTML has its own form views for adding single links)",[65,1522,518],{"id":1523},"data-requirements-2",[15,1525,1526],{},"The minimum set of keys is the following:",[81,1528,1530],{"className":593,"code":1529,"language":595,"meta":86,"style":86},"{\n  \"motivation\": \"...\",      \u002F\u002F must be a registered motivation URI\n  \"body\": {\n    \"id\": \"...\",            \u002F\u002F Body ID (URI)\n    \"generator\": \"...\"      \u002F\u002F must be a registered generator URI\n  },\n  \"target\": {\n    \"id\": \"...\",            \u002F\u002F Target ID (URI)\n    \"generator\": \"...\"      \u002F\u002F must be a registered generator URI\n  }\n}\n",[41,1531,1532,1536,1544,1549,1557,1565,1569,1574,1581,1587,1592],{"__ignoreMap":86},[90,1533,1534],{"class":92,"line":93},[90,1535,97],{},[90,1537,1538,1541],{"class":92,"line":100},[90,1539,1540],{},"  \"motivation\": \"...\",",[90,1542,1543],{},"      \u002F\u002F must be a registered motivation URI\n",[90,1545,1546],{"class":92,"line":117},[90,1547,1548],{},"  \"body\": {\n",[90,1550,1551,1554],{"class":92,"line":126},[90,1552,1553],{},"    \"id\": \"...\",",[90,1555,1556],{},"            \u002F\u002F Body ID (URI)\n",[90,1558,1559,1562],{"class":92,"line":139},[90,1560,1561],{},"    \"generator\": \"...\"",[90,1563,1564],{},"      \u002F\u002F must be a registered generator URI\n",[90,1566,1567],{"class":92,"line":152},[90,1568,168],{},[90,1570,1571],{"class":92,"line":165},[90,1572,1573],{},"  \"target\": {\n",[90,1575,1576,1578],{"class":92,"line":171},[90,1577,1553],{},[90,1579,1580],{},"            \u002F\u002F Target ID (URI)\n",[90,1582,1583,1585],{"class":92,"line":184},[90,1584,1561],{},[90,1586,1564],{},[90,1588,1589],{"class":92,"line":197},[90,1590,1591],{},"  }\n",[90,1593,1594],{"class":92,"line":210},[90,1595,347],{},[15,1597,1598,1599,1602],{},"This combination of fields will be unique in the ID Manager. Attempting subsequently to create a link with the same values for these five fields will not succeed, and will only update the metadata for the existing link. A ",[41,1600,1601],{},"HTTP 409 Conflict"," response may be returned if anything breaks this uniqueness constraint.",[15,1604,1605],{},"Alongside these mandatory fields, there are a number of metadata fields.",[389,1607,1608,1633,1639,1645],{},[392,1609,1610,1611,1614,1615,1618,1619,1622,1623,1626,1627,1629,1630,1632],{},"The ",[41,1612,1613],{},"dcterms:title"," (or ",[41,1616,1617],{},"title","), and ",[41,1620,1621],{},"dcterms:alternative"," (",[41,1624,1625],{},"alternative",") fields can be set to a text value which should describe the link in some manner (aligning with the definitions of ",[41,1628,1613],{}," and ",[41,1631,1621],{},").",[392,1634,1610,1635,1638],{},[41,1636,1637],{},"creator"," can be given a name, and will often reflect the process or system agent that created the link.",[392,1640,1641,1642,1644],{},"A ",[41,1643,435],{}," can be specified. This is largely a logistical grouping, and does not imply a semantic connection between the links beyond that they may have been derived from the same data, or were part of the same project. Groups can be listed and deleted easily, and can be a useful way to deal with updates when the links are not easily connected by the other field values.",[392,1646,1647,1648,1629,1651,1654,1655,1622,1658,1661],{},"Both ",[41,1649,1650],{},"body",[41,1652,1653],{},"target"," can have a ",[41,1656,1657],{},"format",[41,1659,1660],{},"dc:format",") mimetype specified. This is to aid presentation by web interfaces which likely wish to present a link to a PDF in a different manner than a direct link to video.",[15,1663,1664],{},"A fully specified link might look like the following:",[81,1666,1668],{"className":593,"code":1667,"language":595,"meta":86,"style":86},"{\n  \"motivation\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fiiif_link\",\n  \"group_id\": \"rosetta:\u002F\u002FIE23212\",\n  \"dcterms:title\": \"IIIF Link Title\",\n  \"dcterms:alternative\": \"Rosetta Image\",\n  \"creator\": {\n    \"name\": \"GCIS ETL\"\n  },\n  \"body\": {\n    \"id\":\"rosetta:\u002F\u002F12345\",\n    \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fsystems\u002Frosetta\",\n    \"format\": \"image\u002Ftiff\",\n  },\n  \"target\": {\n    \"id\": \"http:\u002F\u002Fmedia.getty.edu\u002Fiiif\u002Fmanifest\u002F6c2219dd-fd11-46e9-8cc3-83cc946e3c64\",\n    \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fsystems\u002Fgcis\",\n    \"format\": \"image\u002Fjpeg\",\n  }\n}\n",[41,1669,1670,1674,1679,1684,1689,1694,1699,1704,1708,1712,1717,1722,1727,1731,1735,1740,1745,1750,1754],{"__ignoreMap":86},[90,1671,1672],{"class":92,"line":93},[90,1673,97],{},[90,1675,1676],{"class":92,"line":100},[90,1677,1678],{},"  \"motivation\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fmotivations\u002Fiiif_link\",\n",[90,1680,1681],{"class":92,"line":117},[90,1682,1683],{},"  \"group_id\": \"rosetta:\u002F\u002FIE23212\",\n",[90,1685,1686],{"class":92,"line":126},[90,1687,1688],{},"  \"dcterms:title\": \"IIIF Link Title\",\n",[90,1690,1691],{"class":92,"line":139},[90,1692,1693],{},"  \"dcterms:alternative\": \"Rosetta Image\",\n",[90,1695,1696],{"class":92,"line":152},[90,1697,1698],{},"  \"creator\": {\n",[90,1700,1701],{"class":92,"line":165},[90,1702,1703],{},"    \"name\": \"GCIS ETL\"\n",[90,1705,1706],{"class":92,"line":171},[90,1707,168],{},[90,1709,1710],{"class":92,"line":184},[90,1711,1548],{},[90,1713,1714],{"class":92,"line":197},[90,1715,1716],{},"    \"id\":\"rosetta:\u002F\u002F12345\",\n",[90,1718,1719],{"class":92,"line":210},[90,1720,1721],{},"    \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fsystems\u002Frosetta\",\n",[90,1723,1724],{"class":92,"line":223},[90,1725,1726],{},"    \"format\": \"image\u002Ftiff\",\n",[90,1728,1729],{"class":92,"line":236},[90,1730,168],{},[90,1732,1733],{"class":92,"line":248},[90,1734,1573],{},[90,1736,1737],{"class":92,"line":256},[90,1738,1739],{},"    \"id\": \"http:\u002F\u002Fmedia.getty.edu\u002Fiiif\u002Fmanifest\u002F6c2219dd-fd11-46e9-8cc3-83cc946e3c64\",\n",[90,1741,1742],{"class":92,"line":267},[90,1743,1744],{},"    \"generator\": \"https:\u002F\u002Fdata.getty.edu\u002Flocal\u002Fthesaurus\u002Fsystems\u002Fgcis\",\n",[90,1746,1747],{"class":92,"line":272},[90,1748,1749],{},"    \"format\": \"image\u002Fjpeg\",\n",[90,1751,1752],{"class":92,"line":285},[90,1753,1591],{},[90,1755,1756],{"class":92,"line":293},[90,1757,347],{},[580,1759,1761],{"id":1760},"batch-creatingupdating","Batch creating\u002Fupdating",[15,1763,1764],{},"The same endpoint can be sent a list of the link objects, as long as they all conform to the same requirements as outlined for a single link above. All links sent will be added as part of the same transaction, so they will either all succeed to be added or updated, or they will all fail. This can happen if one of the links breaks the uniqueness constraint within the supplied links or if a link uses a generator or motivation that is not yet registered.",[15,1766,1767,1768,1770,1771,1774],{},"If links are sent which match links already in the system, then the service may response with an ",[41,1769,1601],{}," error. The ID Manager can be run with an environment flag set (",[41,1772,1773],{},"UPSERT_ON_CONFLICT",") so that in this case of conflict, the metadata for those links are updated with the newly supplied metadata (title, creator, etc), and the date modified is updated. (An Upsert is a combination of SQL insert and update, and can be used in postgresql to handle a combination of inserts, or updates in cases where the uniqueness constraint would be broken by an insert).",[65,1776,68],{"id":1777},"success-response-3",[15,1779,1780,39,1782,1785,1786,1788],{},[36,1781,73],{},[41,1783,1784],{},"201 Created",", ",[41,1787,76],{},"   (single\u002Fmultiple)",[15,1790,1791],{},"The responses will be the Annotation object(s) for the link or links, returned in the same manner as resolving the link URI (eg GET \u002Flinks\u002F{link uri}).",[19,1793,1795],{"id":1794},"delete-links","Delete link(s)",[15,1797,1798,1799],{},"This request will delete the specified link and metadata. Multiple links may be specified as part of the call to delete links as a batch. Note that this URI is the same URI as given as the 'id' for a given Annotation, eg ",[41,1800,1801],{},"\"id\": \"https:\u002F\u002Fservices.getty.edu\u002Fid-management\u002Flinks\u002F7e9dbc3d-e87c-4a1b-8673-8fa32c2bd3eb\"",[15,1803,1804],{},"For bulk deletion, supply a list of the Link ids (as UUIDs) as part of the URL. For example:",[81,1806,1809],{"className":1807,"code":1808,"language":527},[525],"DELETE \u002Flinks\u002F8a98bca3-c76a-4692-aab5-89ddbee6f768,8e94e1ca-54eb-471d-b84c-798ec68aa123,6a9bff42-d289-444f-8828-91f54cee5ce6\n",[41,1810,1808],{"__ignoreMap":86},[15,1812,1813],{},"The response format will be JSON. If a single Link deletion is attempted but the Link does not exist, the response will be HTTP 404. If the response is HTTP 200, then either the single link deletion has succeeded, or this was part of a bulk deletion, and clients should parse the JSON reponse to see which deletions succeeded or failed (due to not existing). These will as a tuples of the UUID and True\u002FFalse, depending on success.",[15,1815,1816],{},"For activities that will regularly delete in bulk, it is recommended to use groups instead as a means to delete sets of related links.",[15,1818,1819,39,1821],{},[36,1820,38],{},[41,1822,1823],{},"\u002Flinks\u002F{id}",[15,1825,1826,39,1828,1831],{},[36,1827,38],{},[41,1829,1830],{},"\u002Flinks\u002F{id1},{id2},{id3}","    - link uuids, comma-separated",[15,1833,1834,39,1836],{},[36,1835,48],{},[41,1837,1838],{},"DELETE",[15,1840,1841,1515],{},[36,1842,56],{},[15,1844,1845,1847],{},[36,1846,62],{}," : Both (HTML has its own view response)",[65,1849,68],{"id":1850},"success-response-4",[15,1852,1853,39,1855],{},[36,1854,73],{},[41,1856,76],{},[580,1858,1860],{"id":1859},"example-single-deletion-response","Example single deletion response",[81,1862,1864],{"className":83,"code":1863,"language":85,"meta":86,"style":86},"{\n  \"title\": \"Delete response\",\n  \"items\": [\n    [\n      \"8a98bca3-c76a-4692-aab5-89ddbee6f768\",\n      true\n    ]\n  ]\n}\n",[41,1865,1866,1870,1882,1890,1895,1902,1907,1912,1917],{"__ignoreMap":86},[90,1867,1868],{"class":92,"line":93},[90,1869,97],{"class":96},[90,1871,1872,1875,1877,1880],{"class":92,"line":100},[90,1873,1874],{"class":103},"  \"title\"",[90,1876,107],{"class":96},[90,1878,1879],{"class":110},"\"Delete response\"",[90,1881,114],{"class":96},[90,1883,1884,1887],{"class":92,"line":117},[90,1885,1886],{"class":103},"  \"items\"",[90,1888,1889],{"class":96},": [\n",[90,1891,1892],{"class":92,"line":126},[90,1893,1894],{"class":96},"    [\n",[90,1896,1897,1900],{"class":92,"line":139},[90,1898,1899],{"class":110},"      \"8a98bca3-c76a-4692-aab5-89ddbee6f768\"",[90,1901,114],{"class":96},[90,1903,1904],{"class":92,"line":152},[90,1905,1906],{"class":103},"      true\n",[90,1908,1909],{"class":92,"line":165},[90,1910,1911],{"class":96},"    ]\n",[90,1913,1914],{"class":92,"line":171},[90,1915,1916],{"class":96},"  ]\n",[90,1918,1919],{"class":92,"line":184},[90,1920,347],{"class":96},[15,1922,1923,1924,1927],{},"If the above link did not exist, an ",[41,1925,1926],{},"HTTP 404"," response would be given.",[580,1929,1931],{"id":1930},"example-bulk-deletion-response","Example bulk deletion response",[81,1933,1935],{"className":83,"code":1934,"language":85,"meta":86,"style":86},"{\n  \"title\": \"Delete response\",\n  \"items\": [\n    [\n      \"8a98bca3-c76a-4692-aab5-89ddbee6f768\",\n      true\n    ],\n    [\n      \"8e94e1ca-54eb-471d-b84c-798ec68aa123\",\n      true\n    ],\n    [\n      \"6a9bff42-d289-444f-8828-91f54cee5ce6\",\n      false\n    ]\n  ]\n}\n",[41,1936,1937,1941,1951,1957,1961,1967,1971,1975,1979,1986,1990,1994,1998,2005,2010,2014,2018],{"__ignoreMap":86},[90,1938,1939],{"class":92,"line":93},[90,1940,97],{"class":96},[90,1942,1943,1945,1947,1949],{"class":92,"line":100},[90,1944,1874],{"class":103},[90,1946,107],{"class":96},[90,1948,1879],{"class":110},[90,1950,114],{"class":96},[90,1952,1953,1955],{"class":92,"line":117},[90,1954,1886],{"class":103},[90,1956,1889],{"class":96},[90,1958,1959],{"class":92,"line":126},[90,1960,1894],{"class":96},[90,1962,1963,1965],{"class":92,"line":139},[90,1964,1899],{"class":110},[90,1966,114],{"class":96},[90,1968,1969],{"class":92,"line":152},[90,1970,1906],{"class":103},[90,1972,1973],{"class":92,"line":165},[90,1974,910],{"class":96},[90,1976,1977],{"class":92,"line":171},[90,1978,1894],{"class":96},[90,1980,1981,1984],{"class":92,"line":184},[90,1982,1983],{"class":110},"      \"8e94e1ca-54eb-471d-b84c-798ec68aa123\"",[90,1985,114],{"class":96},[90,1987,1988],{"class":92,"line":197},[90,1989,1906],{"class":103},[90,1991,1992],{"class":92,"line":210},[90,1993,910],{"class":96},[90,1995,1996],{"class":92,"line":223},[90,1997,1894],{"class":96},[90,1999,2000,2003],{"class":92,"line":236},[90,2001,2002],{"class":110},"      \"6a9bff42-d289-444f-8828-91f54cee5ce6\"",[90,2004,114],{"class":96},[90,2006,2007],{"class":92,"line":248},[90,2008,2009],{"class":103},"      false\n",[90,2011,2012],{"class":92,"line":256},[90,2013,1911],{"class":96},[90,2015,2016],{"class":92,"line":267},[90,2017,1916],{"class":96},[90,2019,2020],{"class":92,"line":272},[90,2021,347],{"class":96},[15,2023,2024,2025,2028,2029,2032,2033,2036],{},"Link ID ",[41,2026,2027],{},"6a9bff42-d289-444f-8828-91f54cee5ce6"," did not exist, and so the response is ",[41,2030,2031],{},"false",". The HTTP response will still be ",[41,2034,2035],{},"HTTP 200"," in this case.",[2038,2039,2040],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}",{"title":86,"searchDepth":100,"depth":100,"links":2042},[2043],{"id":12,"depth":100,"text":13,"children":2044},[2045,2046,2047,2048,2049],{"id":21,"depth":117,"text":22},{"id":362,"depth":117,"text":363},{"id":1295,"depth":117,"text":1296},{"id":1486,"depth":117,"text":1487},{"id":1794,"depth":117,"text":1795},"md",false,"2026-03-30",{},true,"\u002Fdocs\u002Fid_manager\u002Flinksendpoints","\u002Ftools\u002Fid_manager\u002Fdocs\u002Frevision\u002F",{"title":5,"description":86},"\u002Ftools\u002Fid_manager\u002Fdocs\u002Flinksendpoints\u002F","docs\u002Fid_manager\u002Flinksendpoints\u002Findex","Service for creating, updating and managing links between identifiers.","UPN1Q4wjmWRk7hcNi5fGlaw8IkXMRC4WBdwASjJAlUg",1782833580425]