Skip to main content
POST
Import past Requests

Introduction

This endpoint allows you to import previous requests (e.g., from another ticketing system). Please note that:
  1. The imported status is derived from the payload: if completed_at is present the request is imported as resolved, otherwise it stays open.
  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. By default imported records appear as if they were created from the Admin Dashboard by the current user identified by the API key. You can set submitted_from to employee_portal to preserve the request’s portal origin — this is the surface on which the requester can continue the conversation.
  7. Specifically on this endpoint you can reference users by email instead of UID, but note that this will create the users
  8. Imports can be made idempotent: provide an import_source (a stable namespace, e.g. the name of the source system) together with an external_id on each request, message, and attachment. Re-running the same import will then not create duplicate requests, messages, or attachments. Deleting an imported attachment in Siit keeps its identity, so a rerun won’t resurrect it.
  9. You can attach files to requests and messages: pass a publicly reachable HTTPS url (e.g. a pre-signed URL from your source system or bucket) together with a filename and an external_id, and Siit downloads the file during the import. Files are limited to 25 MB each and 20 attachments per request or message; the MIME type is taken from the optional content_type field, the download response, or the file extension.

Example payload

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

The requests to import. At most 500 attachments can be downloaded across the whole batch, all requests and messages combined. Attachments are fetched while the request is open and the batch is rejected if those downloads take too long, so prefer several smaller calls over one large one when importing many or large files.

Maximum array length: 200
import_source
string

Stable namespace used with external_id values to make an import idempotent.

Response

Request created

results
object[]