An API key created by the chain owner in the panel (Integrações → Nova chave), sent as Authorization: Bearer <key>. The key (<id>|na_…) is shown once, at creation; rotate or revoke it on the same screen. It is a server secret: never ship it in browser or mobile code.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Need Alert","description":"Avise seus clientes no momento em que o que eles esperam fica disponível.","colors":{"primary":"#465FFF","light":"#7C8CFF","dark":"#3641CC"},"logo":{"light":"https://mintcdn.com/need-alert/9mmUrKHe_2MF526d/logo/light.svg?fit=max\u0026auto=format\u0026n=9mmUrKHe_2MF526d\u0026q=85\u0026s=373a6fb813b58847213edb4a69e07fc2","dark":"https://mintcdn.com/need-alert/9mmUrKHe_2MF526d/logo/dark.svg?fit=max\u0026auto=format\u0026n=9mmUrKHe_2MF526d\u0026q=85\u0026s=30c19faa6f0c69ad4ce03787eb0be7fd"},"favicon":"https://mintcdn.com/need-alert/9mmUrKHe_2MF526d/favicon.svg?fit=max\u0026auto=format\u0026n=9mmUrKHe_2MF526d\u0026q=85\u0026s=3232d54c500467b3b6694a4c942ed879","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript","python","php"]}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"pt-BR","default":true,"href":""},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"need-alert","hasAudioNarration":false,"actualSubdomain":"need-alert","customDomains":["docs.needalert.app"],"gitSource":{"type":"github","owner":"claudiusnascimento","repo":"docs-need-alert","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ad760e76e89f16d0373b3c1","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"pt-BR","tag":"API","count":26},{"language":"en","tag":"API","count":26},{"language":"pt-BR","tag":"Guias","count":18},{"language":"pt-BR","tag":"Endpoints","count":18},{"language":"en","tag":"Guides","count":18},{"language":"en","tag":"Endpoints","count":18},{"language":"pt-BR","tag":"Para estabelecimentos","count":8},{"language":"pt-BR","tag":"Items","count":8},{"language":"en","tag":"For establishments","count":8},{"language":"en","tag":"Items","count":8},{"language":"pt-BR","tag":"Dispatches","count":6},{"language":"en","tag":"Dispatches","count":6},{"language":"pt-BR","tag":"Para quem espera","count":4},{"language":"en","tag":"For people waiting","count":4},{"language":"pt-BR","tag":"Introdução","count":3},{"language":"pt-BR","tag":"Começando","count":3},{"language":"en","tag":"Introduction","count":3},{"language":"en","tag":"Getting started","count":3},{"language":"pt-BR","tag":"Convenções","count":2},{"language":"en","tag":"Conventions","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api/reference/items/upload-the-items-picture","slug":"/api/reference/items/upload-the-items-picture","pageMetadata":{"title":"Upload the item's picture","description":"`multipart/form-data` with one `image` file: JPEG, PNG or WebP, up to 5 MB. Replaces the current picture; the response is the item with its new `image_url`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /establishments/{establishment}/items/{item}/image","href":"/api/reference/items/upload-the-items-picture","autogeneratedByOpenApi":true},"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: [_jsx(_components.code, {\n children: \"multipart/form-data\"\n }), \" with one \", _jsx(_components.code, {\n children: \"image\"\n }), \" file: JPEG, PNG or WebP, up to 5 MB. Replaces the current picture; the response is the item with its new \", _jsx(_components.code, {\n children: \"image_url\"\n }), \".\"]\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":"Upload the item's picture","description":"`multipart/form-data` with one `image` file: JPEG, PNG or WebP, up to 5 MB. Replaces the current picture; the response is the item with its new `image_url`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /establishments/{establishment}/items/{item}/image","href":"/api/reference/items/upload-the-items-picture","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"v1.establishments.items.image.store","description":"`multipart/form-data` with one `image` file: JPEG, PNG or WebP, up to 5 MB. Replaces the current picture; the response is the item with its new `image_url`.","summary":"Upload the item's picture","tags":["Items"],"parameters":["c21fd293-fcae-42da-9772-90a9c5cdbf56","51fd2cc4-9f62-4810-bb2e-e96d0f2d39ba","347a1ed4-ad7c-4c5a-b1f7-3867022442de","93981f1c-45c5-486a-ba09-af294a427f02"],"requestBody":"8370f051-4e03-414c-9323-56153d8c7983","responses":{"200":"1d247d01-e15a-434a-8ca1-de5b8cb1bc65","401":"24f7fb9d-dfef-41a5-b283-ea78e47184d7","403":"f94aa96d-33fe-4f1a-a376-a6cb3c35ef1f","404":"dab27df4-cc6e-453e-b18c-5bec7ce0e533","413":"e32ed286-b1e4-4454-a02c-0952818a6997","422":"5f5f95f9-c74a-41e0-9f83-26e166eb401e","429":"ff5ac29b-3064-46b9-8d37-ff53a758488a"},"method":"post","type":"path","servers":["4881b565-21c9-481f-ab04-2e9faf758340"],"security":["bba8f998-d38f-418f-a418-f9c23b32760a"],"path":"/establishments/{establishment}/items/{item}/image","baseUrlOptions":["https://needalert.app/api/v1"],"title":"Upload the item's picture","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","php"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c21fd293-fcae-42da-9772-90a9c5cdbf56":{"name":"establishment","in":"path","required":true,"description":"The establishment ID","schema":{"type":"integer","isRequired":true,"description":"The establishment ID","uniqueKey":"","typeLabel":"integer"}},"51fd2cc4-9f62-4810-bb2e-e96d0f2d39ba":{"name":"item","in":"path","required":true,"description":"The item ID","schema":{"type":"integer","isRequired":true,"description":"The item ID","uniqueKey":"","typeLabel":"integer"}},"347a1ed4-ad7c-4c5a-b1f7-3867022442de":{"name":"Accept-Language","in":"header","description":"Language of `message` and of translated content such as item names (`pt-BR` or `en`). Without it, the chain's default language.","schema":{"type":"string","enum":["pt-BR","en"],"description":"Language of `message` and of translated content such as item names (`pt-BR` or `en`). Without it, the chain's default language.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"example":"pt-BR"},"93981f1c-45c5-486a-ba09-af294a427f02":{"name":"X-Request-Id","in":"header","description":"Your own correlation id (1–64 characters of `A-Za-z0-9._-`), echoed back; generated when absent. Quote it to support.","schema":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,64}$","minLength":1,"maxLength":64,"description":"Your own correlation id (1–64 characters of `A-Za-z0-9._-`), echoed back; generated when absent. Quote it to support.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"image":{"type":"string","format":"binary","contentMediaType":"application/octet-stream","description":"Maximum file size: 5120 kilobytes.","isRequired":true,"uniqueKey":"image","typeLabel":"file"}},"required":["image"],"title":"UploadImageRequest","uniqueKey":"","typeLabel":"UploadImageRequest · object"},"examples":{"Example":{"title":"Example","value":{"image":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1d247d01-e15a-434a-8ca1-de5b8cb1bc65":{"description":"`Item`","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"integer","isRequired":true,"uniqueKey":"data.id","typeLabel":"integer"},"establishment_id":{"type":"integer","isRequired":true,"uniqueKey":"data.establishment_id","typeLabel":"integer"},"product_catalog_id":{"oneOf":[{"type":"integer","description":"The chain-catalog product this item was created from, if any.","isRequired":true,"uniqueKey":"data.product_catalog_id.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The chain-catalog product this item was created from, if any.","isRequired":true,"uniqueKey":"data.product_catalog_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.product_catalog_id","typeLabel":"integer | null"},"public_code":{"type":"string","description":"Short, immutable code printed on the QR sticker.","isRequired":true,"uniqueKey":"data.public_code","typeLabel":"string"},"external_reference":{"oneOf":[{"type":"string","description":"Your own code for the item (SKU, procedure code). Unique per unit among non-archived items; matched exactly, case-sensitive.","isRequired":true,"uniqueKey":"data.external_reference.oneOf.0","typeLabel":"string"},{"type":"null","description":"Your own code for the item (SKU, procedure code). Unique per unit among non-archived items; matched exactly, case-sensitive.","isRequired":true,"uniqueKey":"data.external_reference.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.external_reference","typeLabel":"string | null"},"public_url":{"type":"string","description":"The public page people subscribe from.","isRequired":true,"uniqueKey":"data.public_url","typeLabel":"string"},"qr_code_url":{"type":"string","description":"The QR code image endpoint of this item.","isRequired":true,"uniqueKey":"data.qr_code_url","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"In `content_locale`: the requested language, or the fallback when it has no translation.","isRequired":true,"uniqueKey":"data.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"In `content_locale`: the requested language, or the fallback when it has no translation.","isRequired":true,"uniqueKey":"data.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.name","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"In `content_locale`, like `name`.","isRequired":true,"uniqueKey":"data.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"In `content_locale`, like `name`.","isRequired":true,"uniqueKey":"data.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.description","typeLabel":"string | null"},"content_locale":{"type":"string","enum":["pt_BR","en"],"title":"Locale","description":"The language `name` and `description` above were served in.","isRequired":true,"uniqueKey":"data.content_locale","typeLabel":"enum\u003cstring>"},"translations":{"type":"object","description":"Every translation, keyed by locale (`pt_BR`, `en`).","additionalProperties":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"data.translations.additionalProperties.name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.translations.additionalProperties.description.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.translations.additionalProperties.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.translations.additionalProperties.description","typeLabel":"string | null"}},"required":["name","description"],"uniqueKey":"data.translations.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.translations","typeLabel":"object"},"image_url":{"oneOf":[{"type":"string","description":"The item's picture, `null` when it has none.","isRequired":true,"uniqueKey":"data.image_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The item's picture, `null` when it has none.","isRequired":true,"uniqueKey":"data.image_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.image_url","typeLabel":"string | null"},"queue_type":{"type":"string","description":"How subscriptions behave after an alert: `single` ends them, `recurring` keeps them.\n| |\n|---|\n| `single` \u003cbr/> One-time alert: a subscription ends after its first alert. |\n| `recurring` \u003cbr/> Recurring alert: the subscription stays and is alerted every time. |","enum":["single","recurring"],"title":"QueueType","isRequired":true,"uniqueKey":"data.queue_type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"| |\n|---|\n| `active` \u003cbr/> Accepts subscriptions and alerts. |\n| `paused` \u003cbr/> Visible, but takes no new subscriptions or alerts until reactivated. |\n| `archived` \u003cbr/> Terminal: kept for history only. |","enum":["active","paused","archived"],"title":"ItemStatus","isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"attributes":{"type":"object","description":"Free-form key/value data of the item.","properties":{"id":{"type":"integer","uniqueKey":"data.attributes.id","typeLabel":"integer"},"establishment_id":{"type":"integer","uniqueKey":"data.attributes.establishment_id","typeLabel":"integer"},"product_catalog_id":{"oneOf":[{"type":"integer","uniqueKey":"data.attributes.product_catalog_id.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.attributes.product_catalog_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.product_catalog_id","typeLabel":"integer | null"},"public_code":{"type":"string","uniqueKey":"data.attributes.public_code","typeLabel":"string"},"external_reference":{"oneOf":[{"type":"string","uniqueKey":"data.attributes.external_reference.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.attributes.external_reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.external_reference","typeLabel":"string | null"},"image_path":{"oneOf":[{"type":"string","uniqueKey":"data.attributes.image_path.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.attributes.image_path.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.image_path","typeLabel":"string | null"},"queue_type":{"type":"string","uniqueKey":"data.attributes.queue_type","typeLabel":"string"},"status":{"type":"string","uniqueKey":"data.attributes.status","typeLabel":"string"},"attributes":{"oneOf":[{"type":"string","uniqueKey":"data.attributes.attributes.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.attributes.attributes.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.attributes","typeLabel":"string | null"},"subscribers_count":{"type":"integer","uniqueKey":"data.attributes.subscribers_count","typeLabel":"integer"},"requires_sensitive_consent":{"type":"string","uniqueKey":"data.attributes.requires_sensitive_consent","typeLabel":"string"},"created_by_user_id":{"oneOf":[{"type":"integer","uniqueKey":"data.attributes.created_by_user_id.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.attributes.created_by_user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.created_by_user_id","typeLabel":"integer | null"},"created_by_api_client_id":{"oneOf":[{"type":"integer","uniqueKey":"data.attributes.created_by_api_client_id.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.attributes.created_by_api_client_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.created_by_api_client_id","typeLabel":"integer | null"},"created_at":{"oneOf":[{"type":"string","uniqueKey":"data.attributes.created_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.attributes.created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.created_at","typeLabel":"string | null"},"updated_at":{"oneOf":[{"type":"string","uniqueKey":"data.attributes.updated_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.attributes.updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.updated_at","typeLabel":"string | null"},"deleted_at":{"oneOf":[{"type":"string","uniqueKey":"data.attributes.deleted_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.attributes.deleted_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.deleted_at","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data.attributes","typeLabel":"object"},"subscribers_count":{"type":"integer","description":"People currently subscribed and eligible for the next alert.","isRequired":true,"uniqueKey":"data.subscribers_count","typeLabel":"integer"},"requires_sensitive_consent":{"type":"boolean","description":"Whether subscribing asks for the sensitive-data consent (health items).","isRequired":true,"uniqueKey":"data.requires_sensitive_consent","typeLabel":"boolean"},"created_by":{"oneOf":[{"type":"object","description":"The person who created the item; `null` when an API key or the system did.","properties":{"id":{"type":"integer","isRequired":true,"uniqueKey":"data.created_by.oneOf.0.id","typeLabel":"integer"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.created_by.oneOf.0.name","typeLabel":"string"}},"required":["id","name"],"isRequired":true,"uniqueKey":"data.created_by.oneOf.0","typeLabel":"object"},{"type":"null","description":"The person who created the item; `null` when an API key or the system did.","properties":{"id":{"type":"integer"},"name":{"type":"string"}},"required":["id","name"],"isRequired":true,"uniqueKey":"data.created_by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.created_by","typeLabel":"object | null"},"created_by_api_client":{"oneOf":[{"type":"object","description":"The API key that created the item; `null` when a person did.","properties":{"id":{"type":"integer","isRequired":true,"uniqueKey":"data.created_by_api_client.oneOf.0.id","typeLabel":"integer"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.created_by_api_client.oneOf.0.name","typeLabel":"string"}},"required":["id","name"],"isRequired":true,"uniqueKey":"data.created_by_api_client.oneOf.0","typeLabel":"object"},{"type":"null","description":"The API key that created the item; `null` when a person did.","properties":{"id":{"type":"integer"},"name":{"type":"string"}},"required":["id","name"],"isRequired":true,"uniqueKey":"data.created_by_api_client.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.created_by_api_client","typeLabel":"object | null"},"created_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.created_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.created_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string | null"},"updated_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.updated_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.updated_at","typeLabel":"string | null"}},"required":["id","establishment_id","product_catalog_id","public_code","external_reference","public_url","qr_code_url","name","description","content_locale","translations","image_url","queue_type","status","attributes","subscribers_count","requires_sensitive_consent","created_by","created_by_api_client","created_at","updated_at"],"title":"Item","isRequired":true,"uniqueKey":"data","typeLabel":"Item · object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":123,"establishment_id":123,"product_catalog_id":123,"public_code":"\u003cstring>","external_reference":"\u003cstring>","public_url":"\u003cstring>","qr_code_url":"\u003cstring>","name":"\u003cstring>","description":"\u003cstring>","content_locale":"pt_BR","translations":{},"image_url":"\u003cstring>","queue_type":"single","status":"active","attributes":{"id":123,"establishment_id":123,"product_catalog_id":123,"public_code":"\u003cstring>","external_reference":"\u003cstring>","image_path":"\u003cstring>","queue_type":"\u003cstring>","status":"\u003cstring>","attributes":"\u003cstring>","subscribers_count":123,"requires_sensitive_consent":"\u003cstring>","created_by_user_id":123,"created_by_api_client_id":123,"created_at":"\u003cstring>","updated_at":"\u003cstring>","deleted_at":"\u003cstring>"},"subscribers_count":123,"requires_sensitive_consent":true,"created_by":{"id":123,"name":"\u003cstring>"},"created_by_api_client":{"id":123,"name":"\u003cstring>"},"created_at":"\u003cstring>","updated_at":"\u003cstring>"}}}},"exampleType":"generated"}},"headers":{"Content-Language":{"description":"The language of the body, BCP 47 (`pt-BR`, `en`).","schema":{"type":"string"}},"X-Request-Id":{"description":"The request id, yours or the one generated here.","schema":{"type":"string"}}},"exampleType":"generated"},"24f7fb9d-dfef-41a5-b283-ea78e47184d7":{"description":"- `unauthenticated`: Missing, malformed, expired or revoked API key.","content":{"application/json":{"schema":{"type":"object","title":"ErrorEnvelope","description":"The shape of every error response of the API.","required":["message","code"],"properties":{"message":{"type":"string","description":"Translated (see `Content-Language`), for display only. Never program against it.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable `snake_case` identifier of the error. Program against it.","enum":["unauthenticated"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"errors":{"type":"object","description":"Only on some errors: the invalid fields of a `validation_failed`, or extra data of a business-rule refusal.","uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"unauthenticated","errors":{}}}},"exampleType":"generated"}},"headers":{"Content-Language":{"description":"The language of the body, BCP 47 (`pt-BR`, `en`).","schema":{"type":"string"}},"X-Request-Id":{"description":"The request id, yours or the one generated here.","schema":{"type":"string"}}},"exampleType":"generated"},"f94aa96d-33fe-4f1a-a376-a6cb3c35ef1f":{"description":"- `establishment_unavailable`: The unit is inactive or suspended.\n- `forbidden`: The key lacks the permission this operation needs in this unit (`view`, `create_items`, `edit_items`, `dispatch_events` or `manage_billing`).\n- `tenant_suspended`: The chain that owns the key is suspended.","content":{"application/json":{"schema":{"type":"object","title":"ErrorEnvelope","description":"The shape of every error response of the API.","required":["message","code"],"properties":{"message":{"type":"string","description":"Translated (see `Content-Language`), for display only. Never program against it.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable `snake_case` identifier of the error. Program against it.","enum":["establishment_unavailable","forbidden","tenant_suspended"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"errors":{"type":"object","description":"Only on some errors: the invalid fields of a `validation_failed`, or extra data of a business-rule refusal.","uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"establishment_unavailable","errors":{}}}},"exampleType":"generated"}},"headers":{"Content-Language":{"description":"The language of the body, BCP 47 (`pt-BR`, `en`).","schema":{"type":"string"}},"X-Request-Id":{"description":"The request id, yours or the one generated here.","schema":{"type":"string"}}},"exampleType":"generated"},"dab27df4-cc6e-453e-b18c-5bec7ce0e533":{"description":"- `not_found`: No such resource, or it is outside the key's scope. The API never reveals whether a resource you cannot see exists.","content":{"application/json":{"schema":{"type":"object","title":"ErrorEnvelope","description":"The shape of every error response of the API.","required":["message","code"],"properties":{"message":{"type":"string","description":"Translated (see `Content-Language`), for display only. Never program against it.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable `snake_case` identifier of the error. Program against it.","enum":["not_found"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"errors":{"type":"object","description":"Only on some errors: the invalid fields of a `validation_failed`, or extra data of a business-rule refusal.","uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"not_found","errors":{}}}},"exampleType":"generated"}},"headers":{"Content-Language":{"description":"The language of the body, BCP 47 (`pt-BR`, `en`).","schema":{"type":"string"}},"X-Request-Id":{"description":"The request id, yours or the one generated here.","schema":{"type":"string"}}},"exampleType":"generated"},"e32ed286-b1e4-4454-a02c-0952818a6997":{"description":"- `payload_too_large`: The file is over the size limit.","content":{"application/json":{"schema":{"type":"object","title":"ErrorEnvelope","description":"The shape of every error response of the API.","required":["message","code"],"properties":{"message":{"type":"string","description":"Translated (see `Content-Language`), for display only. Never program against it.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable `snake_case` identifier of the error. Program against it.","enum":["payload_too_large"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"errors":{"type":"object","description":"Only on some errors: the invalid fields of a `validation_failed`, or extra data of a business-rule refusal.","uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"payload_too_large","errors":{}}}},"exampleType":"generated"}},"headers":{"Content-Language":{"description":"The language of the body, BCP 47 (`pt-BR`, `en`).","schema":{"type":"string"}},"X-Request-Id":{"description":"The request id, yours or the one generated here.","schema":{"type":"string"}}},"exampleType":"generated"},"5f5f95f9-c74a-41e0-9f83-26e166eb401e":{"description":"- `item_archived`: This item is archived and cannot be changed.\n- `validation_failed`: Invalid input. `errors`: each invalid field mapped to its messages.","content":{"application/json":{"schema":{"type":"object","title":"ErrorEnvelope","description":"The shape of every error response of the API.","required":["message","code"],"properties":{"message":{"type":"string","description":"Translated (see `Content-Language`), for display only. Never program against it.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable `snake_case` identifier of the error. Program against it.","enum":["item_archived","validation_failed"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"errors":{"type":"object","description":"Only on some errors: the invalid fields of a `validation_failed`, or extra data of a business-rule refusal.","uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"item_archived","errors":{}}}},"exampleType":"generated"}},"headers":{"Content-Language":{"description":"The language of the body, BCP 47 (`pt-BR`, `en`).","schema":{"type":"string"}},"X-Request-Id":{"description":"The request id, yours or the one generated here.","schema":{"type":"string"}}},"exampleType":"generated"},"ff5ac29b-3064-46b9-8d37-ff53a758488a":{"description":"- `too_many_requests`: Over the key's budget of 300 requests per minute. Wait the seconds in `Retry-After`.","content":{"application/json":{"schema":{"type":"object","title":"ErrorEnvelope","description":"The shape of every error response of the API.","required":["message","code"],"properties":{"message":{"type":"string","description":"Translated (see `Content-Language`), for display only. Never program against it.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable `snake_case` identifier of the error. Program against it.","enum":["too_many_requests"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"errors":{"type":"object","description":"Only on some errors: the invalid fields of a `validation_failed`, or extra data of a business-rule refusal.","uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"ErrorEnvelope · object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"too_many_requests","errors":{}}}},"exampleType":"generated"}},"headers":{"Retry-After":{"description":"Seconds to wait before the next request.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Requests allowed per minute.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer"}},"Content-Language":{"description":"The language of the body, BCP 47 (`pt-BR`, `en`).","schema":{"type":"string"}},"X-Request-Id":{"description":"The request id, yours or the one generated here.","schema":{"type":"string"}}},"exampleType":"generated"}},"security":{"bba8f998-d38f-418f-a418-f9c23b32760a":{"apiKey":{"type":"http","description":"An API key created by the chain owner in the panel (**Integrações** → **Nova chave**), sent as `Authorization: Bearer \u003ckey>`. The key (`\u003cid>|na_…`) is shown once, at creation; rotate or revoke it on the same screen. It is a server secret: never ship it in browser or mobile code.","scheme":"bearer","scopes":[],"schemeName":"apiKey"}}},"servers":{"4881b565-21c9-481f-ab04-2e9faf758340":{"url":"https://needalert.app/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"An API key created by the chain owner in the panel (**Integrações** → **Nova chave**), sent as `Authorization: Bearer \u003ckey>`. The key (`\u003cid>|na_…`) is shown once, at creation; rotate or revoke it on the same screen. It is a server secret: never ship it in browser or mobile code.","scheme":"bearer","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key created by the chain owner in the panel (**Integrações** → **Nova chave**), sent as `Authorization: Bearer \u003ckey>`. The key (`\u003cid>|na_…`) is shown once, at creation; rotate or revoke it on the same screen. It is a server secret: never ship it in browser or mobile code.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"need-alert","siteName":"Need Alert","title":"Upload the item's picture - Need Alert","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/api/reference/items/upload-the-items-picture","matchLevel":0},"en":{"href":"/en/api/reference/items/upload-the-items-picture","matchLevel":1}}},"lastModified":"2026-10-19T04:16:33.208Z","originalFileLocation":"api/reference/items/upload-the-items-picture.mdx","locale":"pt-BR"},"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=\"multipart/form-data with one image file: JPEG, PNG or WebP, up to 5 MB. Replaces the current picture; the response is the item with its new image_url.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Need Alert\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/need-alert/RuPQ-F31d7vVQjKt/_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/need-alert/RuPQ-F31d7vVQjKt/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/need-alert/RuPQ-F31d7vVQjKt/_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/need-alert/RuPQ-F31d7vVQjKt/_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/need-alert/RuPQ-F31d7vVQjKt/_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/need-alert/RuPQ-F31d7vVQjKt/_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/need-alert/RuPQ-F31d7vVQjKt/_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/need-alert/RuPQ-F31d7vVQjKt/_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/need-alert/RuPQ-F31d7vVQjKt/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Upload the item\u0026#x27;s picture - Need Alert\">\u003cmeta data-mint-head property=\"og:description\" content=\"multipart/form-data with one image file: JPEG, PNG or WebP, up to 5 MB. Replaces the current picture; the response is the item with its new image_url.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Need Alert\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.needalert.app/api/reference/items/upload-the-items-picture\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://need-alert.mintlify.site/_mintlify/api/og/v2?division=Items\u0026amp;title=Upload+the+item%27s+picture\u0026amp;description=%60multipart%2Fform-data%60+with+one+%60image%60+file%3A+JPEG%2C+PNG+or+WebP%2C+up+to+5+MB.+Replaces+the+current+picture%3B+the+response+is+the+item+with+its+new+%60image_url%60.\u0026amp;theme=bdfac1a245537d76f0edd834\u0026amp;signature=d6722e03b870d3e60d96df03ab99d9f7cabad695424715ba8cb29da6981755c7\">\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=\"Upload the item\u0026#x27;s picture - Need Alert\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"multipart/form-data with one image file: JPEG, PNG or WebP, up to 5 MB. Replaces the current picture; the response is the item with its new image_url.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://need-alert.mintlify.site/_mintlify/api/og/v2?division=Items\u0026amp;title=Upload+the+item%27s+picture\u0026amp;description=%60multipart%2Fform-data%60+with+one+%60image%60+file%3A+JPEG%2C+PNG+or+WebP%2C+up+to+5+MB.+Replaces+the+current+picture%3B+the+response+is+the+item+with+its+new+%60image_url%60.\u0026amp;theme=bdfac1a245537d76f0edd834\u0026amp;signature=d6722e03b870d3e60d96df03ab99d9f7cabad695424715ba8cb29da6981755c7\">\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/need-alert/RuPQ-F31d7vVQjKt/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Need Alert\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#465FFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.needalert.app/api/reference/items/upload-the-items-picture\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/reference/items/upload-the-items-picture.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.needalert.app/api/reference/items/upload-the-items-picture\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.needalert.app/en/api/reference/items/upload-the-items-picture\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.needalert.app/api/reference/items/upload-the-items-picture\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.needalert.app/#organization\",\"name\":\"Need Alert\",\"url\":\"https://docs.needalert.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/need-alert/9mmUrKHe_2MF526d/logo/light.svg?fit=max\u0026auto=format\u0026n=9mmUrKHe_2MF526d\u0026q=85\u0026s=373a6fb813b58847213edb4a69e07fc2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.needalert.app#website\",\"name\":\"Need Alert\",\"url\":\"https://docs.needalert.app\",\"publisher\":{\"@id\":\"https://docs.needalert.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.needalert.app/api/reference/items/upload-the-items-picture#webpage\",\"url\":\"https://docs.needalert.app/api/reference/items/upload-the-items-picture\",\"name\":\"Upload the item's picture\",\"description\":\"multipart/form-data with one image file: JPEG, PNG or WebP, up to 5 MB. Replaces the current picture; the response is the item with its new image_url.\",\"dateModified\":\"2026-10-19T04:16:33.208Z\",\"isPartOf\":{\"@id\":\"https://docs.needalert.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.needalert.app/api/reference/items/upload-the-items-picture#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.needalert.app/api/reference/items/upload-the-items-picture#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.needalert.app/api/reference/establishments/list-units\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Items\",\"item\":\"https://docs.needalert.app/api/reference/items/list-items\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Upload the item's picture\",\"item\":\"https://docs.needalert.app/api/reference/items/upload-the-items-picture\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.needalert.app/api/reference/items/upload-the-items-picture#apireference\",\"headline\":\"Upload the item's picture\",\"name\":\"Upload the item's picture\",\"description\":\"multipart/form-data with one image file: JPEG, PNG or WebP, up to 5 MB. Replaces the current picture; the response is the item with its new image_url.\",\"url\":\"https://docs.needalert.app/api/reference/items/upload-the-items-picture\",\"mainEntityOfPage\":{\"@id\":\"https://docs.needalert.app/api/reference/items/upload-the-items-picture#webpage\"},\"dateModified\":\"2026-10-19T04:16:33.208Z\",\"publisher\":{\"@id\":\"https://docs.needalert.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.needalert.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Need Alert\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Need Alert\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/reference/items/upload-the-items-picture.md","siteName":"Need Alert","nav":{"global":null,"languages":[{"language":"pt-BR","default":true,"tabs":[{"tab":"Guias","pages":[{"title":"Guias","href":""}]},{"tab":"API","groups":[{"group":"Introdução","pages":[{"title":"Visão geral da API","icon":"code","href":"/api/overview"},{"title":"Autenticação","icon":"key","href":"/api/authentication"},{"title":"Primeira requisição","icon":"rocket","href":"/api/first-request"}]},{"group":"Guias","pages":[{"title":"Idempotência","icon":"rotate","href":"/api/idempotency"},{"title":"Referência externa","icon":"barcode","href":"/api/external-reference"},{"title":"Casos de uso","icon":"diagram-project","href":"/api/use-cases"}]},{"group":"Convenções","pages":[{"title":"Convenções","icon":"book","href":"/api/conventions"},{"title":"Changelog","icon":"clock-rotate-left","href":"/api/changelog"}]},{"group":"Endpoints","pages":[{"group":"Establishments","pages":[{"title":"List units","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /establishments","href":"/api/reference/establishments/list-units"},{"title":"Get a unit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /establishments/{establishment}","href":"/api/reference/establishments/get-a-unit"}]},{"group":"Items","pages":[{"title":"List items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /establishments/{establishment}/items","href":"/api/reference/items/list-items"},{"title":"Create an item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /establishments/{establishment}/items","href":"/api/reference/items/create-an-item"},{"title":"Get an item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /establishments/{establishment}/items/{item}","href":"/api/reference/items/get-an-item"},{"title":"Archive an item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /establishments/{establishment}/items/{item}","href":"/api/reference/items/archive-an-item"},{"title":"Update an item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /establishments/{establishment}/items/{item}","href":"/api/reference/items/update-an-item"},{"title":"Get the item's QR code","description":"The image of the QR code that opens the item's public page (`public_url`). `format` is `svg` (default) or `png`; `size`, in pixels, applies to PNG only; `download=1` makes the browser save the file.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /establishments/{establishment}/items/{item}/qr-code","href":"/api/reference/items/get-the-items-qr-code"},{"title":"Upload the item's picture","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /establishments/{establishment}/items/{item}/image","href":"/api/reference/items/upload-the-items-picture"},{"title":"Remove the item's picture","description":"The response is the item with `image_url: null`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /establishments/{establishment}/items/{item}/image","href":"/api/reference/items/remove-the-items-picture"}]},{"group":"Dispatches","pages":[{"title":"Preview an alert","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /establishments/{establishment}/items/{item}/dispatch-preview","href":"/api/reference/dispatches/preview-an-alert"},{"title":"Send or schedule an alert","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /establishments/{establishment}/items/{item}/events","href":"/api/reference/dispatches/send-or-schedule-an-alert"},{"title":"List dispatches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /establishments/{establishment}/events","href":"/api/reference/dispatches/list-dispatches"},{"title":"Get a dispatch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /establishments/{establishment}/events/{event}","href":"/api/reference/dispatches/get-a-dispatch"},{"title":"Cancel a scheduled dispatch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /establishments/{establishment}/events/{event}","href":"/api/reference/dispatches/cancel-a-scheduled-dispatch"},{"title":"Reschedule a dispatch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /establishments/{establishment}/events/{event}","href":"/api/reference/dispatches/reschedule-a-dispatch"}]},{"group":"Credits","pages":[{"title":"Get the credit balance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /tenants/{tenant}/credit-balance","href":"/api/reference/credits/get-the-credit-balance"},{"title":"List credit transactions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /tenants/{tenant}/credit-transactions","href":"/api/reference/credits/list-credit-transactions"}]}]}]}]},{"language":"en","pages":[{"title":"en","href":"/en/api/reference/items/upload-the-items-picture"}]}]},"basePath":"","title":"Upload the item's picture - Need Alert","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}