Update shift
curl --request PATCH \
--url https://api.nexspace365.com/api/shifts/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"date": "2023-12-25",
"startTime": "<string>",
"endTime": "<string>",
"department": "<string>",
"specialty": "<string>",
"requiredWorkers": 123,
"rate": 123,
"notes": "<string>"
}
'import requests
url = "https://api.nexspace365.com/api/shifts/{id}"
payload = {
"title": "<string>",
"date": "2023-12-25",
"startTime": "<string>",
"endTime": "<string>",
"department": "<string>",
"specialty": "<string>",
"requiredWorkers": 123,
"rate": 123,
"notes": "<string>"
}
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({
title: '<string>',
date: '2023-12-25',
startTime: '<string>',
endTime: '<string>',
department: '<string>',
specialty: '<string>',
requiredWorkers: 123,
rate: 123,
notes: '<string>'
})
};
fetch('https://api.nexspace365.com/api/shifts/{id}', 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.nexspace365.com/api/shifts/{id}",
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([
'title' => '<string>',
'date' => '2023-12-25',
'startTime' => '<string>',
'endTime' => '<string>',
'department' => '<string>',
'specialty' => '<string>',
'requiredWorkers' => 123,
'rate' => 123,
'notes' => '<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.nexspace365.com/api/shifts/{id}"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"startTime\": \"<string>\",\n \"endTime\": \"<string>\",\n \"department\": \"<string>\",\n \"specialty\": \"<string>\",\n \"requiredWorkers\": 123,\n \"rate\": 123,\n \"notes\": \"<string>\"\n}")
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.nexspace365.com/api/shifts/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"startTime\": \"<string>\",\n \"endTime\": \"<string>\",\n \"department\": \"<string>\",\n \"specialty\": \"<string>\",\n \"requiredWorkers\": 123,\n \"rate\": 123,\n \"notes\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nexspace365.com/api/shifts/{id}")
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 = "{\n \"title\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"startTime\": \"<string>\",\n \"endTime\": \"<string>\",\n \"department\": \"<string>\",\n \"specialty\": \"<string>\",\n \"requiredWorkers\": 123,\n \"rate\": 123,\n \"notes\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": 1024,
"facilityId": 1,
"title": "Evening Fulfillment",
"date": "2026-05-20",
"startTime": "16:00",
"endTime": "23:59",
"department": "Fulfillment",
"specialty": "Forklift Operator",
"requiredWorkers": 3,
"assignedStaffIds": [
42,
58
],
"status": "open",
"urgency": "high",
"rate": 32,
"notes": "Peak-season surge coverage",
"createdAt": "2026-05-10T12:00:00Z",
"updatedAt": "2026-05-11T08:15:00Z"
}{
"error": {
"message": "Invalid or revoked API key",
"code": "UNAUTHENTICATED",
"suggestion": "Send a valid `Authorization: Bearer <token>` (nex_live_/nex_pat_ key, JWT, or OAuth access token).",
"retryable": false
}
}{
"error": {
"message": "Insufficient API key scope",
"code": "INSUFFICIENT_SCOPE",
"suggestion": "Mint or rotate a key that includes the required scope, or grant a wildcard like `resource:*`.",
"retryable": false
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": {},
"suggestion": "<string>",
"retryable": true
},
"requestId": "<string>"
}{
"error": {
"message": "Rate limit exceeded for this API key",
"code": "API_KEY_RATE_LIMITED",
"suggestion": "Wait until X-RateLimit-Reset before retrying, or batch operations.",
"retryable": true
}
}Shifts
Update shift
Update shift information. Required API-key scope: shifts:write
PATCH
/
api
/
shifts
/
{id}
Update shift
curl --request PATCH \
--url https://api.nexspace365.com/api/shifts/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"date": "2023-12-25",
"startTime": "<string>",
"endTime": "<string>",
"department": "<string>",
"specialty": "<string>",
"requiredWorkers": 123,
"rate": 123,
"notes": "<string>"
}
'import requests
url = "https://api.nexspace365.com/api/shifts/{id}"
payload = {
"title": "<string>",
"date": "2023-12-25",
"startTime": "<string>",
"endTime": "<string>",
"department": "<string>",
"specialty": "<string>",
"requiredWorkers": 123,
"rate": 123,
"notes": "<string>"
}
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({
title: '<string>',
date: '2023-12-25',
startTime: '<string>',
endTime: '<string>',
department: '<string>',
specialty: '<string>',
requiredWorkers: 123,
rate: 123,
notes: '<string>'
})
};
fetch('https://api.nexspace365.com/api/shifts/{id}', 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.nexspace365.com/api/shifts/{id}",
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([
'title' => '<string>',
'date' => '2023-12-25',
'startTime' => '<string>',
'endTime' => '<string>',
'department' => '<string>',
'specialty' => '<string>',
'requiredWorkers' => 123,
'rate' => 123,
'notes' => '<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.nexspace365.com/api/shifts/{id}"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"startTime\": \"<string>\",\n \"endTime\": \"<string>\",\n \"department\": \"<string>\",\n \"specialty\": \"<string>\",\n \"requiredWorkers\": 123,\n \"rate\": 123,\n \"notes\": \"<string>\"\n}")
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.nexspace365.com/api/shifts/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"startTime\": \"<string>\",\n \"endTime\": \"<string>\",\n \"department\": \"<string>\",\n \"specialty\": \"<string>\",\n \"requiredWorkers\": 123,\n \"rate\": 123,\n \"notes\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nexspace365.com/api/shifts/{id}")
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 = "{\n \"title\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"startTime\": \"<string>\",\n \"endTime\": \"<string>\",\n \"department\": \"<string>\",\n \"specialty\": \"<string>\",\n \"requiredWorkers\": 123,\n \"rate\": 123,\n \"notes\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": 1024,
"facilityId": 1,
"title": "Evening Fulfillment",
"date": "2026-05-20",
"startTime": "16:00",
"endTime": "23:59",
"department": "Fulfillment",
"specialty": "Forklift Operator",
"requiredWorkers": 3,
"assignedStaffIds": [
42,
58
],
"status": "open",
"urgency": "high",
"rate": 32,
"notes": "Peak-season surge coverage",
"createdAt": "2026-05-10T12:00:00Z",
"updatedAt": "2026-05-11T08:15:00Z"
}{
"error": {
"message": "Invalid or revoked API key",
"code": "UNAUTHENTICATED",
"suggestion": "Send a valid `Authorization: Bearer <token>` (nex_live_/nex_pat_ key, JWT, or OAuth access token).",
"retryable": false
}
}{
"error": {
"message": "Insufficient API key scope",
"code": "INSUFFICIENT_SCOPE",
"suggestion": "Mint or rotate a key that includes the required scope, or grant a wildcard like `resource:*`.",
"retryable": false
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": {},
"suggestion": "<string>",
"retryable": true
},
"requestId": "<string>"
}{
"error": {
"message": "Rate limit exceeded for this API key",
"code": "API_KEY_RATE_LIMITED",
"suggestion": "Wait until X-RateLimit-Reset before retrying, or batch operations.",
"retryable": true
}
}Authorizations
bearerAuthapiKeyAuth
JWT token authentication
Path Parameters
Shift ID
Body
application/json
Available options:
open, assigned, in_progress, completed, cancelled Available options:
low, medium, high, critical Response
Shift updated successfully
Unique shift identifier
Facility where the shift takes place
Shift title or description
Shift date
Shift start time
Shift end time
Department for the shift
Required specialty
Number of workers needed
IDs of assigned staff members
Current shift status
Available options:
open, assigned, in_progress, completed, cancelled Shift urgency level
Available options:
low, medium, high, critical Pay rate for the shift
Additional notes or requirements
⌘I

