{"openapi":"3.1.0","info":{"title":"Slatlyn Drawings API","description":"Turn a STEP file into finished technical drawings: every part auto-dimensioned on its own sheet, as DXF and PDF, assemblies included. Made for beams and panels. Drawing and previewing are free; you pay only when you download.\n\nNo driving of machines — the files produced are documents, not machine-control data; no warranty is given for the further use of the files in third-party systems.\n\nChanges in version 1.5: A refusal of POST /v1/jobs/{id}/files or GET /v1/jobs/{id}/files other than the 402 payment answer gives detail in the language Accept-Language asks for (English otherwise) and carries code, the refusal's fixed name, the same in every language, for example files_refused_not_requested (b40).","version":"1.5"},"paths":{"/v1/schema":{"get":{"summary":"Get Schema","operationId":"get_schema_v1_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/accounts":{"post":{"summary":"Create Account","operationId":"create_account_v1_accounts_post","parameters":[{"name":"x-admin-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account":{"get":{"summary":"Get Account","operationId":"get_account_v1_account_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"summary":"Patch Account","operationId":"patch_account_v1_account_patch","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/keys":{"get":{"summary":"List Keys","operationId":"list_keys_v1_account_keys_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Add Key","operationId":"add_key_v1_account_keys_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/keys/{key_id}":{"delete":{"summary":"Delete Key","operationId":"delete_key_v1_account_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs":{"post":{"summary":"Create Job","operationId":"create_job_v1_jobs_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"accept-language","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accept-Language"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_job_v1_jobs_post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}":{"get":{"summary":"Get Job","operationId":"get_job_v1_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"summary":"Patch Job","description":"Move one job's deletion day (#175) — the API's half of the\ncontrol in the customer's own job list, through the same\nmachinery.\n\nAny day between now and the job's ORIGINAL deadline, shortening\nand lengthening back alike, and never past it (owner, 30 August\n2026 — until then this could only shorten, so a caller who had\nset three days could not return to six although six was inside\nthe deadline the job was given). The check is\n:func:`service.storage.set_retention`, the one writer the page\nalso calls, and what it measures is the DEADLINE and not the day\ncount: ``retention_days: 0`` is delete-after-download, whose\nbackstop for a job nobody fetches is the full seven days, so on a\njob ORIGINALLY submitted at three days that setting still lands\npast the original deadline and is still refused.\n\n409 for a setting outside the window, with the settings inside it\nin the message — a refusal a caller cannot act on is half a\nrefusal. Answers the job document, so the caller sees the new\nstate without fetching again.\n\nTo delete a job outright, ``DELETE /v1/jobs/{id}``.","operationId":"patch_job_v1_jobs__job_id__patch","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete Job","description":"Delete the job with every file at once (C.157 decision 4): the\nanswer is 200 with the refund the deletion made - what was paid\nand not downloaded, its amount in cents (what went to Paddle and\nwhat waits apart) and whether it is on its way (``sent``), waits\nfor the operator (``awaiting_operator``), was already under way\n(``running``) or there is none (``none``). A deletion that could\nnot run answers 409 with ``deleted`` false (review S3). Changed in\nversion 1.2 (docs/API_CHANGELOG.md): it answered 204 without a\nbody before.","operationId":"delete_job_v1_jobs__job_id__delete","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"The job is deleted; the refund it made of what was paid and not downloaded.","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean"},"refund":{"type":"object","properties":{"cents":{"type":"integer"},"sent_cents":{"type":"integer"},"held_cents":{"type":"integer"},"currency":{"type":"string","example":"EUR"},"state":{"type":"string","enum":["none","sent","awaiting_operator","running"]}}}}}}}},"409":{"description":"The deletion could not run (another refund of the account was written in the same instant); the job and its money are unchanged, and a second request deletes it.","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean"},"detail":{"type":"string"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/cancel":{"post":{"summary":"Cancel Job","description":"Stop a running batch (#153) — the API's half of the page's\ncancel button, through the same machinery.\n\nC.78: it stops the DRAWING. A part whose drawing exists stays\ndrawn — its preview, and its files if they were asked for, which\nare still written — and stays downloadable; everything not yet\nbegun is skipped and costs nothing; a part a worker is drawing at\nthat moment is finished and counts as drawn. The job ends\n``cancelled`` (or rests at ``ready`` when its drawn parts wait\nfor their files to be asked for) once that part has landed.\nAnswers the job document, so a caller sees ``parts_drawn``,\n``parts_skipped`` and ``parts_being_drawn`` in the same response\nrather than having to fetch again to learn what it stopped.\n\n409 for a batch with nothing left to stop (``can_stop`` false in\nthe document): one already stopped, one that finished on its\nown, or one whose every part is drawn or being drawn. That is a\nrefusal and not a silent success, because a caller that believes\nit stopped a finished batch will also believe it was not billed\nfor one.\n\n503 with ``Retry-After`` where the database ended every try of\nthe stop over a lock conflict with a worker (b39h-cure3,\n:class:`~service.pipeline.StopBusy`): nothing of the stop stands\nand the same call again stops the batch.","operationId":"cancel_job_v1_jobs__job_id__cancel_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/parts/{n}":{"patch":{"summary":"Patch Part","description":"The per-part opt-out (#153) — the API's half of the tick box\non every tile, through the same machinery.\n\n``{\"keep\": false}`` means no paid files for this part and no\nunit; ``{\"keep\": true}`` puts it back in the queue. Answers the\npart's own line of the job document.\n\nEVERY PART, INTERCHANGEABLE OR NOT (C.14, owner 13.09.2026).\nA solid delivered on another position's sheet used to be refused\nhere with a 409 naming that position, because the group had one\ndecision and it sat on the part carrying the drawing. It has its\nown answer now, like every other solid the customer uploaded:\nexcluding it leaves the rest of its group exactly where it\nstands, and ``{\"group\": true}`` is how a caller says the answer\nis meant for all of them.\n\n409 when the box may not be moved, with the reason: the part has\nalready been delivered and is counted, or the batch was\ncancelled. Both are honest states rather than errors, and both\nare things a caller has to be told about rather than have\nsilently ignored.","operationId":"patch_part_v1_jobs__job_id__parts__n__patch","parameters":[{"name":"n","in":"path","required":true,"schema":{"type":"integer","title":"N"}},{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/events":{"get":{"summary":"Job Events","description":"Decision V12's live stream: one frame per part status change.","operationId":"job_events_v1_jobs__job_id__events_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/files":{"post":{"summary":"Request Files","description":"Ask for this batch's paid files, and answer the check question.\n\n202, not 201: nothing is finished when this returns. The work is\nqueued exactly like the drawing work was, and the caller watches\nit on the same event stream — ``GET /v1/jobs/{id}/events`` — that\nit watched the previews on.\n\nNOTHING IS BILLED HERE. Producing files has never been the paid\nact and this round did not make it one: the unit still books at\nthe first archive fetch, in ``GET /v1/jobs/{id}/files``.\n\nRefusals, and each of them writes nothing:\n\n* **403** — this account has not confirmed the partner duties.\n  The per-job check flag is not reachable until it has, because\n  the declaration a partner passes on is only worth anything if\n  he undertook to obtain it properly. See\n  ``POST /{lang}/account/partner-duty``.\n* **409** — the batch is not waiting to be asked (its previews are\n  not finished, or it was submitted with the automatic shape, or\n  it has already been asked).\n* **422** — the check question was not answered, or was answered\n  with a word that is not one of the two, or the notice was asked\n  to go off without the declaration behind it.","operationId":"request_files_v1_jobs__job_id__files_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"accept-language","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accept-Language"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilesRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Get Files","operationId":"get_files_v1_jobs__job_id__files_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"accept-language","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accept-Language"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/price":{"get":{"summary":"Get Price","description":"C.134: the price of the job's kept selection, as the order\nsummary computes it: the different parts, the bands, the minimum,\nthe fill-up numbers and what is already paid.","operationId":"get_price_v1_jobs__job_id__price_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"accept-language","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accept-Language"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/parts/{n}/preview.png":{"get":{"summary":"Get Preview","description":"The watermarked preview (V9), for the job's owner only.\n\nC.167: the owner is the signed-in account (its session cookie,\nwhich the page's ``<img>`` carries), a key of that account in the\nAPI's own headers, or the guest browser whose cookie names the\njob; anybody else gets the 404 an unknown id gets\n(:mod:`service.jobaccess`). Until C.167 the id alone opened it.\n\n``sheet`` (#168, W-sheetnav) pages through a split part's own\nsheets — 1 by default, so every existing caller of this route\nthat never names it keeps getting exactly the image it always\ngot. Bounded by the part's OWN stored ``sheet_count`` rather than\ntrusted blindly: a number outside that range names a sheet this\npart was never drawn with, which is a 404 and not a guess at the\nnearest real one.\n\nC.88: the picture is a FILE, written by the worker when the part\nwas drawn, and this route only sends it — nothing is drawn or\nrendered because somebody asked. ``v`` is the drawing's own number\nthe page puts in the address (C.43); asked for with the current\nnumber, the answer may be kept by the browser for good\n(:func:`service.assets.preview_cache_control`), so selecting a\npart a second time costs no request at all.","operationId":"get_preview_v1_jobs__job_id__parts__n__preview_png_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"n","in":"path","required":true,"schema":{"type":"integer","title":"N"}},{"name":"sheet","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Sheet"}},{"name":"v","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"V"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/parts/{n}/preview.svg":{"get":{"summary":"Get Vector Preview","description":"THE SHEET'S ENLARGEMENT (c243): the sharpest picture of one\nsheet the asker may have, for the job's owner only.\n\nThe vector picture (:func:`service.preview.render_preview_svg`,\nwritten beside the PNG when the part was drawn) where the drawing\nis the reader's already (:func:`service.jobpay.vector_allowed`: the\nsample, an exempt account, a paid or delivered part); anywhere\nelse, and for a sheet drawn before the vector picture existed, a\nredirect to the same sheet's watermarked PNG - so the viewer asks\nONE address and the server alone decides what it gets, and the\nanswer turns into the vector picture the moment the part is paid\n(the redirect is never kept). The same owner, the same 404 and\n409 and the same sheet bound as the PNG; the vector picture is\nkept by the browser on the same terms as the PNG\n(:func:`service.assets.preview_cache_control`) and sent gzipped\nas it is stored.","operationId":"get_vector_preview_v1_jobs__job_id__parts__n__preview_svg_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"n","in":"path","required":true,"schema":{"type":"integer","title":"N"}},{"name":"sheet","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Sheet"}},{"name":"v","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"V"}},{"name":"accept-encoding","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accept-Encoding"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/files/{file_n}/mesh.json":{"get":{"summary":"Get Mesh Manifest","description":"The assembly mesh's manifest, for the job's owner only.\n\nC.167: the same owner the preview PNG answers — the viewer's\n``fetch`` carries the session and the guest cookie\n(``credentials: \"same-origin\"``), a machine caller its key — and\nthe 404 of an unknown id for anybody else\n(:mod:`service.jobaccess`).","operationId":"get_mesh_manifest_v1_jobs__job_id__files__file_n__mesh_json_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"file_n","in":"path","required":true,"schema":{"type":"integer","title":"File N"}},{"name":"accept-encoding","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accept-Encoding"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/files/{file_n}/mesh.bin":{"get":{"summary":"Get Mesh Buffer","description":"The shared vertex/index buffer the manifest indexes into, for\nthe job's owner only (C.167).","operationId":"get_mesh_buffer_v1_jobs__job_id__files__file_n__mesh_bin_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"file_n","in":"path","required":true,"schema":{"type":"integer","title":"File N"}},{"name":"accept-encoding","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accept-Encoding"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/jobs/{job_id}/files/{file_n}/kinds.json":{"get":{"summary":"Get Mesh Kinds","description":"C.211-B2a: beam or plate, Sichtseite and Maserung of every part\nof one file, as the 3D view reads them (:mod:`service.kindview`),\nfor the job's owner only and only while the plate feature is\non - otherwise the 404 of an address that does not exist.","operationId":"get_mesh_kinds_v1_jobs__job_id__files__file_n__kinds_json_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"file_n","in":"path","required":true,"schema":{"type":"integer","title":"File N"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AccountCreate":{"properties":{"email":{"type":"string","maxLength":255,"minLength":3,"title":"Email"},"name":{"type":"string","maxLength":255,"title":"Name","default":""},"plan":{"type":"string","maxLength":32,"title":"Plan","default":"trial"},"quota_monthly":{"type":"integer","maximum":1000000.0,"minimum":0.0,"title":"Quota Monthly","default":0},"retention_days":{"type":"integer","maximum":7.0,"minimum":0.0,"title":"Retention Days","default":7}},"additionalProperties":false,"type":"object","required":["email"],"title":"AccountCreate","description":"What it takes to open an account on the local service."},"AccountUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name"},"retention_days":{"anyOf":[{"type":"integer","maximum":7.0,"minimum":0.0},{"type":"null"}],"title":"Retention Days"}},"additionalProperties":false,"type":"object","title":"AccountUpdate","description":"The settings an account holder may change (V18: retention)."},"Body_create_job_v1_jobs_post":{"properties":{"file":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"File"},"settings":{"type":"string","title":"Settings","default":"{}"}},"type":"object","required":["file"],"title":"Body_create_job_v1_jobs_post"},"FilesRequest":{"properties":{"checked":{"type":"string","title":"Checked","description":"The customer's answer to the check question. \"yes\": he has checked this order's drawings, so the printed check notice is left off. \"no\": the files are made with the notice on every sheet, which needs no declaration and is the ordinary case."}},"additionalProperties":false,"type":"object","required":["checked"],"title":"FilesRequest","description":"A partner asking for one batch's paid files, and answering the\ncheck question for it (#242).\n\nTHE SECOND CALL, and the only door through which the printed check\nnotice can be left off. The reason is the ordering problem the whole\ncheck-notice ruling turns on: the declaration is about drawings the\ndeclaring person has SEEN, so it cannot honestly ride the request\nthat CREATES a job, when no drawing exists yet. A partner who wants\nthe notice off submits with ``file_production: \"on_request\"``, shows\nhis own customer the previews this service already serves at\n``GET /v1/jobs/{id}/parts/{n}/preview.png`` — free, before any\ndownload books a unit — obtains the declaration from him, and then\ncalls this.\n\nONE FIELD, WITH THE SAME TWO ANSWERS THE FORM OFFERS (owner, 30\nAugust 2026). This body carried two until that finding — a\n``declaration`` boolean and a ``verification_notice`` boolean — which\nis the very defect the owner struck out of the web form: two controls\nfor one decision, the second able to contradict the first. There is\none decision, so there is one field, and whether the notice prints\nfollows its answer through\n:func:`service.checknotice.notice_printed_for_answer`, the one\nfunction the form's route reads too.\n\n``checked`` IS REQUIRED AND HAS NO DEFAULT, which is this API's form\nof \"neither answer is preselected\". The retired ``declaration: bool =\nFalse`` silently answered \"no\" for a caller who sent nothing, so a\npartner who forgot the field made a recorded decision without\nknowing it. A body with no answer is refused (422) exactly as the\nunanswered form is.\n\n``extra=\"forbid\"`` like every other body here: a caller who misspells\na field on a request that decides what a drawing says is told so —\nwhich also means a caller still sending the two retired fields is\ntold, rather than having them quietly ignored."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"JobUpdate":{"properties":{"retention_days":{"type":"integer","maximum":7.0,"minimum":0.0,"title":"Retention Days"}},"additionalProperties":false,"type":"object","required":["retention_days"],"title":"JobUpdate","description":"What a caller may change about one of its own JOBS (#175).\n\nExactly one thing: the deletion day, anywhere inside this job's own\nwindow. The bounds here are the plan's own two ends, read from\n:mod:`service.accounts` rather than typed, and they are a sanity lid\nand not the rule — the rule is that the new setting must land\nbetween now and the job's ORIGINAL deadline, which only\n:func:`service.storage.set_retention` can decide, because it is the\nonly thing that knows the job.\n\n``extra=\"forbid\"`` like every other body here: a caller that\nmisspells the field is told so (422) rather than having its request\nquietly do nothing."},"KeyCreate":{"properties":{"label":{"type":"string","maxLength":100,"title":"Label","default":""},"password":{"type":"string","maxLength":200,"title":"Password","default":""}},"additionalProperties":false,"type":"object","title":"KeyCreate"},"PartUpdate":{"properties":{"keep":{"type":"boolean","title":"Keep"},"group":{"type":"boolean","title":"Group","default":false}},"additionalProperties":false,"type":"object","required":["keep"],"title":"PartUpdate","description":"What a caller may change about one part of its own job (#153).\n\nOne thing and one shortcut to it: whether the customer wants that\npart's paid files at all, and whether the same answer applies to the\nrest of its interchangeable group. ``extra=\"forbid\"`` like every\nother body here — a caller that misspells the field is told so (422)\nrather than having its request quietly do nothing, which on a field\nthat decides what is charged would be the worst possible silence."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}