---
title: Export
url: https://www.tines.com/docs/api/cases/case_templates/export/
updated: 2026-05-26T15:16:07+00:00
description: Export a case template to a transferable JSON file. The result can be loaded with the [import](/api/cases/case_templates/import) endpoint to recreate the template on the same tenant or on another tenant.
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/llms.txt) › [Tines API](https://www.tines.com/llms.txt) › [Cases](https://www.tines.com/llm/docs/api/cases.md) › [Case templates](https://www.tines.com/llm/docs/api/cases/case_templates.md)*

# Export

*[View on tines.com](https://www.tines.com/docs/api/cases/case_templates/export/)*

## Description

Export a case template to a transferable JSON file. The result can be loaded with the [import](/api/cases/case_templates/import) endpoint to recreate the template on the same tenant or on another tenant.

## Request

HTTP Method: **GET**

| Path Parameter | Description                            |
| -------------- | -------------------------------------- |
| id             | The ID of the case template to export. |

```bash
curl -X GET \
  https://<tenant-domain>/api/v1/case_templates/<<id>>/export \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'
```

## Response

A successful request will return a JSON object representing the case template in exported form.

### Field description

| Parameter      | Description                                                     |
| -------------- | --------------------------------------------------------------- |
| schema_version | Version of the case template export schema.                     |
| exported_at    | ISO 8601 timestamp representing when the template was exported. |
| templates      | An array of exported case templates.                            |

Each entry in `templates` contains:

| Parameter         | Description                                                                                                              |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------ |
| name              | The case template name.                                                                                                  |
| emoji             | The emoji associated with the case template.                                                                             |
| options           | An object describing the case template configuration. See [Options fields](#options-fields) below.                       |
| input_values      | An array of case input values defined on the template, referenced by field slug.                                         |
| field_definitions | An array describing the case input fields referenced by the template, so the template can be imported into another team. |

### Options fields

| Parameter          | Description                                                                                                                                                                                                                                                                                                                   |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| case_name          | **Optional** The case name template. May contain field mentions written as `<@case_input-slug:my_field>` or `:case_input{#slug:my_field}`, which are rewritten to use IDs on import.                                                                                                                                          |
| case_description   | **Optional** The case description template. Supports markdown and field mentions, which are rewritten to use field slugs on export and back to IDs on import.                                                                                                                                                                 |
| priority           | **Optional** The case priority - critical, high, medium, low or info.                                                                                                                                                                                                                                                         |
| tag_names          | **Optional** An array of tag name strings. Tag IDs from the source team are resolved to names on export and recreated on the destination team on import.                                                                                                                                                                      |
| sub_status         | **Optional** An object describing the case sub-status, with keys `name`, `parent_status` (`open` or `closed`), and `icon`. Resolved from the source team's sub-status ID on export and matched or created on import.                                                                                                          |
| assignee_emails    | **Optional** An array of user email addresses. Assignee IDs stored on the template are resolved to emails on export so the template can round-trip across tenants. Formula entries are preserved.                                                                                                                             |
| team_case_buttons  | **Optional** An array of button objects for downstream actions associated with the case. Each object has `button_type` (one of `webhook`, `story`, `page`, or `url`), `url` (tenant-specific webhook URLs may need updating after import to another tenant), `label` (tooltip), and `button_text` (text shown on the button). |
| blocks             | **Optional** An array of block objects associated with the case. Each object has `block_type`, `title`, and an `elements` array whose shape varies by `block_type`. Field mentions inside block element `content` are rewritten to use field slugs on export.                                                                 |
| team_case_tasks    | **Optional** An array of task objects associated with the case. Each object has `description` and an optional `assignee_emails` array; assignee IDs stored on the task are resolved to emails on export.                                                                                                                      |
| closure_conditions | **Optional** An array of closure requirements in the form of a set of formula rules that need to evaluate to true to enable the closing of a case. Each entry has a `name` and a `formula`.                                                                                                                                   |
| metadata           | **Optional** Case-related metadata represented as key-value pairs.                                                                                                                                                                                                                                                            |

### Sample response

<!-- cspell:disable -->

```json
{
  "schema_version": 1,
  "exported_at": "2026-05-25T10:00:00Z",
  "templates": [
    {
      "name": "Phishing investigation",
      "emoji": "🎣",
      "options": {
        "case_name": "Phishing report for <<recipient>>",
        "case_description": "Investigate reported phishing email from <@case_input-slug:reporter_email>.",
        "priority": "high",
        "tag_names": ["phishing", "email"],
        "sub_status": {
          "name": "Triage",
          "parent_status": "open",
          "icon": "in_progress"
        },
        "assignee_emails": ["analyst@example.com"],
        "team_case_buttons": [
          {
            "button_type": "page",
            "url": "https://tenant.tines.com/pages/55e94b9b4e26175051c0287f4259363f/",
            "label": "Isolate host and give reason",
            "button_text": "Open form"
          }
        ],
        "blocks": [
          {
            "title": "Investigation notes",
            "block_type": "note",
            "elements": [
              {
                "content": "Initial triage required for reporter <@case_input-slug:reporter_email>.",
                "note_type": "text",
                "color": "gold"
              }
            ]
          }
        ],
        "team_case_tasks": [
          {
            "description": "Review headers and attachments",
            "assignee_emails": ["analyst@example.com"]
          }
        ],
        "closure_conditions": [
          {
            "name": "has at least 1 assignee",
            "formula": "=SIZE(team_case.assignees) > 0"
          }
        ],
        "metadata": {
          "source": "user_report"
        }
      },
      "input_values": [
        {
          "field_slug": "reporter_email",
          "value": "user@example.com"
        }
      ],
      "field_definitions": [
        {
          "slug": "reporter_email",
          "name": "Reporter email",
          "input_type": "string",
          "sensitive": false
        }
      ]
    }
  ]
}
```

<!-- cspell:enable -->
