Preferred Parent Relationship

Description

The Preferred Parent Relationship resource is used to read and to update a user's preferred relationship to a parent for a person.

Data Formats

If you make a GET request, specify the data format using the Accept header.

If you POST something, specify the media type using the Content-Type header.

Parameters

Name Type Description
Location header URI for the preferred parent relationship
Authorization header The authorization carrying the OAuth 2.0 access token. See OAuth 2.0 Bearer Tokens.
uid path The id of the user.
pid path The id of the person.
access_token query The ID of the OAuth 2 access token used for identification and authorization of the user (and agent) making the request.

Operations

HEAD - Read the headers for a preferred parent relationship.

Status Codes
204 No preference specified.
301 If the person has been merged into another person.
303 Upon a successful read.
404 If the person is not found.
410 If the person has been deleted.

GET - Read a reference to a preferred relationship.

Status Codes
204 No preference specified.
301 If the person has been merged into another person.
303 Upon a successful read.
404 If the person is not found.
410 If the person has been deleted.
429 If the request was throttled.

PUT - Set a reference to a preferred relationship.

Status Codes
204 The update was successful.
301 If the person has been merged into another person.
404 If the person is not found.
410 If the person has been deleted.
429 If the request was throttled.

DELETE - Delete a reference to a preferred relationship.

Status Codes
204 The delete was successful.
404 If the requested preferred parent relationship reference is not found.
429 If the request was throttled.

Example Requests

Read Preferred Parent Relationship How to read a user's preferred parent relationship for a person.
Update Preferred Parent Relationship How to set a user's preferred parent relationship for a person.
Delete Preferred Parent Relationship How to delete a user's preferred parent relationship for a person.