Create a Request
curl --request POST \
--url https://api.siit.io/v1/requests \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"title": "<string>",
"description": "<string>",
"submitted_from": "employee_portal",
"author_uid": "<string>",
"requested_by_uid": "<string>",
"custom_form_inputs": [
{
"label": "<string>",
"value": "<string>"
}
]
}'{
"result": {
"uid": "<string>",
"title": "<string>",
"description": "<string>",
"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
Please note that the author_uid should be the same as requested_by_uid OR reference a User with an admin role.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
employee_portal, slack, mail, ms_teams must be equal to requester_uid OR an reference an admin user.
can be different from the author_uid (e.g Admin submitting on behalf)
Response
The UID of the Request.
The title of the Request
The description of the Request
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.
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 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"title": "<string>",
"description": "<string>",
"submitted_from": "employee_portal",
"author_uid": "<string>",
"requested_by_uid": "<string>",
"custom_form_inputs": [
{
"label": "<string>",
"value": "<string>"
}
]
}'{
"result": {
"uid": "<string>",
"title": "<string>",
"description": "<string>",
"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"
}
}