Person Discussion References

Description

The Person Discussion References resource defines a collection of discussion references attached to a person.

As of June 27, 2016 this resource is deprecated because discussion references are automatically included in the Person resource. Starting December 6, 2016, the consolidate-redundant-resources pending modification will be activated and this resource will redirect to the Person resource.

Data Formats

Readable

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

Writable

If you POST something, specify the data format using the Content-Type header.

Parameters

Name Type Description
Authorization header The authorization carrying the OAuth 2.0 access token. See OAuth 2.0 Bearer Tokens.
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

GET - Read the references to discussions.

Status Codes
200 Upon a successful read.
204 Upon a successful read with no results.
301 If the person has been merged into another person.
404 If the requested resource is not found.
404 If the person is not found.
410 If the person has been deleted.
429 If the request was throttled.

POST - Create a discussion reference.

Status Codes
201 The creation of the reference to the discussion was successful. Expect a location header specifying the link to the created discussion reference.
404 If the specified resource for the discussions is not found.
429 If the request was throttled.

Example Requests

Create Discussion Reference (Starting December 2016) An example of an attempt to create a discussion reference after the "consolidate-redundant-resources" modification is activated in December 2016.
Read Discussion References (Deprecated) How to get list of discussions attached to a person.
Read Discussion References (Starting December 2016) An example of an attempt to read discussion references after the "consolidate-redundant-resources" modification is activated in December 2016.
x

Select a language