Skip to main content
POST
/
v1
/
requests
/
batch_import
Import past Requests
curl --request POST \
  --url https://api.siit.io/v1/requests/batch_import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "title": "<string>",
      "requested_by": "<string>",
      "description": "<string>",
      "priority": "low",
      "target_uid": "<string>",
      "assignee_admin": "<string>",
      "completed_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "custom_form_inputs": [
        {
          "label": "<string>",
          "value": "<string>"
        }
      ],
      "messages": [
        {
          "body_text": "<string>",
          "kind": "message",
          "sent_by": "<string>",
          "created_at": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ]
}
'
{
  "results": [
    {
      "uid": "<string>",
      "admin_permalink_url": "<string>",
      "archived_at": "2023-11-07T05:31:56Z",
      "assignee_admin": "<string>",
      "assignee_admin_uid": "<string>",
      "assignee_inbox": "<string>",
      "assignee_inbox_uid": "<string>",
      "associated_apps": [
        "<string>"
      ],
      "associated_equipments": [
        "<string>"
      ],
      "attachments": [
        {
          "filename": "<string>",
          "url": "<string>"
        }
      ],
      "author": "<string>",
      "author_uid": "<string>",
      "completed_at": "2023-11-07T05:31:56Z",
      "completed_by": "<string>",
      "completed_by_uid": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "custom_form_inputs": [
        {
          "kind": "attachment",
          "label": "<string>",
          "value": "<string>"
        }
      ],
      "description": "<string>",
      "follower_uids": [
        "<string>"
      ],
      "followers": [
        "<string>"
      ],
      "friendly_id": "<string>",
      "mode": "private",
      "priority": "low",
      "requested_by": "<string>",
      "requested_by_uid": "<string>",
      "slack_channel_id": "<string>",
      "slack_direct_link": "<string>",
      "slack_thread_ts": "<string>",
      "slack_ts": "<string>",
      "sla_data": {
        "first_completed_at": "2023-11-07T05:31:56Z",
        "first_replied_at": "2023-11-07T05:31:56Z"
      },
      "status": "open",
      "submitted_from": "employee_portal",
      "tag_uids": [
        "<string>"
      ],
      "tags": [
        "<string>"
      ],
      "target": "<string>",
      "target_uid": "<string>",
      "title": "<string>",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}

​
Introduction

This endpoint allows you to import previous requests (e.g., from another ticketing system). Please note that:
  1. These requests will be imported with a resolved status.
  2. You can override the created_at field.
  3. You can import up to 200 requests at once.
  4. Any row that fails to import will abort the whole process.
  5. Workflows won’t be triggered and Notifications won’t be sent out. Even if you re-open said requests.
  6. Imported records will appear as if they were created from the Admin Dashboard.
  7. Specifically on this endpoint you can reference users by email instead of UID, but note that this will create the users

​
Example payload

{
    "items": [
        {
            "title": "Request created via Import: lorem ipsum",
            "description": "Note that workflows don't run and notifications arent fired",
            "requested_by": "u_4h72qjma",
            "messages": [
                {
                    "body_text": "Hello this is a message",
                    "kind": "message",
                    "sent_by": "u_4h72qjma",
                    "created_at": "2026-02-27 20:55"
                },
                {
                    "body_text": "This is a note",
                    "kind": "note",
                    "sent_by": "dimitri@siit.io",
                    "created_at": "2026-02-27 21:00"
                },
                {
                    "body_text": "I can also create a user via this call",
                    "kind": "message",
                    "sent_by": "createme@siit.io",
                    "created_at": "2026-02-27 22:00"
                }
            ],
            "completed_at": "2026-02-27 23:42",
            "created_at": "2026-02-27 20:50",
            "custom_form_inputs": [
                {
                    "label": "This is an arbitrary label",
                    "value": "This is the value"
                },
                {
                    "label": "Old System Request ID",
                    "value": 42
                }
            ]
        }
    ]
}

​
Usage

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
items
object[]
required
Maximum array length: 200

Response

Request created

​
results
object[]