Link Task

Link a conversation, ticket, feedback, message or knowledge update request. Linking twice is a no-op.

POST /api/v1/tasks/{task_id}/links

Link Task

cURL

curl --request POST \
  --url https://{tenant_id}.api.useago.com/api/v1/tasks/{task_id}/links \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "target_type": "conversation",
  "target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

201

{
  "id": "<string>",
  "target_type": "<string>",
  "target_id": "<string>",
  "context": {
    "conversation_id": "<string>",
    "message_id": "<string>"
  },
  "deleted": true,
  "admin_url": "<string>"
}

Authorizations

X-API-Key · string · header · required

Path Parameters

task_id · string · required

Task UUID or identifier such as TASK-12

Body

application/json

target_type · string · required

conversation, ticket, feedback, message, or knowledge_update_request

Example:

"conversation"

target_id · string<uuid> · required

Response

201 - application/json

Created

id · string · required

target_type · string · required

target_id · string · required

context · TaskLinkContext · object · required

Show child attributes

deleted · boolean · required

True when the linked record was deleted; the link stays as history.

admin_url · string | null