cURL
curl --request POST \
--url https://app.stockshift.io/api/v1/manufacturing/builds/{build}/problems \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'note=<string>'import requests
url = "https://app.stockshift.io/api/v1/manufacturing/builds/{build}/problems"
payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001--"
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "multipart/form-data; boundary=---011000010111000001101001"
}
response = requests.post(url, data=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.stockshift.io/api/v1/manufacturing/builds/{build}/problems",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: multipart/form-data; boundary=---011000010111000001101001"
],
]);
$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://app.stockshift.io/api/v1/manufacturing/builds/{build}/problems"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "multipart/form-data; boundary=---011000010111000001101001")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"data": {
"id": "<string>",
"number": "<string>",
"status": "<string>",
"item_id": "<string>",
"item_sku": "<string>",
"item_name": "<string>",
"quantity": "<string>",
"unit": "<string>",
"location_id": "<string>",
"location_code": "<string>",
"location_name": "<string>",
"due_on": "<string>",
"note": "<string>",
"revision_label": "<string>",
"parts_list_fixed": true,
"blocked": "<string>",
"lines": [
{
"position": "<string>",
"component_id": "<string>",
"component_sku": "<string>",
"component_name": "<string>",
"required": "<string>",
"unit": "<string>",
"available": "<string>",
"short": "<string>",
"explanation": "<string>",
"open_orders": [
{
"number": "<string>",
"quantity": "<string>",
"expected_on": "<string>"
}
],
"alternates": [
{
"rank": 123,
"component_id": "<string>",
"component_sku": "<string>",
"component_name": "<string>",
"quantity": "<string>",
"unit": "<string>",
"available": "<string>"
}
],
"id": "<string>",
"held": "<string>",
"issued": "<string>",
"variance": "<string>",
"variance_reason": "<string>"
}
],
"released_at": "<string>",
"cancelled_at": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"can_complete": true,
"can_issue": true,
"issues": [
{
"step": 123,
"position": "<string>",
"component_id": "<string>",
"component_sku": "<string>",
"alternate_rank": 123,
"quantity": "<string>",
"lots": [
"<string>"
],
"serials": [
"<string>"
],
"cost": "<string>",
"issued_at": "<string>"
}
],
"output": {
"status": "<string>",
"lot": "<string>",
"serials": [
"<string>"
],
"cost": "<string>",
"unit_cost": "<string>",
"issued_as_recorded": true,
"completed_at": "<string>",
"reversed_at": "<string>"
},
"currency": "<string>",
"started_at": "<string>",
"can_trace": true,
"operations": [
{
"id": "<string>",
"sequence": 123,
"name": "<string>",
"work_center_id": "<string>",
"work_center_code": "<string>",
"work_center_name": "<string>",
"instructions": "<string>",
"setup_minutes": "<string>",
"run_minutes": "<string>",
"status": "<string>",
"started_at": "<string>",
"started_by_you": true,
"good_quantity": "<string>",
"scrap_quantity": "<string>",
"scrap_reason": "<string>",
"completed_at": "<string>",
"worked_minutes": "<string>",
"can_take": "<string>",
"blocked": "<string>",
"time_records": [
{
"id": "<string>",
"worked_by": 123,
"you": true,
"work_center_code": "<string>",
"started_at": "<string>",
"ended_at": "<string>",
"minutes": "<string>",
"corrects_id": "<string>",
"created_at": "<string>"
}
],
"subcontract": {
"supplier_id": "<string>",
"supplier_name": "<string>",
"service_item_id": "<string>",
"service_sku": "<string>",
"service_name": "<string>",
"unit_price": "<string>",
"purchase_order_id": "<string>",
"purchase_order_number": "<string>",
"sent": true,
"returned": true,
"cost": "<string>",
"send_blocked": "<string>",
"order_status": "<string>",
"notice": "<string>",
"can_bring_back": true,
"can_reorder": true
},
"checks": [
"<unknown>"
]
}
],
"problems": [
{
"id": "<string>",
"operation_id": "<string>",
"operation": "<string>",
"reason": "<string>",
"note": "<string>",
"has_photo": true,
"status": "<string>",
"reported_by_you": true,
"reported_at": "<string>",
"close_note": "<string>",
"closed_at": "<string>"
}
],
"can_run_operations": true,
"can_manage": true,
"priority": "<string>",
"planned_start_on": "<string>",
"planned_finish_on": "<string>",
"late": true,
"costs": {
"estimate": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"actual": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"variance": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"final": true,
"standard_unit_cost": "<string>",
"standard_variance": "<string>"
},
"can_print_labels": true
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}Builds
Report a problem on a build or one of its operations
Anyone who can see the build may report one, whatever its status, with
no approval: a reason, a note and perhaps a photo. Send it as
multipart/form-data with a photo, or as JSON without one. The photo
counts toward the plan’s attachment storage. It stays open until a manager
closes it. Emits manufacturing.problem.reported. Answers with the
build. Needs only the manufacturing.builds.view permission and a token
with manufacturing:write.
POST
/
manufacturing
/
builds
/
{build}
/
problems
cURL
curl --request POST \
--url https://app.stockshift.io/api/v1/manufacturing/builds/{build}/problems \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'note=<string>'import requests
url = "https://app.stockshift.io/api/v1/manufacturing/builds/{build}/problems"
payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001--"
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "multipart/form-data; boundary=---011000010111000001101001"
}
response = requests.post(url, data=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.stockshift.io/api/v1/manufacturing/builds/{build}/problems",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: multipart/form-data; boundary=---011000010111000001101001"
],
]);
$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://app.stockshift.io/api/v1/manufacturing/builds/{build}/problems"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"note\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "multipart/form-data; boundary=---011000010111000001101001")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"data": {
"id": "<string>",
"number": "<string>",
"status": "<string>",
"item_id": "<string>",
"item_sku": "<string>",
"item_name": "<string>",
"quantity": "<string>",
"unit": "<string>",
"location_id": "<string>",
"location_code": "<string>",
"location_name": "<string>",
"due_on": "<string>",
"note": "<string>",
"revision_label": "<string>",
"parts_list_fixed": true,
"blocked": "<string>",
"lines": [
{
"position": "<string>",
"component_id": "<string>",
"component_sku": "<string>",
"component_name": "<string>",
"required": "<string>",
"unit": "<string>",
"available": "<string>",
"short": "<string>",
"explanation": "<string>",
"open_orders": [
{
"number": "<string>",
"quantity": "<string>",
"expected_on": "<string>"
}
],
"alternates": [
{
"rank": 123,
"component_id": "<string>",
"component_sku": "<string>",
"component_name": "<string>",
"quantity": "<string>",
"unit": "<string>",
"available": "<string>"
}
],
"id": "<string>",
"held": "<string>",
"issued": "<string>",
"variance": "<string>",
"variance_reason": "<string>"
}
],
"released_at": "<string>",
"cancelled_at": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"can_complete": true,
"can_issue": true,
"issues": [
{
"step": 123,
"position": "<string>",
"component_id": "<string>",
"component_sku": "<string>",
"alternate_rank": 123,
"quantity": "<string>",
"lots": [
"<string>"
],
"serials": [
"<string>"
],
"cost": "<string>",
"issued_at": "<string>"
}
],
"output": {
"status": "<string>",
"lot": "<string>",
"serials": [
"<string>"
],
"cost": "<string>",
"unit_cost": "<string>",
"issued_as_recorded": true,
"completed_at": "<string>",
"reversed_at": "<string>"
},
"currency": "<string>",
"started_at": "<string>",
"can_trace": true,
"operations": [
{
"id": "<string>",
"sequence": 123,
"name": "<string>",
"work_center_id": "<string>",
"work_center_code": "<string>",
"work_center_name": "<string>",
"instructions": "<string>",
"setup_minutes": "<string>",
"run_minutes": "<string>",
"status": "<string>",
"started_at": "<string>",
"started_by_you": true,
"good_quantity": "<string>",
"scrap_quantity": "<string>",
"scrap_reason": "<string>",
"completed_at": "<string>",
"worked_minutes": "<string>",
"can_take": "<string>",
"blocked": "<string>",
"time_records": [
{
"id": "<string>",
"worked_by": 123,
"you": true,
"work_center_code": "<string>",
"started_at": "<string>",
"ended_at": "<string>",
"minutes": "<string>",
"corrects_id": "<string>",
"created_at": "<string>"
}
],
"subcontract": {
"supplier_id": "<string>",
"supplier_name": "<string>",
"service_item_id": "<string>",
"service_sku": "<string>",
"service_name": "<string>",
"unit_price": "<string>",
"purchase_order_id": "<string>",
"purchase_order_number": "<string>",
"sent": true,
"returned": true,
"cost": "<string>",
"send_blocked": "<string>",
"order_status": "<string>",
"notice": "<string>",
"can_bring_back": true,
"can_reorder": true
},
"checks": [
"<unknown>"
]
}
],
"problems": [
{
"id": "<string>",
"operation_id": "<string>",
"operation": "<string>",
"reason": "<string>",
"note": "<string>",
"has_photo": true,
"status": "<string>",
"reported_by_you": true,
"reported_at": "<string>",
"close_note": "<string>",
"closed_at": "<string>"
}
],
"can_run_operations": true,
"can_manage": true,
"priority": "<string>",
"planned_start_on": "<string>",
"planned_finish_on": "<string>",
"late": true,
"costs": {
"estimate": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"actual": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"variance": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"final": true,
"standard_unit_cost": "<string>",
"standard_variance": "<string>"
},
"can_print_labels": true
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}Authorizations
apiKeyoauth2
For your own scripts and server-to-server integrations. Create a key in the app under Settings > Access > API keys and copy it then, because it is shown once. Send it as Authorization: Bearer <key>. The key acts as the member who made it, in the organization it was made in. A call needs the member's permission and one of the key's scopes, such as inventory:read or sales:write. A key with * has every scope.
Path Parameters
Body
multipart/form-data
A problem on a build or one of its operations: what kind, what happened and perhaps a photo. The photo's type is worked out from its content, not its name.
material, machine, quality, instructions or other.
Available options:
material, machine, quality, instructions, other What happened, in words.
Maximum string length:
5000A UUIDv7 the client chose for the problem, so it can name the problem before it hears back.
The id of the build's operation it is about; left out, it is about the whole build.
Maximum string length:
64A PNG, JPEG, WebP or GIF picture of at most 10 MB.
Response
BuildResource
Show child attributes
Show child attributes
Was this page helpful?