{"type":"doc","content":[{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Table of Contents","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"2"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"style":{"value":"disc"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"61238332-bf9b-4488-b70b-6e3bac86513a"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"c4d3f7d6-82a9-4778-af33-6fd7dc6cffa8"}}]},{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"About Relationship Service RESTful API","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The Person Service offers a REST-based Application Programming Interface (API) to CRUD (create, read, update, and delete) operations on individual PersonAuthority instances, and on the associated Person instances. ","type":"text"}]},{"type":"paragraph","content":[{"text":"These follow the ","type":"text"},{"text":"Common model for CollectionSpace REST services","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3577544705"}}]},{"text":".","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Note that the Person instances are not directly \"addressible\"; they can only be accessed via the parent PersonAuthority.","type":"text"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"PersonAuthority CRUD+L services","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Create a PersonAuthority","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a new PersonAuthority record. Assigns a unique, service-specified ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":" to that PersonAuthority record. Follows standard Create model. See the documentation of the PersonAuthority schema, below. Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"6a1f6162-f5b1-438b-8a05-6de77940a5b4"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"POST /cspace-services/personauthorities HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Read a PersonAuthority","type":"text"}]},{"type":"paragraph","content":[{"text":"Reads an existing PersonAuthority record, specified by its ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":". Follows standard Read model. See the documentation of the PersonAuthority schema, below.","type":"text"}]},{"type":"paragraph","content":[{"text":"General form:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"967b9d1e-8785-4c47-8c3f-84356c6971e1"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities/{id} HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Example, reading an existing record with a CSID of e450e8e8-9f12-49f3-aba4-43b7c46344a2:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"3a099804-435f-4a20-a421-682b9bdef617"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities/e450e8e8-9f12-49f3-aba4-43b7c46344a2 HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"An alternate form reads an existing PersonAuthority record, specified by its ","type":"text"},{"text":"Short Identifier","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052069"}}]},{"text":", which matches the value of the ","type":"text"},{"text":"shortIdentifier","type":"text","marks":[{"type":"code"}]},{"text":" field in the record. Otherwise follows standard Read model. See the documentation of the PersonAuthority schema, below.","type":"text"}]},{"type":"paragraph","content":[{"text":"General form:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"680b6150-d7da-43de-a8a0-faaa695ef2c2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/vocabularies/urn:cspace:name({id}) HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Example, reading an existing record with a ","type":"text"},{"text":"shortIdentifier","type":"text","marks":[{"type":"code"}]},{"text":" value of ","type":"text"},{"text":"myDefaultPersonAuthority","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ea42f5fe-0dc6-4b37-a325-f8f8d6fb044c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/vocabularies/urn:cspace:name(myDefaultPersonAuthority) HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Update a PersonAuthority","type":"text"}]},{"type":"paragraph","content":[{"text":"Updates an existing PersonAuthority record, specified by its ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":" or ","type":"text"},{"text":"Short Identifier","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052069"}}]},{"text":". Follows standard Update model. See the documentation of the PersonAuthority schema, below. Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c9655ce6-4e59-4861-bc30-2711165a22f2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"PUT /cspace-services/personauthorities/{id} HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Delete a PersonAuthority","type":"text"}]},{"type":"paragraph","content":[{"text":"Deletes an existing PersonAuthority record, specified by its ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CSPACE50/pages/665882927"}}]},{"text":" or ","type":"text","marks":[{"type":"strong"}]},{"text":"Short Identifier","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CSPACE50/pages/665882928#ShortIdentifier-uris"}}]},{"text":". Follows standard Delete model. Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ba69dc9a-d394-42b4-8054-ff603dd31bde"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"DELETE /cspace-services/personauthorities/{id} HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"List PersonAuthority instances","type":"text"}]},{"type":"paragraph","content":[{"text":"Lists existing PersonAuthority records, with summary information for each. Follows standard List model. See the documentation of the Vocabulary-List schema, below.","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"a636437b-13f7-4fef-b3e7-fd1b81a4fd6a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"List supports query parameters for customizing list results, such as pagination controls, query filters, and sorting options. For example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"621fa086-3d4b-44f3-9b7b-219cc85f55c2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities?pgSz=10 HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"List also supports query parameters for searching for matching records, including keyword search. For example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"7e04862f-90fd-4555-ba8d-76b37e371b71"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities?kw=foo&pgSz=10 HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"PersonAuthority REST payload schemas","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The schemas below are abbreviated, and are thus illustrative. For a full list of the fields that may potentially be present in payloads when creating, updating, or reading PersonAuthority records, please see the most recent PersonAuthority schema|","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/collectionspace/services/blob/master/services/person/3rdparty/nuxeo-platform-cs-person/src/main/resources/schemas/personauthorities_common.xsd"}},{"text":" ]","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"PersonAuthority instance schema","type":"text"}]},{"type":"paragraph","content":[{"text":"Create and Update should use the following schema. The value of ","type":"text"},{"text":"vocabType","type":"text","marks":[{"type":"em"}]},{"text":" must be \"PersonAuthority\".","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"07507af4-7299-4c21-bad8-a897fd3361b4"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Museum Internal","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" urn:cspace:org.collectionspace.demo:personauthority:name(MuseumInternal)'Museum Internal'","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" PersonAuthority","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Read will return the above, plus additional fields (","type":"text"},{"text":"uri","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"csid","type":"text","marks":[{"type":"em"}]},{"text":") for access:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"dcfbda00-3d65-43ed-80ef-679554328c0c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" /personauthorities/f0cf4c50-8f8a-4df0-869a","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" f0cf4c50-8f8a-4df0-869a","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"PersonAuthority-List schema","type":"text"}]},{"type":"paragraph","content":[{"text":"List (and variants) will return the following schema.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"78c94572-f470-4903-9787-919d2489555c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 0","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 40","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 3","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 3","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" csid|uri|updatedAt|workflowState|displayName|refName|shortIdentifier|vocabType","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Museum Internal","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" urn:cspace:org.collectionspace.demo:personauthority:name(MuseumInternal)'Museum Internal'","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" PersonAuthority","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" /personauthorities/f0cf4c50-8f8a-4df0-869a","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" f0cf4c50-8f8a-4df0-869a","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Person CRUD+L services","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Person instances are only accessible via the owning PersonAuthority. The sub-resource is accessed with \"","type":"text"},{"text":"items","type":"text","marks":[{"type":"em"}]},{"text":"\" (for consistency across all vocabulary-like services). In the examples below, the ","type":"text"},{"text":"{person-auth-id}","type":"text","marks":[{"type":"em"}]},{"text":" parameter represents the CSID value of an existing PersonAuthority instance.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Create a Person in a PersonAuthority","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a new Person record. Assigns a unique, service-specified ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":" to that Person record. Follows standard Create model. See the documentation of the Person schema, below. Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"23b063f0-02bd-4bff-8521-e243443c1ec0"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"POST /cspace-services/personauthorities/{person-auth-id}/items HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"You may also POST a part called","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"a26814df-ac4d-4515-86c3-12002883f067"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"and any new relations there will be created. For example, this POST will add a relationship. Note that you must know beforehand the CSIDs of related terms. These are shown here as the values 33380624-7f46-4e7a-962c and 22280624-7f46-4e7a-962c. These are the CSIDs of two other Person records, which must exist before this call. The special variable ${itemCSID} will be expanded to the CSID of the newly created Person.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"cb0763e4-8d13-4158-a349-dfeffa2cb2b1"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ${inAuthority}","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ${shortIdentifier}","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" John Wayne","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" true","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" John","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Wayne","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" JW","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" accepted","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" hasBroader","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 33380624-7f46-4e7a-962c","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Person","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"

","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"text":": if you wish to ","type":"text"},{"text":"delete","type":"text","marks":[{"type":"strong"}]},{"text":" related items, simply send relations-common-list as an empty element. This is shown in a comment at the bottom of this page.","type":"text"},{"type":"hardBreak"},{"text":"see: ","type":"text"},{"text":"http://wiki.collectionspace.org/display/collectionspace/Person+Service+REST+APIs?focusedCommentId=72220749&#comment-72220749","type":"text","marks":[{"type":"link","attrs":{"href":"http://wiki.collectionspace.org/display/collectionspace/Person+Service+REST+APIs?focusedCommentId=72220749&#comment-72220749"}}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Read a Person in a PersonAuthority","type":"text"}]},{"type":"paragraph","content":[{"text":"Reads an existing Person record, specified by its ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":" or ","type":"text"},{"text":"Short Identifier","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052069"}}]},{"text":". Follows standard Read model. See the documentation of the Person schema, below. Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"0894594e-a30a-42d8-a046-286ec789ae58"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities/{person-auth-id}/items/{id} HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"There are additional query parameters to get the relations for this item.","type":"text"},{"type":"hardBreak"},{"text":"Query Parameters","type":"text","marks":[{"type":"strong"}]},{"text":" are defined and explained here, with examples: ","type":"text"},{"text":"Authority REST API for Hierarchies","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3580756009"}}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Update a Person in a PersonAuthority","type":"text"}]},{"type":"paragraph","content":[{"text":"Updates an existing Person record, specified by its ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":" or ","type":"text"},{"text":"Short Identifier","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052069"}}]},{"text":". Follows standard Update model. See the documentation of the Person schema, below. Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"f10f5368-9bbc-4ee4-b1fe-22b7f1b9125e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"PUT /cspace-services/personauthorities/{person-auth-id}/items/{id} HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"You may also PUT a part called","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"cd22bad2-550d-4bd9-812a-994315a29dfe"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"and any new relations there will be created. Relations to the updated item which are missing from the relations list in the PUT will be deleted from persistence. No target records are deleted, just the relations records that point to target records. e.g. POST to authority with Person \"Bill Jr.\", with relations-common-list that has an entry for ${itemCSID} hasBroader \"Bill Sr.\" creates a relations record that references both Bill Sr. and Bill Jr. When a PUT is made that does not have the relation for Bill Sr., then Bill Jr. has no relations, so the relations record for Bill Jr.==>hasBroader==>Bill Sr. is deleted, but both \"Bill Jr.\" and \"Bill Sr.\" Person records remain.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Delete a Person in a PersonAuthority","type":"text"}]},{"type":"paragraph","content":[{"text":"Deletes an existing Person record, specified by its ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":" or ","type":"text"},{"text":"Short Identifier","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052069"}}]},{"text":". Follows standard Delete model. Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"75b08333-671c-477b-8517-35b4faf0b58e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"DELETE /cspace-services/personauthorities/{person-auth-id}/items/{id} HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"List Person instances in a PersonAuthority","type":"text"}]},{"type":"paragraph","content":[{"text":"Lists existing Person records, with summary information for each. Follows standard List model. The PersonAuthority ({","type":"text"},{"text":"person-auth-id","type":"text","marks":[{"type":"code"}]},{"text":"}) may be specified using either a ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":" or ","type":"text"},{"text":"Short Identifier","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052069"}}]},{"text":", using the syntax described for Person read, above. To search for items in ","type":"text"},{"text":"all","type":"text","marks":[{"type":"em"}]},{"text":" PersonAuthorities (vocabularies within a PersonAuthority), use ","type":"text"},{"text":"_ALL_","type":"text","marks":[{"type":"code"}]},{"text":". See the documentation of the PersonItem-List schema, below.","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns the items in a particular PersonAuthority:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"8d17b2ba-b886-4f03-b088-0101cf1305e2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities/{person-auth-id}/items HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Returns the items across all PersonAuthorities (i.e. across all vocabularies within a PersonAuthority):","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"88c54792-7d62-4831-9785-663271e024d5"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities/_ALL_/items HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"List supports query parameters for customizing list results, such as pagination controls, query filters, and sorting options. For example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"246ec85a-d374-4bd2-ad37-e7765fecaaf2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities/{person-auth-id}/items?pgSz=10 HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"List also supports query parameters for searching for matching records, including:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"keyword search","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"partial term matching search, for term completion","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"term status filtering, to exclude (filter out) records matching one or more statuses","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"9b3224b7-afb2-410a-903b-4bf95d7c6672"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities/{person-auth-id}/items?pt=foo&pgSz=10 HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Person REST payload schemas","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The schemas below are abbreviated, and are thus illustrative. For a full list of the fields that may potentially be present in payloads when creating, updating, or reading individual Person records, please see ","type":"text"},{"text":"the most recent Person schema (i.e. for an individual Person term within a PersonAuthority or vocabulary)","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/collectionspace/services/blob/master/services/person/3rdparty/nuxeo-platform-cs-person/src/main/resources/schemas/persons_common.xsd"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Person instance schema","type":"text"}]},{"type":"paragraph","content":[{"text":"Create and Update should use the following schema.","type":"text"}]},{"type":"paragraph","content":[{"text":"On create, the value of ","type":"text"},{"text":"inAuthority","type":"text","marks":[{"type":"em"}]},{"text":" must match the identifier of the parent PersonAuthority, and will not be modified once the instance is created.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can view the full set of validation constraints on the data you submit when creating or updating Person instance records, in the most recent CollectionSpace code, via this ","type":"text"},{"text":"Java source code file","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/collectionspace/services/blob/master/services/person/service/src/main/java/org/collectionspace/services/person/nuxeo/PersonValidatorHandler.java"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Here's an example payload for creating a new instance:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"49c2fffc-90ec-47ed-9c56-107e880dc9b2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" e5c217c5-26ad-4289-b778","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" John Wayne","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" true","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" John","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Wayne","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" JW","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" accepted","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" true","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" May 26, 1907","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 1907","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 26","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 5","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" true","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" June 11, 1979","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 1979","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 11","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 6","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" urn:cspace:core.collectionspace.org:placeauthorities:name(place):item:name(IA_Winterset)'Winterset, Iowa'","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" born Marion Robert Morrison and better","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" known by his stage name John Wayne, was an American film actor, director","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" and producer. He epitomized rugged masculinity and has become an enduring","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" American icon. He is famous for his distinctive voice, walk and height.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" He was also known for his conservative political views and his support in","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" the 1950s for anti-communist positions.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Screen name","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Read will return the above, plus additional fields (","type":"text"},{"text":"uri","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"csid","type":"text","marks":[{"type":"em"}]},{"text":") for access:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"9f088c52-c10d-4f80-9ded-e4cef0353bab"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" /personauthorities/f0cf4c50-8f8a-4df0-869a/items/a256aed3-0b0a-44e6-84b0","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" a256aed3-0b0a-44e6-84b0","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Related Person term records","type":"text"}]},{"type":"paragraph","content":[{"text":"As of v1.7, Authorities return list items of related terms in a new part. NOTE the new section called","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"f7cd2773-24b2-4742-b5ff-31300bbb534e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Here is a payload for a POST or PUT to /cspace-services/personauthorities/{csid}/items/{person-csid}","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"db169a33-90e6-4af0-b863-4cd5d26ec628"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ${inAuthority}","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ${shortIdentifier}","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" John Wayne","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" true","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" John","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Wayne","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" JW","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" accepted","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" /relations/b33de521-bb8b-4a2a-b5b1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" b33de521-bb8b-4a2a-b5b1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" hasBroader","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 3f31e7c5-24cf-44ec-8443","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Person","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"

