List

Description

Retrieve a list of case actions for a specific case.

Request

HTTP Method: GET

Path Parameter Description
case_id The ID of the case.
per_page Optional Set the number of results returned per page. Defaults to 20.
page Optional Specify the page of results to return if there are multiple pages. Defaults to page 1.

Sample request

curl -X GET \
  https://<<META.tenant.domain>>/api/v2/cases/<<case_id>>/actions \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'

Response

A successful request will return a JSON Array containing the case actions on the specified case provided the requesting token has access to it.

Field description

Parameter Description
case_id The ID of the case.
id The case action ID.
url The URL of the case action.
label The label of the case action.
action_type The case action type (webhook or page).
action_text The text for the button to execute the action.
story_name Will be populated if the URL matches that of a page or webhook in an existing story.
story_emoji The associated story's emoji icon.
created_at ISO 8601 Timestamp representing creation date and time of the case action.
updated_at ISO 8601 Timestamp representing last updated date and time of case action.

Sample response

{
  "case_id": 1,
  "actions": [
    {
      "id": 1,
      "url": "https://tenant.tines.com/webhook/abc/",
      "label": "Claim case",
      "story_name": "Case Management",
      "story_emoji": ":fire:",
      "action_type": "webhook",
      "action_text": "Open form",
      "created_at": "2023-10-31T15:42:00Z",
      "updated_at": "2023-10-31T16:42:00Z"
    },
    {
      "id": 2,
      "url": "https://tenant.tines.com/webhook/abc/",
      "label": "Escalate",
      "story_name": "Case Management",
      "story_emoji": ":rocket:",
      "action_type": "webhook",
      "action_text": "Open page",
      "created_at": "2023-10-31T17:42:00Z",
      "updated_at": "2023-10-31T18:42:00Z"
    }
  ],
  "meta": {
    "count": 2,
    "current_page": "https://<<META.tenant.domain>>/api/v2/cases/1/actions?per_page=20&page=1",
    "next_page": null,
    "pages": 1,
    "per_page": 20,
    "previous_page": null
  }
}
Was this helpful?