Append photo notes to a work order in bulk
curl --request PATCH \
--url https://api.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk \
--header 'Content-Type: application/json' \
--header 'OW-KEY: <api-key>' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"id": 123,
"notes": [
{
"text": "<string>",
"noteAddedBy": "<string>",
"noteAddedAt": "2023-11-07T05:31:56Z",
"id": 123,
"photo": "<string>",
"video": "<string>",
"audio": "<string>",
"otherFile": "<string>",
"elements": [
{
"type": "<string>",
"value": "<string>",
"userObject": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteReadDetails": [
{
"readAt": "2023-11-07T05:31:56Z",
"readBy": "<string>",
"readByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteAddedByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"noteType": "<string>",
"noteAddedByType": "<string>",
"caption": "<string>",
"isNoteAwaitingResponse": true
}
]
}
'import requests
url = "https://api.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk"
payload = {
"id": 123,
"notes": [
{
"text": "<string>",
"noteAddedBy": "<string>",
"noteAddedAt": "2023-11-07T05:31:56Z",
"id": 123,
"photo": "<string>",
"video": "<string>",
"audio": "<string>",
"otherFile": "<string>",
"elements": [
{
"type": "<string>",
"value": "<string>",
"userObject": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": True,
"readOnlyAccess": True,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteReadDetails": [
{
"readAt": "2023-11-07T05:31:56Z",
"readBy": "<string>",
"readByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": True,
"readOnlyAccess": True,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteAddedByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": True,
"readOnlyAccess": True,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"noteType": "<string>",
"noteAddedByType": "<string>",
"caption": "<string>",
"isNoteAwaitingResponse": True
}
]
}
headers = {
"X-API-KEY": "<api-key>",
"OW-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
'X-API-KEY': '<api-key>',
'OW-KEY': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
id: 123,
notes: [
{
text: '<string>',
noteAddedBy: '<string>',
noteAddedAt: '2023-11-07T05:31:56Z',
id: 123,
photo: '<string>',
video: '<string>',
audio: '<string>',
otherFile: '<string>',
elements: [
{
type: '<string>',
value: '<string>',
userObject: {
email: '<string>',
nameGiven: '<string>',
nameFamily: '<string>',
contactType: '<string>',
title: '<string>',
department: '<string>',
facilityId: 123,
isSharedContact: true,
readOnlyAccess: true,
invitedByEmail: '<string>',
invitedAt: '2023-11-07T05:31:56Z',
epaCertificationType: '<string>',
epaCertificationNumber: '<string>',
createdAt: '2023-11-07T05:31:56Z',
updatedAt: '2023-11-07T05:31:56Z'
}
}
],
noteReadDetails: [
{
readAt: '2023-11-07T05:31:56Z',
readBy: '<string>',
readByContact: {
email: '<string>',
nameGiven: '<string>',
nameFamily: '<string>',
contactType: '<string>',
title: '<string>',
department: '<string>',
facilityId: 123,
isSharedContact: true,
readOnlyAccess: true,
invitedByEmail: '<string>',
invitedAt: '2023-11-07T05:31:56Z',
epaCertificationType: '<string>',
epaCertificationNumber: '<string>',
createdAt: '2023-11-07T05:31:56Z',
updatedAt: '2023-11-07T05:31:56Z'
}
}
],
noteAddedByContact: {
email: '<string>',
nameGiven: '<string>',
nameFamily: '<string>',
contactType: '<string>',
title: '<string>',
department: '<string>',
facilityId: 123,
isSharedContact: true,
readOnlyAccess: true,
invitedByEmail: '<string>',
invitedAt: '2023-11-07T05:31:56Z',
epaCertificationType: '<string>',
epaCertificationNumber: '<string>',
createdAt: '2023-11-07T05:31:56Z',
updatedAt: '2023-11-07T05:31:56Z'
},
noteType: '<string>',
noteAddedByType: '<string>',
caption: '<string>',
isNoteAwaitingResponse: true
}
]
})
};
fetch('https://api.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk', 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.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk",
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([
'id' => 123,
'notes' => [
[
'text' => '<string>',
'noteAddedBy' => '<string>',
'noteAddedAt' => '2023-11-07T05:31:56Z',
'id' => 123,
'photo' => '<string>',
'video' => '<string>',
'audio' => '<string>',
'otherFile' => '<string>',
'elements' => [
[
'type' => '<string>',
'value' => '<string>',
'userObject' => [
'email' => '<string>',
'nameGiven' => '<string>',
'nameFamily' => '<string>',
'contactType' => '<string>',
'title' => '<string>',
'department' => '<string>',
'facilityId' => 123,
'isSharedContact' => true,
'readOnlyAccess' => true,
'invitedByEmail' => '<string>',
'invitedAt' => '2023-11-07T05:31:56Z',
'epaCertificationType' => '<string>',
'epaCertificationNumber' => '<string>',
'createdAt' => '2023-11-07T05:31:56Z',
'updatedAt' => '2023-11-07T05:31:56Z'
]
]
],
'noteReadDetails' => [
[
'readAt' => '2023-11-07T05:31:56Z',
'readBy' => '<string>',
'readByContact' => [
'email' => '<string>',
'nameGiven' => '<string>',
'nameFamily' => '<string>',
'contactType' => '<string>',
'title' => '<string>',
'department' => '<string>',
'facilityId' => 123,
'isSharedContact' => true,
'readOnlyAccess' => true,
'invitedByEmail' => '<string>',
'invitedAt' => '2023-11-07T05:31:56Z',
'epaCertificationType' => '<string>',
'epaCertificationNumber' => '<string>',
'createdAt' => '2023-11-07T05:31:56Z',
'updatedAt' => '2023-11-07T05:31:56Z'
]
]
],
'noteAddedByContact' => [
'email' => '<string>',
'nameGiven' => '<string>',
'nameFamily' => '<string>',
'contactType' => '<string>',
'title' => '<string>',
'department' => '<string>',
'facilityId' => 123,
'isSharedContact' => true,
'readOnlyAccess' => true,
'invitedByEmail' => '<string>',
'invitedAt' => '2023-11-07T05:31:56Z',
'epaCertificationType' => '<string>',
'epaCertificationNumber' => '<string>',
'createdAt' => '2023-11-07T05:31:56Z',
'updatedAt' => '2023-11-07T05:31:56Z'
],
'noteType' => '<string>',
'noteAddedByType' => '<string>',
'caption' => '<string>',
'isNoteAwaitingResponse' => true
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"OW-KEY: <api-key>",
"X-API-KEY: <api-key>"
],
]);
$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.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk"
payload := strings.NewReader("{\n \"id\": 123,\n \"notes\": [\n {\n \"text\": \"<string>\",\n \"noteAddedBy\": \"<string>\",\n \"noteAddedAt\": \"2023-11-07T05:31:56Z\",\n \"id\": 123,\n \"photo\": \"<string>\",\n \"video\": \"<string>\",\n \"audio\": \"<string>\",\n \"otherFile\": \"<string>\",\n \"elements\": [\n {\n \"type\": \"<string>\",\n \"value\": \"<string>\",\n \"userObject\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteReadDetails\": [\n {\n \"readAt\": \"2023-11-07T05:31:56Z\",\n \"readBy\": \"<string>\",\n \"readByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteAddedByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n },\n \"noteType\": \"<string>\",\n \"noteAddedByType\": \"<string>\",\n \"caption\": \"<string>\",\n \"isNoteAwaitingResponse\": true\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("OW-KEY", "<api-key>")
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.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk")
.header("X-API-KEY", "<api-key>")
.header("OW-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"id\": 123,\n \"notes\": [\n {\n \"text\": \"<string>\",\n \"noteAddedBy\": \"<string>\",\n \"noteAddedAt\": \"2023-11-07T05:31:56Z\",\n \"id\": 123,\n \"photo\": \"<string>\",\n \"video\": \"<string>\",\n \"audio\": \"<string>\",\n \"otherFile\": \"<string>\",\n \"elements\": [\n {\n \"type\": \"<string>\",\n \"value\": \"<string>\",\n \"userObject\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteReadDetails\": [\n {\n \"readAt\": \"2023-11-07T05:31:56Z\",\n \"readBy\": \"<string>\",\n \"readByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteAddedByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n },\n \"noteType\": \"<string>\",\n \"noteAddedByType\": \"<string>\",\n \"caption\": \"<string>\",\n \"isNoteAwaitingResponse\": true\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-KEY"] = '<api-key>'
request["OW-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": 123,\n \"notes\": [\n {\n \"text\": \"<string>\",\n \"noteAddedBy\": \"<string>\",\n \"noteAddedAt\": \"2023-11-07T05:31:56Z\",\n \"id\": 123,\n \"photo\": \"<string>\",\n \"video\": \"<string>\",\n \"audio\": \"<string>\",\n \"otherFile\": \"<string>\",\n \"elements\": [\n {\n \"type\": \"<string>\",\n \"value\": \"<string>\",\n \"userObject\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteReadDetails\": [\n {\n \"readAt\": \"2023-11-07T05:31:56Z\",\n \"readBy\": \"<string>\",\n \"readByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteAddedByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n },\n \"noteType\": \"<string>\",\n \"noteAddedByType\": \"<string>\",\n \"caption\": \"<string>\",\n \"isNoteAwaitingResponse\": true\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"type": "<string>",
"data": {
"id": 123,
"buyerSpecificId": "<string>",
"woNumber": "<string>",
"poNumber": "<string>",
"isPM": true,
"isCapex": true,
"isStale": true,
"isSupplierInitiated": true,
"isCustomerInitiated": true,
"isWarranty": true,
"title": "<string>",
"displayStatus": "<string>",
"status": "<string>",
"statusChangedAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"assetId": 123,
"subAssetIds": [
123
],
"isAssetDown": true,
"locationId": 123,
"areaId": 123,
"workCategoryId": 123,
"spendCategoryId": 123,
"problemTypeId": 123,
"problemType": {
"id": 123,
"name": "<string>",
"buyerCompanyId": 123,
"hasChildren": true
},
"woPriorityId": 123,
"needsApproval": true,
"images": [
"<string>"
],
"dueDate": "2023-11-07T05:31:56Z",
"scheduledAt": "2023-11-07T05:31:56Z",
"estimatedCompletionDate": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"assignedAt": "2023-11-07T05:31:56Z",
"supplierRespondedAt": "2023-11-07T05:31:56Z",
"supplierFacilityId": 123,
"supplierPrimaryContactEmail": "<string>",
"price": 123,
"currencyId": "<string>",
"nte": 123,
"notes": [
{
"text": "<string>",
"noteAddedBy": "<string>",
"noteAddedAt": "2023-11-07T05:31:56Z",
"id": 123,
"photo": "<string>",
"video": "<string>",
"audio": "<string>",
"otherFile": "<string>",
"elements": [
{
"type": "<string>",
"value": "<string>",
"userObject": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteReadDetails": [
{
"readAt": "2023-11-07T05:31:56Z",
"readBy": "<string>",
"readByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteAddedByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"noteType": "<string>",
"noteAddedByType": "<string>",
"caption": "<string>",
"isNoteAwaitingResponse": true
}
],
"lastNote": "<string>",
"lastNoteAddedBy": "<string>",
"lastNoteAddedAt": 123,
"buyerFacilityId": 123,
"buyerCompanyId": 123,
"createdBy": "<string>",
"buyerSubscriberEmails": [
"<string>"
],
"supplierSubscriberEmails": [
"<string>"
],
"associatedServiceCalls": [
{
"supplierFacilityId": 123,
"numberOfTechs": 123,
"workOrderId": 123,
"locationId": 123,
"buyerFacilityId": 123,
"buyerCompanyId": 123,
"isDeleted": true,
"id": 123,
"leadTechnicianEmail": "<string>",
"leadTechnicianEmailContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"additionalTechnicianEmails": [
"<string>"
],
"additionalTechnicians": [
{
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"stockLocationIds": [
123
],
"stockLocations": [
{
"name": "<string>",
"isMobile": true,
"supplierFacilityId": 123,
"supplierCompanyId": 123,
"isActive": true,
"allowEquipmentForwarding": true,
"isDeleted": true,
"id": 123,
"warehouseId": "<string>",
"images": [
"<string>"
],
"description": "<string>",
"address": {},
"latitude": 123,
"longitude": 123,
"timeZoneId": "<string>",
"locationId": 123,
"burdenRates": [
{
"year": 123,
"rate": "<string>"
}
],
"taxRates": [
{
"year": 123,
"rate": "<string>"
}
],
"purchaseOrderPrefix": "<string>",
"glCode": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
}
],
"serviceScheduledAt": "2023-11-07T05:31:56Z",
"checkInByEmail": "<string>",
"checkInByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"checkInStatus": "<string>",
"checkInTime": "2023-11-07T05:31:56Z",
"checkInNotes": "<string>",
"checkInImages": [
"<string>"
],
"checkInGeoLocation": {
"lat": "<string>",
"long": "<string>"
},
"checkInAudio": "<string>",
"checkInAudioTranscription": "<string>",
"checkOutByEmail": "<string>",
"checkOutByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"checkOutStatus": "<string>",
"checkOutTime": "2023-11-07T05:31:56Z",
"checkOutNotes": "<string>",
"checkOutImages": [
"<string>"
],
"checkOutGeoLocation": {
"lat": "<string>",
"long": "<string>"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
}
],
"lastServiceCall": {
"supplierFacilityId": 123,
"numberOfTechs": 123,
"workOrderId": 123,
"locationId": 123,
"buyerFacilityId": 123,
"buyerCompanyId": 123,
"isDeleted": true,
"id": 123,
"leadTechnicianEmail": "<string>",
"leadTechnicianEmailContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"additionalTechnicianEmails": [
"<string>"
],
"additionalTechnicians": [
{
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"stockLocationIds": [
123
],
"stockLocations": [
{
"name": "<string>",
"isMobile": true,
"supplierFacilityId": 123,
"supplierCompanyId": 123,
"isActive": true,
"allowEquipmentForwarding": true,
"isDeleted": true,
"id": 123,
"warehouseId": "<string>",
"images": [
"<string>"
],
"description": "<string>",
"address": {},
"latitude": 123,
"longitude": 123,
"timeZoneId": "<string>",
"locationId": 123,
"burdenRates": [
{
"year": 123,
"rate": "<string>"
}
],
"taxRates": [
{
"year": 123,
"rate": "<string>"
}
],
"purchaseOrderPrefix": "<string>",
"glCode": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
}
],
"serviceScheduledAt": "2023-11-07T05:31:56Z",
"checkInByEmail": "<string>",
"checkInByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"checkInStatus": "<string>",
"checkInTime": "2023-11-07T05:31:56Z",
"checkInNotes": "<string>",
"checkInImages": [
"<string>"
],
"checkInGeoLocation": {
"lat": "<string>",
"long": "<string>"
},
"checkInAudio": "<string>",
"checkInAudioTranscription": "<string>",
"checkOutByEmail": "<string>",
"checkOutByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"checkOutStatus": "<string>",
"checkOutTime": "2023-11-07T05:31:56Z",
"checkOutNotes": "<string>",
"checkOutImages": [
"<string>"
],
"checkOutGeoLocation": {
"lat": "<string>",
"long": "<string>"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
},
"buyerAttachments": [
{
"fileName": "<string>",
"fileId": "<string>"
}
],
"supplierAttachments": [
{
"fileName": "<string>",
"fileId": "<string>"
}
],
"resolutionTypeId": 123,
"plannedMaintenanceScheduleId": 123,
"cancelledAt": "2023-11-07T05:31:56Z",
"cancelledBy": "<string>",
"glCode": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"isDeleted": true,
"deletedAt": "2023-11-07T05:31:56Z"
},
"status": "ok"
}{
"message": "<string>",
"type": "<string>",
"status": "error",
"traceId": "<string>"
}{
"message": "<string>",
"type": "<string>",
"status": "error",
"traceId": "<string>"
}{
"message": "<string>",
"type": "<string>",
"status": "error",
"traceId": "<string>"
}Work Orders
Append photo notes to a work order in bulk
Appends up to 25 photo-only notes to the work order’s buyer-supplier note thread in one call and sends a single grouped notification instead of one notification per photo. Each note must carry a photo URL and no other content (empty text, no video, audio, otherFile, or elements), and the same photo URL cannot appear twice in one request. Returns the updated work order.
PATCH
/
v1
/
supplier
/
work_order
/
work_orders
/
append_notes
/
bulk
Append photo notes to a work order in bulk
curl --request PATCH \
--url https://api.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk \
--header 'Content-Type: application/json' \
--header 'OW-KEY: <api-key>' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"id": 123,
"notes": [
{
"text": "<string>",
"noteAddedBy": "<string>",
"noteAddedAt": "2023-11-07T05:31:56Z",
"id": 123,
"photo": "<string>",
"video": "<string>",
"audio": "<string>",
"otherFile": "<string>",
"elements": [
{
"type": "<string>",
"value": "<string>",
"userObject": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteReadDetails": [
{
"readAt": "2023-11-07T05:31:56Z",
"readBy": "<string>",
"readByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteAddedByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"noteType": "<string>",
"noteAddedByType": "<string>",
"caption": "<string>",
"isNoteAwaitingResponse": true
}
]
}
'import requests
url = "https://api.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk"
payload = {
"id": 123,
"notes": [
{
"text": "<string>",
"noteAddedBy": "<string>",
"noteAddedAt": "2023-11-07T05:31:56Z",
"id": 123,
"photo": "<string>",
"video": "<string>",
"audio": "<string>",
"otherFile": "<string>",
"elements": [
{
"type": "<string>",
"value": "<string>",
"userObject": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": True,
"readOnlyAccess": True,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteReadDetails": [
{
"readAt": "2023-11-07T05:31:56Z",
"readBy": "<string>",
"readByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": True,
"readOnlyAccess": True,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteAddedByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": True,
"readOnlyAccess": True,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"noteType": "<string>",
"noteAddedByType": "<string>",
"caption": "<string>",
"isNoteAwaitingResponse": True
}
]
}
headers = {
"X-API-KEY": "<api-key>",
"OW-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
'X-API-KEY': '<api-key>',
'OW-KEY': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
id: 123,
notes: [
{
text: '<string>',
noteAddedBy: '<string>',
noteAddedAt: '2023-11-07T05:31:56Z',
id: 123,
photo: '<string>',
video: '<string>',
audio: '<string>',
otherFile: '<string>',
elements: [
{
type: '<string>',
value: '<string>',
userObject: {
email: '<string>',
nameGiven: '<string>',
nameFamily: '<string>',
contactType: '<string>',
title: '<string>',
department: '<string>',
facilityId: 123,
isSharedContact: true,
readOnlyAccess: true,
invitedByEmail: '<string>',
invitedAt: '2023-11-07T05:31:56Z',
epaCertificationType: '<string>',
epaCertificationNumber: '<string>',
createdAt: '2023-11-07T05:31:56Z',
updatedAt: '2023-11-07T05:31:56Z'
}
}
],
noteReadDetails: [
{
readAt: '2023-11-07T05:31:56Z',
readBy: '<string>',
readByContact: {
email: '<string>',
nameGiven: '<string>',
nameFamily: '<string>',
contactType: '<string>',
title: '<string>',
department: '<string>',
facilityId: 123,
isSharedContact: true,
readOnlyAccess: true,
invitedByEmail: '<string>',
invitedAt: '2023-11-07T05:31:56Z',
epaCertificationType: '<string>',
epaCertificationNumber: '<string>',
createdAt: '2023-11-07T05:31:56Z',
updatedAt: '2023-11-07T05:31:56Z'
}
}
],
noteAddedByContact: {
email: '<string>',
nameGiven: '<string>',
nameFamily: '<string>',
contactType: '<string>',
title: '<string>',
department: '<string>',
facilityId: 123,
isSharedContact: true,
readOnlyAccess: true,
invitedByEmail: '<string>',
invitedAt: '2023-11-07T05:31:56Z',
epaCertificationType: '<string>',
epaCertificationNumber: '<string>',
createdAt: '2023-11-07T05:31:56Z',
updatedAt: '2023-11-07T05:31:56Z'
},
noteType: '<string>',
noteAddedByType: '<string>',
caption: '<string>',
isNoteAwaitingResponse: true
}
]
})
};
fetch('https://api.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk', 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.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk",
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([
'id' => 123,
'notes' => [
[
'text' => '<string>',
'noteAddedBy' => '<string>',
'noteAddedAt' => '2023-11-07T05:31:56Z',
'id' => 123,
'photo' => '<string>',
'video' => '<string>',
'audio' => '<string>',
'otherFile' => '<string>',
'elements' => [
[
'type' => '<string>',
'value' => '<string>',
'userObject' => [
'email' => '<string>',
'nameGiven' => '<string>',
'nameFamily' => '<string>',
'contactType' => '<string>',
'title' => '<string>',
'department' => '<string>',
'facilityId' => 123,
'isSharedContact' => true,
'readOnlyAccess' => true,
'invitedByEmail' => '<string>',
'invitedAt' => '2023-11-07T05:31:56Z',
'epaCertificationType' => '<string>',
'epaCertificationNumber' => '<string>',
'createdAt' => '2023-11-07T05:31:56Z',
'updatedAt' => '2023-11-07T05:31:56Z'
]
]
],
'noteReadDetails' => [
[
'readAt' => '2023-11-07T05:31:56Z',
'readBy' => '<string>',
'readByContact' => [
'email' => '<string>',
'nameGiven' => '<string>',
'nameFamily' => '<string>',
'contactType' => '<string>',
'title' => '<string>',
'department' => '<string>',
'facilityId' => 123,
'isSharedContact' => true,
'readOnlyAccess' => true,
'invitedByEmail' => '<string>',
'invitedAt' => '2023-11-07T05:31:56Z',
'epaCertificationType' => '<string>',
'epaCertificationNumber' => '<string>',
'createdAt' => '2023-11-07T05:31:56Z',
'updatedAt' => '2023-11-07T05:31:56Z'
]
]
],
'noteAddedByContact' => [
'email' => '<string>',
'nameGiven' => '<string>',
'nameFamily' => '<string>',
'contactType' => '<string>',
'title' => '<string>',
'department' => '<string>',
'facilityId' => 123,
'isSharedContact' => true,
'readOnlyAccess' => true,
'invitedByEmail' => '<string>',
'invitedAt' => '2023-11-07T05:31:56Z',
'epaCertificationType' => '<string>',
'epaCertificationNumber' => '<string>',
'createdAt' => '2023-11-07T05:31:56Z',
'updatedAt' => '2023-11-07T05:31:56Z'
],
'noteType' => '<string>',
'noteAddedByType' => '<string>',
'caption' => '<string>',
'isNoteAwaitingResponse' => true
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"OW-KEY: <api-key>",
"X-API-KEY: <api-key>"
],
]);
$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.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk"
payload := strings.NewReader("{\n \"id\": 123,\n \"notes\": [\n {\n \"text\": \"<string>\",\n \"noteAddedBy\": \"<string>\",\n \"noteAddedAt\": \"2023-11-07T05:31:56Z\",\n \"id\": 123,\n \"photo\": \"<string>\",\n \"video\": \"<string>\",\n \"audio\": \"<string>\",\n \"otherFile\": \"<string>\",\n \"elements\": [\n {\n \"type\": \"<string>\",\n \"value\": \"<string>\",\n \"userObject\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteReadDetails\": [\n {\n \"readAt\": \"2023-11-07T05:31:56Z\",\n \"readBy\": \"<string>\",\n \"readByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteAddedByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n },\n \"noteType\": \"<string>\",\n \"noteAddedByType\": \"<string>\",\n \"caption\": \"<string>\",\n \"isNoteAwaitingResponse\": true\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("OW-KEY", "<api-key>")
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.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk")
.header("X-API-KEY", "<api-key>")
.header("OW-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"id\": 123,\n \"notes\": [\n {\n \"text\": \"<string>\",\n \"noteAddedBy\": \"<string>\",\n \"noteAddedAt\": \"2023-11-07T05:31:56Z\",\n \"id\": 123,\n \"photo\": \"<string>\",\n \"video\": \"<string>\",\n \"audio\": \"<string>\",\n \"otherFile\": \"<string>\",\n \"elements\": [\n {\n \"type\": \"<string>\",\n \"value\": \"<string>\",\n \"userObject\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteReadDetails\": [\n {\n \"readAt\": \"2023-11-07T05:31:56Z\",\n \"readBy\": \"<string>\",\n \"readByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteAddedByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n },\n \"noteType\": \"<string>\",\n \"noteAddedByType\": \"<string>\",\n \"caption\": \"<string>\",\n \"isNoteAwaitingResponse\": true\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.useopenwrench.com/api/external/v1/supplier/work_order/work_orders/append_notes/bulk")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["X-API-KEY"] = '<api-key>'
request["OW-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": 123,\n \"notes\": [\n {\n \"text\": \"<string>\",\n \"noteAddedBy\": \"<string>\",\n \"noteAddedAt\": \"2023-11-07T05:31:56Z\",\n \"id\": 123,\n \"photo\": \"<string>\",\n \"video\": \"<string>\",\n \"audio\": \"<string>\",\n \"otherFile\": \"<string>\",\n \"elements\": [\n {\n \"type\": \"<string>\",\n \"value\": \"<string>\",\n \"userObject\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteReadDetails\": [\n {\n \"readAt\": \"2023-11-07T05:31:56Z\",\n \"readBy\": \"<string>\",\n \"readByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n }\n }\n ],\n \"noteAddedByContact\": {\n \"email\": \"<string>\",\n \"nameGiven\": \"<string>\",\n \"nameFamily\": \"<string>\",\n \"contactType\": \"<string>\",\n \"title\": \"<string>\",\n \"department\": \"<string>\",\n \"facilityId\": 123,\n \"isSharedContact\": true,\n \"readOnlyAccess\": true,\n \"invitedByEmail\": \"<string>\",\n \"invitedAt\": \"2023-11-07T05:31:56Z\",\n \"epaCertificationType\": \"<string>\",\n \"epaCertificationNumber\": \"<string>\",\n \"createdAt\": \"2023-11-07T05:31:56Z\",\n \"updatedAt\": \"2023-11-07T05:31:56Z\"\n },\n \"noteType\": \"<string>\",\n \"noteAddedByType\": \"<string>\",\n \"caption\": \"<string>\",\n \"isNoteAwaitingResponse\": true\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"type": "<string>",
"data": {
"id": 123,
"buyerSpecificId": "<string>",
"woNumber": "<string>",
"poNumber": "<string>",
"isPM": true,
"isCapex": true,
"isStale": true,
"isSupplierInitiated": true,
"isCustomerInitiated": true,
"isWarranty": true,
"title": "<string>",
"displayStatus": "<string>",
"status": "<string>",
"statusChangedAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"assetId": 123,
"subAssetIds": [
123
],
"isAssetDown": true,
"locationId": 123,
"areaId": 123,
"workCategoryId": 123,
"spendCategoryId": 123,
"problemTypeId": 123,
"problemType": {
"id": 123,
"name": "<string>",
"buyerCompanyId": 123,
"hasChildren": true
},
"woPriorityId": 123,
"needsApproval": true,
"images": [
"<string>"
],
"dueDate": "2023-11-07T05:31:56Z",
"scheduledAt": "2023-11-07T05:31:56Z",
"estimatedCompletionDate": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"assignedAt": "2023-11-07T05:31:56Z",
"supplierRespondedAt": "2023-11-07T05:31:56Z",
"supplierFacilityId": 123,
"supplierPrimaryContactEmail": "<string>",
"price": 123,
"currencyId": "<string>",
"nte": 123,
"notes": [
{
"text": "<string>",
"noteAddedBy": "<string>",
"noteAddedAt": "2023-11-07T05:31:56Z",
"id": 123,
"photo": "<string>",
"video": "<string>",
"audio": "<string>",
"otherFile": "<string>",
"elements": [
{
"type": "<string>",
"value": "<string>",
"userObject": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteReadDetails": [
{
"readAt": "2023-11-07T05:31:56Z",
"readBy": "<string>",
"readByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
],
"noteAddedByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"noteType": "<string>",
"noteAddedByType": "<string>",
"caption": "<string>",
"isNoteAwaitingResponse": true
}
],
"lastNote": "<string>",
"lastNoteAddedBy": "<string>",
"lastNoteAddedAt": 123,
"buyerFacilityId": 123,
"buyerCompanyId": 123,
"createdBy": "<string>",
"buyerSubscriberEmails": [
"<string>"
],
"supplierSubscriberEmails": [
"<string>"
],
"associatedServiceCalls": [
{
"supplierFacilityId": 123,
"numberOfTechs": 123,
"workOrderId": 123,
"locationId": 123,
"buyerFacilityId": 123,
"buyerCompanyId": 123,
"isDeleted": true,
"id": 123,
"leadTechnicianEmail": "<string>",
"leadTechnicianEmailContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"additionalTechnicianEmails": [
"<string>"
],
"additionalTechnicians": [
{
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"stockLocationIds": [
123
],
"stockLocations": [
{
"name": "<string>",
"isMobile": true,
"supplierFacilityId": 123,
"supplierCompanyId": 123,
"isActive": true,
"allowEquipmentForwarding": true,
"isDeleted": true,
"id": 123,
"warehouseId": "<string>",
"images": [
"<string>"
],
"description": "<string>",
"address": {},
"latitude": 123,
"longitude": 123,
"timeZoneId": "<string>",
"locationId": 123,
"burdenRates": [
{
"year": 123,
"rate": "<string>"
}
],
"taxRates": [
{
"year": 123,
"rate": "<string>"
}
],
"purchaseOrderPrefix": "<string>",
"glCode": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
}
],
"serviceScheduledAt": "2023-11-07T05:31:56Z",
"checkInByEmail": "<string>",
"checkInByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"checkInStatus": "<string>",
"checkInTime": "2023-11-07T05:31:56Z",
"checkInNotes": "<string>",
"checkInImages": [
"<string>"
],
"checkInGeoLocation": {
"lat": "<string>",
"long": "<string>"
},
"checkInAudio": "<string>",
"checkInAudioTranscription": "<string>",
"checkOutByEmail": "<string>",
"checkOutByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"checkOutStatus": "<string>",
"checkOutTime": "2023-11-07T05:31:56Z",
"checkOutNotes": "<string>",
"checkOutImages": [
"<string>"
],
"checkOutGeoLocation": {
"lat": "<string>",
"long": "<string>"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
}
],
"lastServiceCall": {
"supplierFacilityId": 123,
"numberOfTechs": 123,
"workOrderId": 123,
"locationId": 123,
"buyerFacilityId": 123,
"buyerCompanyId": 123,
"isDeleted": true,
"id": 123,
"leadTechnicianEmail": "<string>",
"leadTechnicianEmailContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"additionalTechnicianEmails": [
"<string>"
],
"additionalTechnicians": [
{
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"stockLocationIds": [
123
],
"stockLocations": [
{
"name": "<string>",
"isMobile": true,
"supplierFacilityId": 123,
"supplierCompanyId": 123,
"isActive": true,
"allowEquipmentForwarding": true,
"isDeleted": true,
"id": 123,
"warehouseId": "<string>",
"images": [
"<string>"
],
"description": "<string>",
"address": {},
"latitude": 123,
"longitude": 123,
"timeZoneId": "<string>",
"locationId": 123,
"burdenRates": [
{
"year": 123,
"rate": "<string>"
}
],
"taxRates": [
{
"year": 123,
"rate": "<string>"
}
],
"purchaseOrderPrefix": "<string>",
"glCode": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
}
],
"serviceScheduledAt": "2023-11-07T05:31:56Z",
"checkInByEmail": "<string>",
"checkInByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"checkInStatus": "<string>",
"checkInTime": "2023-11-07T05:31:56Z",
"checkInNotes": "<string>",
"checkInImages": [
"<string>"
],
"checkInGeoLocation": {
"lat": "<string>",
"long": "<string>"
},
"checkInAudio": "<string>",
"checkInAudioTranscription": "<string>",
"checkOutByEmail": "<string>",
"checkOutByContact": {
"email": "<string>",
"nameGiven": "<string>",
"nameFamily": "<string>",
"contactType": "<string>",
"title": "<string>",
"department": "<string>",
"facilityId": 123,
"isSharedContact": true,
"readOnlyAccess": true,
"invitedByEmail": "<string>",
"invitedAt": "2023-11-07T05:31:56Z",
"epaCertificationType": "<string>",
"epaCertificationNumber": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"checkOutStatus": "<string>",
"checkOutTime": "2023-11-07T05:31:56Z",
"checkOutNotes": "<string>",
"checkOutImages": [
"<string>"
],
"checkOutGeoLocation": {
"lat": "<string>",
"long": "<string>"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
},
"buyerAttachments": [
{
"fileName": "<string>",
"fileId": "<string>"
}
],
"supplierAttachments": [
{
"fileName": "<string>",
"fileId": "<string>"
}
],
"resolutionTypeId": 123,
"plannedMaintenanceScheduleId": 123,
"cancelledAt": "2023-11-07T05:31:56Z",
"cancelledBy": "<string>",
"glCode": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"isDeleted": true,
"deletedAt": "2023-11-07T05:31:56Z"
},
"status": "ok"
}{
"message": "<string>",
"type": "<string>",
"status": "error",
"traceId": "<string>"
}{
"message": "<string>",
"type": "<string>",
"status": "error",
"traceId": "<string>"
}{
"message": "<string>",
"type": "<string>",
"status": "error",
"traceId": "<string>"
}Authorizations
OpenWrench shared secret. Required on every request alongside X-API-KEY; issued together with your API key.
Body
application/json
The work order id plus 1-25 photo-only notes. Every note's noteAddedBy is set to the calling contact and noteAddedAt is overwritten with the server's current time; the author's email is added to the work order's supplier subscriber list.
Work order id (required; must exist)
Photo-only notes to append, in the order they should appear on the thread. Each entry must set photo and leave every other content field empty; photo URLs must be unique within the request.
Required array length:
1 - 25 elementsShow child attributes
Show child attributes
Response
Successful response
Entity type label, e.g. "WorkOrder". Endpoints that derive it via Scala reflection (most generic list/get endpoints) may return the fully qualified server class name instead (e.g. "models.workorder.WorkOrder"); treat this field as informational.
Work order (abridged - the full model has 150+ fields including hydrated location/asset/facility/approval-hierarchy objects). For third-party suppliers (keys not belonging to an internal service team) responses are masked: buyer-private fields are removed/blanked by the API masking layer.
Show child attributes
Show child attributes
"ok" on success
Available options:
ok