Update a Request
PUT
/
v1
/
requests
/
{uid}
Update a Request
curl --request PUT \
--url https://api.siit.io/v1/requests/{uid} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"description": "<string>",
"title_markdown": "<string>",
"description_markdown": "<string>",
"status": "open",
"assignee_admin": "<string>",
"assignee_inbox": "<string>",
"target": "<string>",
"tags": [
"<string>"
],
"associated_apps": [
"<string>"
],
"associated_equipments": [
"<string>"
],
"custom_form_inputs": [
{
"label": "<string>",
"value": "<string>"
}
]
}
'import requests
url = "https://api.siit.io/v1/requests/{uid}"
payload = {
"title": "<string>",
"description": "<string>",
"title_markdown": "<string>",
"description_markdown": "<string>",
"status": "open",
"assignee_admin": "<string>",
"assignee_inbox": "<string>",
"target": "<string>",
"tags": ["<string>"],
"associated_apps": ["<string>"],
"associated_equipments": ["<string>"],
"custom_form_inputs": [
{
"label": "<string>",
"value": "<string>"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: '<string>',
description: '<string>',
title_markdown: '<string>',
description_markdown: '<string>',
status: 'open',
assignee_admin: '<string>',
assignee_inbox: '<string>',
target: '<string>',
tags: ['<string>'],
associated_apps: ['<string>'],
associated_equipments: ['<string>'],
custom_form_inputs: [{label: '<string>', value: '<string>'}]
})
};
fetch('https://api.siit.io/v1/requests/{uid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.siit.io/v1/requests/{uid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'title' => '<string>',
'description' => '<string>',
'title_markdown' => '<string>',
'description_markdown' => '<string>',
'status' => 'open',
'assignee_admin' => '<string>',
'assignee_inbox' => '<string>',
'target' => '<string>',
'tags' => [
'<string>'
],
'associated_apps' => [
'<string>'
],
'associated_equipments' => [
'<string>'
],
'custom_form_inputs' => [
[
'label' => '<string>',
'value' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.siit.io/v1/requests/{uid}"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"description\": \"<string>\",\n \"title_markdown\": \"<string>\",\n \"description_markdown\": \"<string>\",\n \"status\": \"open\",\n \"assignee_admin\": \"<string>\",\n \"assignee_inbox\": \"<string>\",\n \"target\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"associated_apps\": [\n \"<string>\"\n ],\n \"associated_equipments\": [\n \"<string>\"\n ],\n \"custom_form_inputs\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.siit.io/v1/requests/{uid}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"description\": \"<string>\",\n \"title_markdown\": \"<string>\",\n \"description_markdown\": \"<string>\",\n \"status\": \"open\",\n \"assignee_admin\": \"<string>\",\n \"assignee_inbox\": \"<string>\",\n \"target\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"associated_apps\": [\n \"<string>\"\n ],\n \"associated_equipments\": [\n \"<string>\"\n ],\n \"custom_form_inputs\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.siit.io/v1/requests/{uid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"description\": \"<string>\",\n \"title_markdown\": \"<string>\",\n \"description_markdown\": \"<string>\",\n \"status\": \"open\",\n \"assignee_admin\": \"<string>\",\n \"assignee_inbox\": \"<string>\",\n \"target\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"associated_apps\": [\n \"<string>\"\n ],\n \"associated_equipments\": [\n \"<string>\"\n ],\n \"custom_form_inputs\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"result": {
"uid": "<string>",
"admin_permalink_url": "<string>",
"archived_at": "2023-11-07T05:31:56Z",
"assignee_admin": "<string>",
"assignee_admin_uid": "<string>",
"assignee_inbox": "<string>",
"assignee_inbox_uid": "<string>",
"associated_apps": [
"<string>"
],
"associated_equipments": [
"<string>"
],
"approvals": [
"<string>"
],
"attachments": [
{
"filename": "<string>",
"url": "<string>"
}
],
"author": "<string>",
"author_uid": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"completed_by": "<string>",
"completed_by_uid": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"custom_form_inputs": [
{
"label": "<string>",
"value": "<string>"
}
],
"description": "<string>",
"description_markdown": "<string>",
"follower_uids": [
"<string>"
],
"followers": [
"<string>"
],
"friendly_id": "<string>",
"requested_by": "<string>",
"requested_by_uid": "<string>",
"slack_channel_id": "<string>",
"slack_direct_link": "<string>",
"slack_thread_ts": "<string>",
"slack_ts": "<string>",
"sla_data": {
"first_replied_at": "2023-11-07T05:31:56Z",
"first_completed_at": "2023-11-07T05:31:56Z",
"paused_at": "2023-11-07T05:31:56Z",
"first_reply_due_at": "2023-11-07T05:31:56Z",
"first_completion_due_at": "2023-11-07T05:31:56Z"
},
"status": "open",
"tag_uids": [
"<string>"
],
"tags": [
"<string>"
],
"target": "<string>",
"target_uid": "<string>",
"title": "<string>",
"title_markdown": "<string>",
"updated_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 (or friendly_id) of the request
Body
application/json
Request body for updating a Request. Pass UIDs (not objects) for relationship fields.
please use "title_markdown" instead
please use "description_markdown" instead
The title of the Request, as markdown. Takes precedence over title when both are provided.
The description of the Request, as markdown. Takes precedence over description when both are provided.
Available options:
low, medium, high, urgent Request status
Available options:
open, in_progress, waiting, resolved, archived The admin user assigned to this request. Pass the UID of the related object.
The team inbox assigned to this request. Pass the UID of the related object.
Service associated with this request. Pass the UID of the related object.
Tags associated with this request. Pass an array of UIDs of the related objects.
Apps associated with this request. Pass an array of UIDs of the related objects.
Equipment associated with this request. Pass an array of UIDs of the related objects.
Custom forms attached to this request
A custom form input item for request creation. Either "label" (arbitrary input) or "uid" (native input from service configuration) must be provided.
- Arbitrary input (by label)
- Native input (by uid)
Show child attributes
Show child attributes
Response
200 - application/json
Successful
Show child attributes
Show child attributes
⌘I
Update a Request
curl --request PUT \
--url https://api.siit.io/v1/requests/{uid} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"description": "<string>",
"title_markdown": "<string>",
"description_markdown": "<string>",
"status": "open",
"assignee_admin": "<string>",
"assignee_inbox": "<string>",
"target": "<string>",
"tags": [
"<string>"
],
"associated_apps": [
"<string>"
],
"associated_equipments": [
"<string>"
],
"custom_form_inputs": [
{
"label": "<string>",
"value": "<string>"
}
]
}
'import requests
url = "https://api.siit.io/v1/requests/{uid}"
payload = {
"title": "<string>",
"description": "<string>",
"title_markdown": "<string>",
"description_markdown": "<string>",
"status": "open",
"assignee_admin": "<string>",
"assignee_inbox": "<string>",
"target": "<string>",
"tags": ["<string>"],
"associated_apps": ["<string>"],
"associated_equipments": ["<string>"],
"custom_form_inputs": [
{
"label": "<string>",
"value": "<string>"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: '<string>',
description: '<string>',
title_markdown: '<string>',
description_markdown: '<string>',
status: 'open',
assignee_admin: '<string>',
assignee_inbox: '<string>',
target: '<string>',
tags: ['<string>'],
associated_apps: ['<string>'],
associated_equipments: ['<string>'],
custom_form_inputs: [{label: '<string>', value: '<string>'}]
})
};
fetch('https://api.siit.io/v1/requests/{uid}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.siit.io/v1/requests/{uid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'title' => '<string>',
'description' => '<string>',
'title_markdown' => '<string>',
'description_markdown' => '<string>',
'status' => 'open',
'assignee_admin' => '<string>',
'assignee_inbox' => '<string>',
'target' => '<string>',
'tags' => [
'<string>'
],
'associated_apps' => [
'<string>'
],
'associated_equipments' => [
'<string>'
],
'custom_form_inputs' => [
[
'label' => '<string>',
'value' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.siit.io/v1/requests/{uid}"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"description\": \"<string>\",\n \"title_markdown\": \"<string>\",\n \"description_markdown\": \"<string>\",\n \"status\": \"open\",\n \"assignee_admin\": \"<string>\",\n \"assignee_inbox\": \"<string>\",\n \"target\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"associated_apps\": [\n \"<string>\"\n ],\n \"associated_equipments\": [\n \"<string>\"\n ],\n \"custom_form_inputs\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.siit.io/v1/requests/{uid}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"description\": \"<string>\",\n \"title_markdown\": \"<string>\",\n \"description_markdown\": \"<string>\",\n \"status\": \"open\",\n \"assignee_admin\": \"<string>\",\n \"assignee_inbox\": \"<string>\",\n \"target\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"associated_apps\": [\n \"<string>\"\n ],\n \"associated_equipments\": [\n \"<string>\"\n ],\n \"custom_form_inputs\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.siit.io/v1/requests/{uid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"description\": \"<string>\",\n \"title_markdown\": \"<string>\",\n \"description_markdown\": \"<string>\",\n \"status\": \"open\",\n \"assignee_admin\": \"<string>\",\n \"assignee_inbox\": \"<string>\",\n \"target\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"associated_apps\": [\n \"<string>\"\n ],\n \"associated_equipments\": [\n \"<string>\"\n ],\n \"custom_form_inputs\": [\n {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"result": {
"uid": "<string>",
"admin_permalink_url": "<string>",
"archived_at": "2023-11-07T05:31:56Z",
"assignee_admin": "<string>",
"assignee_admin_uid": "<string>",
"assignee_inbox": "<string>",
"assignee_inbox_uid": "<string>",
"associated_apps": [
"<string>"
],
"associated_equipments": [
"<string>"
],
"approvals": [
"<string>"
],
"attachments": [
{
"filename": "<string>",
"url": "<string>"
}
],
"author": "<string>",
"author_uid": "<string>",
"completed_at": "2023-11-07T05:31:56Z",
"completed_by": "<string>",
"completed_by_uid": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"custom_form_inputs": [
{
"label": "<string>",
"value": "<string>"
}
],
"description": "<string>",
"description_markdown": "<string>",
"follower_uids": [
"<string>"
],
"followers": [
"<string>"
],
"friendly_id": "<string>",
"requested_by": "<string>",
"requested_by_uid": "<string>",
"slack_channel_id": "<string>",
"slack_direct_link": "<string>",
"slack_thread_ts": "<string>",
"slack_ts": "<string>",
"sla_data": {
"first_replied_at": "2023-11-07T05:31:56Z",
"first_completed_at": "2023-11-07T05:31:56Z",
"paused_at": "2023-11-07T05:31:56Z",
"first_reply_due_at": "2023-11-07T05:31:56Z",
"first_completion_due_at": "2023-11-07T05:31:56Z"
},
"status": "open",
"tag_uids": [
"<string>"
],
"tags": [
"<string>"
],
"target": "<string>",
"target_uid": "<string>",
"title": "<string>",
"title_markdown": "<string>",
"updated_at": "2023-11-07T05:31:56Z"
}
}