Update a signature request
Update a signature request: reject it, or mark it for wet-ink signing. If QC comes after signing, you can also move a marked request back to e-signature, or confirm its signed scan was uploaded. If QC comes before signing, marking finishes the request and is final: you can’t move it back, reject it, or delete it.
curl --request PATCH \
--url https://api.slate.inc/signatures/v2/requests/{signatureRequestId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.slate.inc/signatures/v2/requests/{signatureRequestId}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.slate.inc/signatures/v2/requests/{signatureRequestId}', 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.slate.inc/signatures/v2/requests/{signatureRequestId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
]),
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.slate.inc/signatures/v2/requests/{signatureRequestId}"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.slate.inc/signatures/v2/requests/{signatureRequestId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.slate.inc/signatures/v2/requests/{signatureRequestId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"status": "rejected",
"rejected_on": "2023-11-07T05:31:56Z",
"wetInkOn": "2023-11-07T05:31:56Z",
"wetInkUploadedOn": "2023-11-07T05:31:56Z"
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}Authorizations
Cognito-issued JWT access token. Send it as Authorization: Bearer <token>.
Path Parameters
Body
Only the status field can be patched. Each value is an action, not a stored status: rejected rejects the request. wetInk marks it for wet-ink signing, removing it from e-signature. pending moves a request marked for wet-ink signing back to e-signature, as long as its signed scan has not been uploaded. wetInkUploaded confirms the signed scan was uploaded to the URL from GET /v2/requests/{signatureRequestId}/uploadUrl. What wetInk does next depends on your workflow. If QC comes before signing, it finishes the request immediately, and the mark is final. If QC comes after signing, the request waits for its signed scan to be uploaded. pending and wetInkUploaded are only allowed when QC comes after signing.
The action to apply to the signature request.
rejected, wetInk, pending, wetInkUploaded Response
Signature request updated successfully.
Response for a patched signature request. It echoes the action that was applied.
Unique identifier for the signature request.
The action that was applied.
rejected, wetInk, pending, wetInkUploaded The timestamp when the signature request was rejected. Only set for rejected.
The timestamp when the signature request was marked for wet-ink signing. Set for wetInk and wetInkUploaded.
The timestamp when the signed wet-ink scan upload was confirmed. Only set for wetInkUploaded.
curl --request PATCH \
--url https://api.slate.inc/signatures/v2/requests/{signatureRequestId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.slate.inc/signatures/v2/requests/{signatureRequestId}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.slate.inc/signatures/v2/requests/{signatureRequestId}', 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.slate.inc/signatures/v2/requests/{signatureRequestId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
]),
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.slate.inc/signatures/v2/requests/{signatureRequestId}"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.slate.inc/signatures/v2/requests/{signatureRequestId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.slate.inc/signatures/v2/requests/{signatureRequestId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"status": "rejected",
"rejected_on": "2023-11-07T05:31:56Z",
"wetInkOn": "2023-11-07T05:31:56Z",
"wetInkUploadedOn": "2023-11-07T05:31:56Z"
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "<string>"
}