Delete Link Table

This endpoint deletes an existing link table object, specified by link table name.

Note: The Responsys Advanced API is generally available for all Responsys customers.

Service URL:

/rest/api/v1.3/folders/{folderName}/linkTables/{linkTableName}

Required Path Parameters:

folderName – The name of the folder in Responsys where you want to delete the link table.

linkTableName – The link table name to be deleted.

Request Method:

DELETE

Request Header:

Authorization=<AUTH_TOKEN>

Content-Type=application/json

Request Body - Required Properties:

description – A description of the link table.

Sample Request Body

Not applicable

Sample Response Body - Success

{
  "message": "Link Table has been deleted",
  "status": true,
  "links": [
    {
      "rel": "self",
      "href": "/rest/api/v1.3/folders/Folder_Name/linkTables/New_Link_Table",
      "method": "DELETE"
    },
    {
      "rel": "createLinkTable",
      "href": "/rest/api/v1.3/folders/Folder_Name/linkTables/New_Link_Table",
      "method": "POST"
    },
    {
      "rel": "mergeLinkRecords",
      "href": "/rest/api/v1.3/folders/Folder_Name/linkTables/New_Link_Table/members",
      "method": "POST"
    },
    {
      "rel": "deleteLinkRecords",
      "href": "/rest/api/v1.3/folders/Folder_Name/linkTables/New_Link_Table/members",
      "method": "DELETE"
    }
  ]
}

Sample Response Body - Failure

400 Bad Request

Link table name is not valid: Requests fail if the link table name contains an unsupported character. Supported characters are: A-Z a-z 0-9 space ! - = @ _ [ ] { }:

{
  "type": "",
  "title": "Invalid link table name",
  "errorCode": "INVALID_TABLE_NAME",
  "detail": "The link table name is not valid",
  "errorDetails": []
}

404 Not Found

The folder name is not found: If the folder name is missing or invalid the error will resemble the following:

{
  "type": "",
  "title": "Folder not found",
  "errorCode": "FOLDER_NOT_FOUND",
  "detail": "The Folder name is not found",
  "errorDetails": []
}

Link Table not found: Requests fail if the specified link table name can’t be found in Responsys. The error resembles:

{
  "type": "",
  "title": "Link Table not found",
  "errorCode": "LINK_TABLE_NOT_FOUND",
  "detail": "The Link Table is not found",
  "errorDetails": []
}

500 Internal Server Error

Unexpected Exception: Requests may fail if there are issues with the database. These are rare occurrences. If this happens, retry the request. The error resembles:

{
  "type": "",
  "title": "Unexpected exception",
  "errorCode": "UNEXPECTED_EXCEPTION",
  "detail": "Unexpected exception",
  "errorDetails": []
}

401 Unauthorized

API limit exceeded: When the client application exceeds the throttling limit for this API, a 401 Unauthorized error is returned with the following error response body. Refer to Get Throttling Limits to learn more. Error resembles:

{
  "type": "",
  "title": "",
  "errorCode": "API_LIMIT_EXCEEDED ",
  "detail": "",
  "errorDetails": []
}