Get Started
Application
Equipment
Comment
Request
Update assignees
Please note that assignee admin must be part of the assignee_inbox
curl --request PATCH \
--url https://api.siit.io/v1/requests/{uid}/assignee \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"assignee_inbox_uid": "<string>",
"assignee_admin_uid": "<string>",
"sent_by_uid": "<string>"
}'
{
"result": {
"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"
}
}
Usage
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
The UID of the request
Body
UID of a tag of kind "request_inbox"
UID of an ADMIN user
UID of the ADMIN user that should be considered as author of the action. Please note only the "Owner" account can use this.
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 PATCH \
--url https://api.siit.io/v1/requests/{uid}/assignee \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"assignee_inbox_uid": "<string>",
"assignee_admin_uid": "<string>",
"sent_by_uid": "<string>"
}'
{
"result": {
"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"
}
}