Delete Relationship Instance (Hub Data)

[This topic is pre-release documentation and is subject to change.]

Deletes an existing instance of an custom Relationship type within the specified Hub.

Request

The request is constructed as follows:

HTTP Verb Request URI
POST <hub-endpoint>/data/Relationships?api-version=2017-04-26

And must include the following custom HTTP request header: X-HTTP-Method: DELETE

URI Parameters

URI Parameter Required Description
Hub-endpoint Yes The base URL for your Customer Insights Hub

Request Body

A JSON object describing the custom Relationship type instance, of the form:

{
    "ProfileStrongIdFieldMappings" :[
    {
        "FieldName": "<Field in the relationshipDefinition that refers to strongId Key property of Profile>", 
        "StrongIdKeyProperty": "<Specifies the strongId Key Property of Profile>"
    } ],
    "RelatedProfileStrongIdFieldMappings" :[
    {
        "FieldName": "<Field in the relationshipDefinition that refers to strongId Key property of Related Profile>", 
        "StrongIdKeyProperty": "<Specifies the strongId Key Property of Profile>"
    } ],
    "RelationshipType" :"<Relationship TypeName for which we are posting the instance>",

    <Fields in RelationshipDefinition>
}


Response

The response includes an HTTP status code, a response body and a set of response headers.

Status Code

  • 200 (OK) - Instance deleted successfully.