Get Started
Application
Equipment
Comment
Request
Update status
Note: you cannot update a request once its archived
curl --request PATCH \
--url https://api.siit.io/v1/requests/{uid}/status \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"status": "open",
"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
open, in_progress, waiting, resolved, archived 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}/status \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"status": "open",
"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"
}
}