Add an attachment to the work order. Work order must be in the DRAFT state. One attachment can be added per request. Attachments can be IMAGE, FILE, or TEXT (corresponding to the same data types in Serial).
The work order UUID (work_order.id) or work order number (work_order.wo_number). Both will map to the same work order
Body
multipart/form-data
The request body is multipart form data and must include a JSON metadata object named metadata as well as optionally an image or file (of any format) named attachment if metadata.type is set to IMAGE or FILE. The example body shown here is that only of the metadata. The file binary would need to be attached sperately.
Multiple datasets can be added to the attachments object
Show child attributes
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Serial","colors":{"primary":"#1C2D33","light":"#F8FAFC","dark":"#21293A"},"favicon":"/favicon.png","logo":{"light":"https://mintcdn.com/serial/SIljb6ZyxcerJBNg/logo/Submark%20Light.png?fit=max\u0026auto=format\u0026n=SIljb6ZyxcerJBNg\u0026q=85\u0026s=31021d14e90d5ffbc0622406b344f8d9","dark":"https://mintcdn.com/serial/SIljb6ZyxcerJBNg/logo/Submark%20Dark.png?fit=max\u0026auto=format\u0026n=SIljb6ZyxcerJBNg\u0026q=85\u0026s=9e16c13a91307a0330308e371fc3228a"},"navbar":{"primary":{"type":"button","label":"Get Started","href":"https:www.app.serial.io"}},"footer":{"socials":{"twitter":"https://twitter.com/Serialmfg","linkedin":"https://www.linkedin.com/company/serialmfg"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"serial","hasAudioNarration":false,"actualSubdomain":"serial","customDomains":["docs.serial.io"],"gitSource":{"type":"github","owner":"serialmfg","repo":"serial-app","deployBranch":"main","contentDirectory":"documentation","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20c34c4d01e0d38c5e4773","collectionId":"9b1df4db-5db5-4588-a1f2-d7ee487458d9","schemaVersion":"v2"},"entitlements":{},"buildId":"6a20c34c4d01e0d38c5e4773:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":41},{"language":"default","tag":"Work Orders","count":12},{"language":"default","tag":"Documentation","count":9},{"language":"default","tag":"Component Instances","count":5},{"language":"default","tag":"Processes","count":5},{"language":"default","tag":"Setup","count":5},{"language":"default","tag":"Datasets","count":4},{"language":"default","tag":"Properties","count":4},{"language":"default","tag":"Components","count":3},{"language":"default","tag":"Legacy API","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/work-orders/add-attachment","slug":"/api-reference/work-orders/add-attachment","pageMetadata":{"title":"Add Attachment","openapi":"PUT /work-orders/{id}/attachments","description":"Add an attachment to the work order. Work order must be in the `DRAFT` state. One attachment can be added per request. Attachments can be `IMAGE`, `FILE`, or `TEXT` (corresponding to the same data types in Serial). ","href":"/api-reference/work-orders/add-attachment"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Add an attachment to the work order. Work order must be in the \", _jsx(_components.code, {\n children: \"DRAFT\"\n }), \" state. One attachment can be added per request. Attachments can be \", _jsx(_components.code, {\n children: \"IMAGE\"\n }), \", \", _jsx(_components.code, {\n children: \"FILE\"\n }), \", or \", _jsx(_components.code, {\n children: \"TEXT\"\n }), \" (corresponding to the same data types in Serial).\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Add Attachment","openapi":"PUT /work-orders/{id}/attachments","description":"Add an attachment to the work order. Work order must be in the `DRAFT` state. One attachment can be added per request. Attachments can be `IMAGE`, `FILE`, or `TEXT` (corresponding to the same data types in Serial). ","href":"/api-reference/work-orders/add-attachment"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Add Attachment","operationId":"put-work-orders-attachments","responses":{"200":"add88458-7ca7-4adc-ac97-9ed5ea9e8f45"},"description":"Add an attachment to the work order. Work order must be in the `DRAFT` state. One attachment can be added per request. Attachments can be `IMAGE`, `FILE`, or `TEXT` (corresponding to the same data types in Serial). ","parameters":["b6f36688-89fb-4f08-a8fb-4907b53a5a3e"],"requestBody":"7797bbe8-22e8-481b-8829-54c5b3c97375","tags":["Work Orders"],"x-stoplight":{"id":"941xi2od3ze37"},"method":"put","type":"path","servers":["216b2f1f-936e-48df-8571-0cddb434a9b5"],"security":["82db7c5b-a855-4ce7-b216-03c5df20b316"],"path":"/work-orders/{id}/attachments","baseUrlOptions":["https://api.serial.io"],"title":"Add Attachment","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b6f36688-89fb-4f08-a8fb-4907b53a5a3e":{"schema":{"type":"string","description":"Should be multipart form data","uniqueKey":"","typeLabel":"string"},"in":"header","name":"Content-Type","description":"Should be multipart form data"},"70b475bd-6818-4b58-a31a-46a6f6f3ad90":{"name":"id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"The work order UUID (`work_order.id`) or work order number (`work_order.wo_number`). Both will map to the same work order","uniqueKey":"","typeLabel":"string"},"description":"The work order UUID (`work_order.id`) or work order number (`work_order.wo_number`). Both will map to the same work order"}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"type":{"x-stoplight":{"id":"kusj478jiazvb"},"enum":["IMAGE","FILE","TEXT"],"type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"name":{"type":"string","x-stoplight":{"id":"zc3cigbn1ea9l"},"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"added_by_user_id":{"type":"string","x-stoplight":{"id":"ts37g4elgnga9"},"format":"uuid","isRequired":true,"uniqueKey":"added_by_user_id","typeLabel":"string\u003cuuid>"},"value":{"type":"string","x-stoplight":{"id":"0byx4xzduly3q"},"description":"Include only for `TEXT` attachments","uniqueKey":"value","typeLabel":"string"},"file_name":{"type":"string","x-stoplight":{"id":"clehln50ljsqh"},"description":"Include only for `FILE` or `IMAGE` attachments","uniqueKey":"file_name","typeLabel":"string"}},"required":["type","name","added_by_user_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","added_by_user_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","value":"\u003cstring>","file_name":"\u003cstring>"}}},"exampleType":"generated"}},"description":"The request body is multipart form data and must include a JSON metadata object named `metadata` as well as optionally an image or file (of any format) named `attachment` if `metadata.type` is set to `IMAGE` or `FILE`. The example body shown here is that only of the `metadata`. The file binary would need to be attached sperately.","exampleType":"generated"},"responses":{"add88458-7ca7-4adc-ac97-9ed5ea9e8f45":{"description":"OK","content":{"application/json":{"schema":{"type":"object","x-examples":{"Example 1":{"id":"550e8400-e29b-41d4-a716-446655440000","company_id":"550e8400-e29b-41d4-a716-446655440001","wo_number":12345,"name":"Work Order 1","description":"This is a test work order","component_id":"550e8400-e29b-41d4-a716-446655440002","part_number_id":null,"created_at":"2023-06-27T10:15:00.000Z","created_by_user_id":"550e8400-e29b-41d4-a716-446655440003","status":"APPROVED","phase":"Phase 1","quantity":10,"approvals":[{"approver_id":"550e8400-e29b-41d4-a716-446655440004","requested_by":"550e8400-e29b-41d4-a716-446655440005","requested_at":"2023-06-26T08:00:00.000Z","status":null,"last_updated_at":null}],"assignee_user_id":"550e8400-e29b-41d4-a716-446655440006","deadline":"2023-07-27T10:15:00.000Z","activity_log":[{"id":"550e8400-e29b-41d4-a716-446655440007","message":"Work order created","created_at":"2023-06-27T10:15:00.000Z","created_by":"550e8400-e29b-41d4-a716-446655440008","type":"CREATION"}],"last_edited_at":"2023-06-27T10:20:00.000Z"}},"description":"Work Order Data","properties":{"id":{"type":"string","uniqueKey":"id","typeLabel":"string"},"wo_number":{"type":"integer","minimum":0,"uniqueKey":"wo_number","typeLabel":"integer"},"name":{"type":"string","uniqueKey":"name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"component_id":{"type":"string","uniqueKey":"component_id","typeLabel":"string"},"part_number_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"part_number_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"part_number_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"part_number_id","typeLabel":"string\u003cuuid> | null"},"created_at":{"type":"string","format":"date-time","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"created_by_user_id":{"type":"string","format":"uuid","uniqueKey":"created_by_user_id","typeLabel":"string\u003cuuid>"},"status":{"enum":["DRAFT","REVIEW","PRODUCTION","COMPLETE","CANCELED","ARCHIVED"],"default":"DRAFT","type":"string","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"phase":{"type":"string","uniqueKey":"phase","typeLabel":"string"},"quantity":{"type":"integer","uniqueKey":"quantity","typeLabel":"integer"},"approvals":{"type":"object","description":"Approvals object will have one key value pair for every approver","properties":{"[approver_user_id]":{"type":"object","x-stoplight":{"id":"2de15jln9d5rj"},"properties":{"approver_user_id":{"type":"string","format":"uuid","x-stoplight":{"id":"1lkn81sb5itfg"},"uniqueKey":"approvals.[approver_user_id].approver_user_id","typeLabel":"string\u003cuuid>"},"requested_by_user_id":{"type":"string","format":"uuid","x-stoplight":{"id":"2u2e3mz9tj0vn"},"uniqueKey":"approvals.[approver_user_id].requested_by_user_id","typeLabel":"string\u003cuuid>"},"requested_at":{"type":"string","format":"date-time","uniqueKey":"approvals.[approver_user_id].requested_at","typeLabel":"string\u003cdate-time>"},"status":{"enum":["APPROVED","REJECTED",null],"uniqueKey":"approvals.[approver_user_id].status","typeLabel":"any"},"last_updated_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"approvals.[approver_user_id].last_updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"approvals.[approver_user_id].last_updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"approvals.[approver_user_id].last_updated_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"approvals.[approver_user_id]","typeLabel":"object"}},"uniqueKey":"approvals","typeLabel":"object"},"assignee_user_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"assignee_user_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"assignee_user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"assignee_user_id","typeLabel":"string\u003cuuid> | null"},"deadline":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"deadline.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"deadline.oneOf.1","typeLabel":"null"}],"uniqueKey":"deadline","typeLabel":"string\u003cdate-time> | null"},"activity_log":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"activity_log.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"message":{"oneOf":[{"type":"string","uniqueKey":"activity_log.items.[INDEX].message.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"activity_log.items.[INDEX].message.oneOf.1","typeLabel":"null"}],"uniqueKey":"activity_log.items.[INDEX].message","typeLabel":"string | null"},"added_at":{"type":"string","format":"date-time","x-stoplight":{"id":"namn2karaaux7"},"uniqueKey":"activity_log.items.[INDEX].added_at","typeLabel":"string\u003cdate-time>"},"added_by_user_id":{"type":"string","format":"uuid","x-stoplight":{"id":"50mo1pr3t2i5r"},"uniqueKey":"activity_log.items.[INDEX].added_by_user_id","typeLabel":"string\u003cuuid>"},"type":{"enum":["CREATED","COMMENTED","SET_STATUS","GENERAL_UPDATE","SET_APPROVAL","UPDATED_APPROVERS","REMOVED_APPROVAL"],"type":"string","uniqueKey":"activity_log.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"data":{"type":"string","x-stoplight":{"id":"13txktq4uwfrl"},"description":"Data object dependant on the activity type","uniqueKey":"activity_log.items.[INDEX].data","typeLabel":"string"}},"uniqueKey":"activity_log.items.[INDEX]","typeLabel":"object"},"uniqueKey":"activity_log","typeLabel":"object[]"},"last_edited_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"last_edited_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"last_edited_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_edited_at","typeLabel":"string\u003cdate-time> | null"},"attachments":{"type":"array","x-stoplight":{"id":"8rlgsuy75vqly"},"description":"Multiple datasets can be added to the attachments object","items":{"x-stoplight":{"id":"zx4wqr1jrbnmc"},"type":"object","properties":{"dataset_id":{"type":"string","x-stoplight":{"id":"1j8c082mffovz"},"format":"uuid","uniqueKey":"attachments.items.[INDEX].dataset_id","typeLabel":"string\u003cuuid>"},"value":{"type":"string","x-stoplight":{"id":"tlav6dj9prhzu"},"description":"Value is the file id if the data type is file or image. Otherwise it is the attachment text value","uniqueKey":"attachments.items.[INDEX].value","typeLabel":"string"},"file_name":{"oneOf":[{"type":"string","x-stoplight":{"id":"s33ev6fa0xciv"},"format":"uuid","uniqueKey":"attachments.items.[INDEX].file_name.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","x-stoplight":{"id":"s33ev6fa0xciv"},"format":"uuid","uniqueKey":"attachments.items.[INDEX].file_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"attachments.items.[INDEX].file_name","typeLabel":"string\u003cuuid> | null"},"added_at":{"type":"string","x-stoplight":{"id":"igyrvi94hruib"},"format":"date-time","uniqueKey":"attachments.items.[INDEX].added_at","typeLabel":"string\u003cdate-time>"},"added_by_user_id":{"type":"string","x-stoplight":{"id":"da6jads6oqvh3"},"uniqueKey":"attachments.items.[INDEX].added_by_user_id","typeLabel":"string"},"is_deleted":{"type":"boolean","x-stoplight":{"id":"dhrjruagqnjte"},"uniqueKey":"attachments.items.[INDEX].is_deleted","typeLabel":"boolean"}},"uniqueKey":"attachments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"attachments","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","wo_number":1,"name":"\u003cstring>","description":"\u003cstring>","component_id":"\u003cstring>","part_number_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","created_at":"2023-11-07T05:31:56Z","created_by_user_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"DRAFT","phase":"\u003cstring>","quantity":123,"approvals":{"[approver_user_id]":{"approver_user_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","requested_by_user_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","requested_at":"2023-11-07T05:31:56Z","status":"APPROVED","last_updated_at":"2023-11-07T05:31:56Z"}},"assignee_user_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","deadline":"2023-11-07T05:31:56Z","activity_log":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","message":"\u003cstring>","added_at":"2023-11-07T05:31:56Z","added_by_user_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","type":"CREATED","data":"\u003cstring>"}],"last_edited_at":"2023-11-07T05:31:56Z","attachments":[{"dataset_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","value":"\u003cstring>","file_name":"3c90c3cc-0d44-4b50-8888-8dd25736052a","added_at":"2023-11-07T05:31:56Z","added_by_user_id":"\u003cstring>","is_deleted":true}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"82db7c5b-a855-4ce7-b216-03c5df20b316":{"serial-default-security":{"type":"http","scheme":"bearer","description":"**API Key** or **Token** formatted as `Bearer \u003cYOUR_KEY_OR_TOKEN>`","scopes":[]}}},"servers":{"216b2f1f-936e-48df-8571-0cddb434a9b5":{"url":"https://api.serial.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"**API Key** or **Token** formatted as `Bearer \u003cYOUR_KEY_OR_TOKEN>`","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"**API Key** or **Token** formatted as `Bearer \u003cYOUR_KEY_OR_TOKEN>`","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"serial-default-security","name":"Authorization"}],"title":"serial-default-security"}]},"originalFileLocation":"serial.json"},"subdomain":"serial","siteName":"Serial","title":"Add Attachment - Serial","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-06T22:47:28.149Z","originalFileLocation":"api-reference/work-orders/add-attachment.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add an attachment to the work order. Work order must be in the DRAFT state. One attachment can be added per request. Attachments can be IMAGE, FILE, or TEXT (corresponding to the same data types in Serial).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Serial\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/serial/c5ZUi_E9f6w_jgf7/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/serial/c5ZUi_E9f6w_jgf7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/serial/c5ZUi_E9f6w_jgf7/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/serial/c5ZUi_E9f6w_jgf7/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/serial/c5ZUi_E9f6w_jgf7/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/serial/c5ZUi_E9f6w_jgf7/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/serial/c5ZUi_E9f6w_jgf7/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/serial/c5ZUi_E9f6w_jgf7/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/serial/c5ZUi_E9f6w_jgf7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add Attachment - Serial\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add an attachment to the work order. Work order must be in the DRAFT state. One attachment can be added per request. Attachments can be IMAGE, FILE, or TEXT (corresponding to the same data types in Serial).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Serial\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.serial.io/api-reference/work-orders/add-attachment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://serial.mintlify.app/_mintlify/api/og/v2?division=Work+Orders\u0026amp;title=Add+Attachment\u0026amp;description=Add+an+attachment+to+the+work+order.+Work+order+must+be+in+the+%60DRAFT%60+state.+One+attachment+can+be+added+per+request.+Attachments+can+be+%60IMAGE%60%2C+%60FILE%60%2C+or+%60T\u0026amp;theme=b302118416d039f93292a1e1\u0026amp;signature=cfa235a9614bb5b2e2d879b6f00a3ff1e6c27b0a51ce30d66a3c0e015aa28669\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Add Attachment - Serial\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add an attachment to the work order. Work order must be in the DRAFT state. One attachment can be added per request. Attachments can be IMAGE, FILE, or TEXT (corresponding to the same data types in Serial).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://serial.mintlify.app/_mintlify/api/og/v2?division=Work+Orders\u0026amp;title=Add+Attachment\u0026amp;description=Add+an+attachment+to+the+work+order.+Work+order+must+be+in+the+%60DRAFT%60+state.+One+attachment+can+be+added+per+request.+Attachments+can+be+%60IMAGE%60%2C+%60FILE%60%2C+or+%60T\u0026amp;theme=b302118416d039f93292a1e1\u0026amp;signature=cfa235a9614bb5b2e2d879b6f00a3ff1e6c27b0a51ce30d66a3c0e015aa28669\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/serial/c5ZUi_E9f6w_jgf7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Serial\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1C2D33\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.serial.io/api-reference/work-orders/add-attachment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/work-orders/add-attachment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.serial.io/#organization\",\"name\":\"Serial\",\"url\":\"https://docs.serial.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/serial/SIljb6ZyxcerJBNg/logo/Submark%20Light.png?fit=max\u0026auto=format\u0026n=SIljb6ZyxcerJBNg\u0026q=85\u0026s=31021d14e90d5ffbc0622406b344f8d9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.serial.io#website\",\"name\":\"Serial\",\"url\":\"https://docs.serial.io\",\"publisher\":{\"@id\":\"https://docs.serial.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.serial.io/api-reference/work-orders/add-attachment#webpage\",\"url\":\"https://docs.serial.io/api-reference/work-orders/add-attachment\",\"name\":\"Add Attachment\",\"description\":\"Add an attachment to the work order. Work order must be in the DRAFT state. One attachment can be added per request. Attachments can be IMAGE, FILE, or TEXT (corresponding to the same data types in Serial).\",\"dateModified\":\"2026-01-06T22:47:28.149Z\",\"isPartOf\":{\"@id\":\"https://docs.serial.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.serial.io/api-reference/work-orders/add-attachment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.serial.io/api-reference/work-orders/add-attachment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Work Orders\",\"item\":\"https://docs.serial.io/api-reference/work-orders/list-all-work-orders\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add Attachment\",\"item\":\"https://docs.serial.io/api-reference/work-orders/add-attachment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.serial.io/api-reference/work-orders/add-attachment#apireference\",\"headline\":\"Add Attachment\",\"name\":\"Add Attachment\",\"description\":\"Add an attachment to the work order. Work order must be in the DRAFT state. One attachment can be added per request. Attachments can be IMAGE, FILE, or TEXT (corresponding to the same data types in Serial).\",\"url\":\"https://docs.serial.io/api-reference/work-orders/add-attachment\",\"mainEntityOfPage\":{\"@id\":\"https://docs.serial.io/api-reference/work-orders/add-attachment#webpage\"},\"dateModified\":\"2026-01-06T22:47:28.149Z\",\"publisher\":{\"@id\":\"https://docs.serial.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.serial.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Serial\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Serial","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":{"name":"book-open","style":"duotone"},"pages":[{"title":"Documentation","href":"/welcome/introduction"}]},{"anchor":"API Reference","icon":"rectangle-terminal","color":{"light":"#1e293b","dark":"#1e293b"},"groups":[{"group":"Component Instances","pages":[{"title":"Get Component Instances","openapi":"GET /components/instances","href":"/api-reference/component-instances/get-component-instances"},{"title":"Create Component Instance","openapi":"PUT /components/instances","href":"/api-reference/component-instances/create-component-instance"},{"title":"Get Component Instance Links","openapi":"GET /components/instances/links","href":"/api-reference/component-instances/get-component-instance-links"},{"title":"Create Component Instance Link","openapi":"PUT /components/instances/links","href":"/api-reference/component-instances/create-component-instance-link"},{"title":"Delete Component Instance Link","openapi":"DELETE /components/instances/links","href":"/api-reference/component-instances/delete-component-instance-link"}]},{"group":"Work Orders","pages":[{"title":"List all work orders","openapi":"GET /work-orders","href":"/api-reference/work-orders/list-all-work-orders"},{"title":"Create a work order","openapi":"POST /work-orders","href":"/api-reference/work-orders/create-a-work-order"},{"title":"Add Approver","openapi":"PUT /work-orders/{id}/approvals","description":"Request approval from a Serial user. Work order must be in the `DRAFT` or `REVIEW` state","href":"/api-reference/work-orders/add-approver"},{"title":"Add Attachment","openapi":"PUT /work-orders/{id}/attachments","href":"/api-reference/work-orders/add-attachment"},{"title":"Add Comment","openapi":"POST /work-orders/{id}/comments","description":"Add a comment to the activity log","href":"/api-reference/work-orders/add-comment"},{"title":"Approve or Reject Review","openapi":"PATCH /work-orders/{id}/approvals","href":"/api-reference/work-orders/approve-or-reject-review"},{"title":"Delete Approver","openapi":"DELETE /work-orders/{id}/approvals/{approver_user_id}","href":"/api-reference/work-orders/delete-approver"},{"title":"Delete Attachment","openapi":"DELETE /work-orders/{id}/approvals/{approver_user_id}","href":"/api-reference/work-orders/delete-attachment"},{"title":"Delete Work Order","openapi":"DELETE /work-order/{id}","href":"/api-reference/work-orders/delete-work-order"},{"title":"Retrieve Work Order","openapi":"GET /work-order/{id}","href":"/api-reference/work-orders/retrieve-work-order"},{"title":"Update Status","openapi":"PATCH /work-orders/{id}/status","href":"/api-reference/work-orders/update-status"},{"title":"Update Work Order","openapi":"PATCH /work-order/{id}","href":"/api-reference/work-orders/update-work-order"}]},{"group":"Processes","pages":[{"title":"Get Processes","openapi":"GET /processes","href":"/api-reference/processes/get-processes"},{"title":"Create Process Entry","openapi":"POST /processes/entries","href":"/api-reference/processes/create-process-entry"},{"title":"Get Process Entries","openapi":"GET /processes/entries","href":"/api-reference/processes/get-process-entries"},{"title":"Add Process Data","openapi":"PUT /processes/entries/{process_entry_id}","href":"/api-reference/processes/add-process-data"},{"title":"Update Process Entry","openapi":"PATCH /processes/entries/{process_entry_id}","href":"/api-reference/processes/update-process-entry"}]},{"group":"Storage","pages":[{"title":"Get Files","openapi":"GET /files","href":"/api-reference/storage/get-files"},{"title":"Upload Files","openapi":"POST /files","href":"/api-reference/storage/upload-files"}]},{"group":"Datasets","pages":[{"title":"Get Datasets","openapi":"GET /datasets","href":"/api-reference/datasets/get-datasets"},{"title":"Create Dataset","openapi":"PUT /datasets","href":"/api-reference/datasets/create-dataset"},{"title":"Update Dataset","openapi":"PATCH /datasets/{dataset_id}","href":"/api-reference/datasets/update-dataset"},{"title":"Delete Dataset","openapi":"DELETE /datasets/{dataset_id}","href":"/api-reference/datasets/delete-dataset"}]},{"group":"Components","pages":[{"title":"Get Components","openapi":"GET /components","href":"/api-reference/components/get-components"},{"title":"Create New Component","openapi":"POST /components","href":"/api-reference/components/create-new-component"},{"title":"Create Component Link","openapi":"PUT /components/links","href":"/api-reference/components/create-component-link"}]},{"group":"Properties","pages":[{"title":"Create New Component Property","openapi":"POST /components/{id}/properties","href":"/api-reference/properties/create-new-component-property"},{"title":"Get Component Instance Properties","openapi":"GET /components/instances/{id}/properties","href":"/api-reference/properties/get-component-instance-properties"},{"title":"Get Component Properties","openapi":"GET /components/{id}/properties","href":"/api-reference/properties/get-component-properties"},{"title":"Update Component Instance Properties","openapi":"PUT /components/instances/{id}/properties/{propertyId}","href":"/api-reference/properties/update-component-instance-property"}]},{"group":"Fields","pages":[{"title":"Get Fields","openapi":"GET /fields","href":"/api-reference/fields/get-fields"}]},{"group":"Part Numbers","pages":[{"title":"Get Part Numbers","openapi":"GET /part-numbers","href":"/api-reference/part-numbers/get-part-numbers"},{"title":"Create Part Number","openapi":"POST /part-numbers","href":"/api-reference/part-numbers/create-part-number"}]},{"group":"Legacy API","pages":[{"title":"Upload Process Data","openapi":"POST /process-data","href":"/api-reference/legacy/upload-process-data"},{"title":"Create Serial Number","openapi":"POST /identifier","href":"/api-reference/legacy/create-unique-identifier"},{"title":"Check Serial Connection","openapi":"POST /connection","href":"/api-reference/legacy/check-serial-connection"}]}]},{"anchor":"Python Library","icon":"python","color":{"light":"#1e293b","dark":"#1e293b"},"pages":[{"title":"Python Library","href":"/python/quickstart"}]},{"anchor":"Blog","href":"https://www.serial.io/blog","icon":"newspaper","color":{"light":"#1e293b","dark":"#1e293b"}}]},"basePath":"","title":"Add Attachment - Serial","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}