9008: Reconnect entities

Replace the currently connected entities with a new array of entities. All previous connections will be removed for the content and the new array of entities connected instead.

Endpoint ID:

9008

Method:

PUT

URL:

/content/tagged/connect/{content-id}

content-id Numeric value that identifies content. This identifier is returned from endpoint 9001: Create content

Request body:

JSON data containing an array of entities - either entityIDs or extKeys & extType

Required fields:
	entityIDs	An array of Rubiq entity IDs that uniquely identify entities
or
	extKeys	An array of external keys that uniquely identify entities
	extType	Type of external keys

Example 1

{
   "entityIDs": [ 123, 234, 456, 567, 789 ]
}

Example 2

{
   "extKeys": [ "someone@somewhere.com", "someone_else@somewhere.com" ],
   "extType": 1005
}

Response body:

A JSON object containing a count of the number of entities connected to the content. If this does not match the number of entities in the request array, it means some of the entities do not exist in the database.

Example

{
   "count": 5
}

Status codes:

200

OK

404.4 Content not found