Delete

Description

Delete one or more links between actions. All links must belong to the same story.

Request

HTTP Method: DELETE

Parameter Description
links An array of link objects to delete. Each object must include source_id and receiver_id.
source_id The ID of the source action.
receiver_id The ID of the receiver action.

Sample request

curl -X DELETE \
  https://<<META.tenant.domain>>/api/v1/links \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>' \
  -d '{
        "links": [
          {
            "source_id": "123",
            "receiver_id": "456"
          }
        ]
      }'

Bulk delete

Multiple links can be deleted in a single request. All links must belong to the same story.

curl -X DELETE \
  https://<<META.tenant.domain>>/api/v1/links \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>' \
  -d '{
        "links": [
          {
            "source_id": "123",
            "receiver_id": "456"
          },
          {
            "source_id": "456",
            "receiver_id": "789"
          }
        ]
      }'

Response

A successful request will return an empty response with a 204 status code.

Was this helpful?