","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"NOTE: the special variable ${itemCSID} will be expanded to the CSID generated for the current AuthorityItem. (For Java use, please use the constant in ","type":"text"},{"text":"CommonAPI","type":"text","marks":[{"type":"link","attrs":{"href":"http://wiki.collectionspace.org/display/collectionspace/ServicesCommonAPI"}}]},{"text":".AuthorityItemCSID_REPLACE )","type":"text"},{"type":"hardBreak"},{"text":"So if you POST to personauthorities and you include relations-common-list, then the item is the person you posted, so it gets created first, then in all the relations listed in relations-common-list, they refer to that item.","type":"text"}]},{"type":"paragraph","content":[{"text":"The elements are documented in the Relations service REST APIs:","type":"text"},{"type":"hardBreak"},{"text":"Relationship Service RESTful APIs","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3580756047"}}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Person-List schema","type":"text"}]},{"type":"paragraph","content":[{"text":"List (and variants) will return the following schema.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"07652d9b-ffc7-4d87-b6fb-a85837c1b13a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 0","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 40","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 3","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 3","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" csid|uri|updatedAt|workflowState|foreName|surName|termDisplayName|shortIdentifier|refName|termStatus","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Fred Jackson","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" urn:cspace:core.collectionspace.org:personauthorities:name(person):item:name(FredJackson1342809753068)'Fred Jackson'","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" /personauthorities/f0cf4c50-8f8a-4df0-869a/items/a256aed3-0b0a-44e6-84b0","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" a256aed3-0b0a-44e6-84b0","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Contact CRUD+L services","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Each Person may have one or more instances of Contacts.","type":"text"}]},{"type":"paragraph","content":[{"text":"Contacts are only accessible via the owning Person. The sub-resource is accessed with \"contacts\". In the examples below, the {","type":"text"},{"text":"person-auth-id","type":"text","marks":[{"type":"code"}]},{"text":"} parameter represents the ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":" or ","type":"text"},{"text":"Short Identifier","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052069"}}]},{"text":" of an existing PersonAuthority instance, and the {","type":"text"},{"text":"person-id","type":"text","marks":[{"type":"code"}]},{"text":"} represents the ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":" or ","type":"text"},{"text":"Short Identifier","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052069"}}]},{"text":" of an existing Person item.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Create a Contact for a Person","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a new Contact record for a Person. Assigns a unique, service-specified ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":" to that Contact record. Follows standard Create model. See the documentation of the Contact schema, below. Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"beeff7a8-bd1e-4f3f-9ef5-17e52944db66"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"POST /cspace-services/personauthorities/{person-auth-id}/items/{person-id}/contacts HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Read a Contact for a Person","type":"text"}]},{"type":"paragraph","content":[{"text":"Reads an existing Contact record for a Person, specified by its ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":". Follows standard Read model. See the documentation of the Contact schema, below. Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b51f9f53-aaf5-4b3d-aa39-d9a5f022dd2c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities/{person-auth-id}/items/{person-id}/contacts/{id} HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Update a Contact for a Person","type":"text"}]},{"type":"paragraph","content":[{"text":"Updates an existing Contact record for a Person, specified by its ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":". Follows standard Update model. See the documentation of the Contact schema, below. Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"8a19c236-eba5-4389-9052-f80f5a2911ec"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"PUT /cspace-services/personauthorities/{person-auth-id}/items/{person-id}/contacts/{id} HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Delete a Contact for a Person","type":"text"}]},{"type":"paragraph","content":[{"text":"Deletes an existing Contact record for a Person, specified by its ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":". Follows standard Delete model. Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"3ef67485-803b-4e19-a8e1-d564324f7618"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"DELETE /cspace-services/personauthorities/{person-auth-id}/items/{person-id}/contacts/{id} HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"List Contacts for a Person","type":"text"}]},{"type":"paragraph","content":[{"text":"Lists existing Contact records for a Person, with summary information for each. Follows standard List model. The PersonAuthority ({","type":"text"},{"text":"person-auth-id","type":"text","marks":[{"type":"code"}]},{"text":"}) and PersonItem ({","type":"text"},{"text":"person-id","type":"text","marks":[{"type":"code"}]},{"text":"}) may be specified either a ","type":"text"},{"text":"CollectionSpace ID (CSID)","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":" or ","type":"text"},{"text":"Short Identifier","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052069"}}]},{"text":", using the syntax described for Person read, above. To search for contacts in ","type":"text"},{"text":"all","type":"text","marks":[{"type":"em"}]},{"text":" PersonAuthorities (vocabularies within a PersonAuthority), use ","type":"text"},{"text":"_ALL_","type":"text","marks":[{"type":"code"}]},{"text":" for the {","type":"text"},{"text":"person-auth-id","type":"text","marks":[{"type":"code"}]},{"text":"}. See the documentation of the Contact-List schema, below.","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"fccab5cc-267c-4f35-97e5-168e9ed1c044"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities/{person-auth-id}/items/{person-id}/contacts HTTP/1.1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"GET /cspace-services/personauthorities/{person-auth-id}/items/{person-id}/contacts?pt=foo&pgSz=10 HTTP/1.1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Contact REST payload schemas","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The schemas below are severely abbreviated, and are thus illustrative. For a full list of the fields that may potentially be present in payloads when creating, updating, or reading individual Contact sub-resource records, please see ","type":"text"},{"text":"the Contact record schema for release 0.8","type":"text","marks":[{"type":"link","attrs":{"href":"http://fisheye.collectionspace.org/browse/collectionspace/src/services/trunk/services/contact/jaxb/src/main/resources/contacts-common.xsd"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Contact Instance schema","type":"text"}]},{"type":"paragraph","content":[{"text":"Create and Update should use the following schema.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"2e136bc4-fb4f-422d-8f90-655f95998ac2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" email@example.com","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 315 El Centro Pl.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Read will return the above, as well. The example below shows the full set of attributes returned on the root element:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ac540944-bc0e-4398-b61b-2839660f57f4"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 7c2ddebe-1ccf-4908-bb9e","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 7e5f5d6b-b92f-4e53-88d7","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" email@example.com 315 El ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" email@example.com","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 315 El Centro Pl.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Contact List schema","type":"text"}]},{"type":"paragraph","content":[{"text":"List (and variants) will return the following schema.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"664d174d-48b7-49b0-8523-de631443de72"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 0","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 40","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 3","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" /personauthorities/7c2ddebe-1ccf-4908-bb9e/items/7e5f5d6b-b92f-4e53-88d7/contacts/6ef7e4ae-f821-4235-990b","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" 6ef7e4ae-f821-4235-990b","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" email@example.com 315 El ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported