Get Started
Application
Equipment
Comment
Request
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>",
"description": "<string>",
"priority": "low",
"target_uid": "<string>",
"requested_by_uid": "<string>",
"assignee_admin_uid": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z"
}
]
}'{
"results": [
{
"uid": "<string>",
"title": "<string>",
"description": "<string>",
"priority": "low",
"submitted_from": "employee_portal",
"author_uid": "<string>",
"requested_by_uid": "<string>",
"assignee_admin_uid": "<string>",
"assignee_inbox_uid": "<string>",
"target_uid": "<string>",
"admin_permalink_url": "<string>",
"mode": "private",
"status": "open",
"friendly_id": "<string>",
"slack_channel_id": "<string>",
"slack_thread_ts": "<string>",
"slack_ts": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"completed_by_uid": "<string>",
"tag_uids": [
"<string>"
],
"custom_form_inputs": [
{
"label": "<string>",
"kind": "attachment",
"value": "<string>"
}
],
"sla_data": {
"first_replied_at": "2023-11-07T05:31:56Z",
"first_completed_at": "2023-11-07T05:31:56Z"
},
"updated_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z"
}
]
}Introduction
This endpoint allows you to import previous requests (e.g., from another ticketing system).
Please note that:
- These requests will be imported with a
resolvedstatus. - You can override the
created_atfield. - You can import up to 200 requests at once.
- Any row that fails to import will abort the whole process.
- Workflows won’t be triggered.
- Notifications won’t be sent out.
- Imported records will appear as if they were created from the Admin Dashboard.
Usage
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The UID of the requester.
low, medium, high The UID of the associated Service or Application.
The UID of assigned User (Must be a Siit admin)
datetime formatted as ISO 8601 (e.g. "2020-12-15T03:34:13.000Z")
datetime formatted as ISO 8601 (e.g. "2020-12-15T03:34:13.000Z")
Response
The UID of the Request.
The title of the Request
The description of the Request
low, medium, high Describes how the request was submitted.
employee_portal, slack, mail, ms_teams, admin_dashboard, workflow, public_api, external The UID of the author.
The UID of the requester.
The UID of assigned User
The UID of assigned Team inbox
The UID of the associated Service/Application.
The link to the request in Siit admin dashboard.
Will be "public" only for Slack public threads (for now).
private, public Request status
open, in_progress, waiting, resolved, archived A friendly ID (REQ-xx) where xx is a sequential number
ID of the channel where the request was created.
Slack thread timestamp.
Slack timestamp.
datetime formatted as ISO 8601 (e.g. "2020-12-15T03:34:13.000Z")
The UID of the user that completed this request.
Array containing the Request tags UIDs.
Custom forms attached to this request.
The label of the custom form.
The type of the field.
attachment, string, text, number, datepicker, select, select_application, select_department, select_equipment, select_legal_entity, select_office_location, select_team, select_people The value for the field.
A Hash containing SLA data (only sent when Company has access to the feature).
datetime formatted as ISO 8601 (e.g. "2020-12-15T03:34:13.000Z")
datetime formatted as ISO 8601 (e.g. "2020-12-15T03:34:13.000Z")
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>",
"description": "<string>",
"priority": "low",
"target_uid": "<string>",
"requested_by_uid": "<string>",
"assignee_admin_uid": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z"
}
]
}'{
"results": [
{
"uid": "<string>",
"title": "<string>",
"description": "<string>",
"priority": "low",
"submitted_from": "employee_portal",
"author_uid": "<string>",
"requested_by_uid": "<string>",
"assignee_admin_uid": "<string>",
"assignee_inbox_uid": "<string>",
"target_uid": "<string>",
"admin_permalink_url": "<string>",
"mode": "private",
"status": "open",
"friendly_id": "<string>",
"slack_channel_id": "<string>",
"slack_thread_ts": "<string>",
"slack_ts": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"completed_by_uid": "<string>",
"tag_uids": [
"<string>"
],
"custom_form_inputs": [
{
"label": "<string>",
"kind": "attachment",
"value": "<string>"
}
],
"sla_data": {
"first_replied_at": "2023-11-07T05:31:56Z",
"first_completed_at": "2023-11-07T05:31:56Z"
},
"updated_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z"
}
]
}