Updates the fields sent and leaves the others unchanged. Use notifications_muted to mute or unmute the inbox. Sending sources replaces the whole list. For a teammate’s inbox, send user_id in the body. Size limits (name over 80 characters, emoji over 16, more than 100 sources or 10 conditions per source) return 400INVALID_REQUEST_BODY with field_errors. A menu path not listed by the line’s menu_options, or a null source, condition or digit, returns 400INVALID_INBOX_SOURCE. Menu conditions are only accepted on a line whose menu_options list is not empty, with paths from that list; on other lines use a whole-line source (empty conditions). With user_id, an inbox with no source in a workspace the caller manages returns 404, and sources replaces only the lines in the caller’s workspaces: the teammate’s other-workspace lines are kept.
Updates only the fields you send and returns the inbox. Sending sources replaces the whole list. Sending filters replaces the saved filters, and "filters": null clears them. The app’s Needs action and Mine settings on the inbox are kept either way. Sending "emoji": "" clears the emoji. An absent or null emoji keeps it.To mute an inbox, send {"notifications_muted": true}. To unmute it, send false.Send user_id in the JSON body to update a teammate’s inbox. Only admins and managers of the teammate’s workspace can do that. An inbox with no source in a workspace the caller manages returns 404. Sending sources replaces only the lines in the caller’s workspaces: the teammate’s lines from other workspaces are kept.
A source, condition or digit is null or invalid, a menu path is not in that line’s menu options, two sources share an allo_number, or a teammate inbox would have no line in the caller’s workspace
400
INVALID_REQUEST_BODY
name over 80 characters, emoji over 16, more than 100 sources, or more than 10 conditions in a source. field_errors names each field
400
INVALID_INBOX_FILTERS
filters has an unknown key or an invalid value
403
FORBIDDEN
user_id is set and the caller is not an admin or manager of that teammate’s workspace
403
ALLO_NUMBER_FORBIDDEN
A source line is not accessible to the inbox owner, or, with user_id, is not in a workspace the caller manages
404
INBOX_NOT_FOUND
No inbox with this ID belongs to the inbox owner, or, with user_id, it has no source in a workspace the caller manages
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Allo — Help Center","description":"Documentation and support for Allo, the business phone system that does the work your calls create","colors":{"primary":"#002C2A","light":"#F7F5F0","dark":"#005C48"},"logo":{"light":"https://mintcdn.com/themobilefirstcompany/lUQseAX2HkM5_D4I/Allo-logo-dark.svg?fit=max\u0026auto=format\u0026n=lUQseAX2HkM5_D4I\u0026q=85\u0026s=fc710c4b2d7fad80babb5aff40fd445f","dark":"https://mintcdn.com/themobilefirstcompany/lUQseAX2HkM5_D4I/Allo-logo-white.svg?fit=max\u0026auto=format\u0026n=lUQseAX2HkM5_D4I\u0026q=85\u0026s=6aafc66adc4822b700749ea65edfd057","href":"https://help.withallo.com"},"favicon":"https://mintcdn.com/themobilefirstcompany/rQqa1VZUBtU6450W/icon.ico?fit=max\u0026auto=format\u0026n=rQqa1VZUBtU6450W\u0026q=85\u0026s=93c598907844385de27769ff740b1660","appearance":{"default":"light","strict":true},"background":{"color":{"dark":"#002C2A"}},"navbar":{"links":[{"href":"https://withallo.com/changelog","label":"Changelog"},{"href":"https://withallo.com/download","label":"Download"}],"primary":{"type":"button","label":"Get Started","href":"https://start.withallo.com"}},"footer":{"socials":{"x":"https://x.com/mobilefirstco","linkedin":"https://www.linkedin.com/company/the-mobile-first-company","website":"https://withallo.com"},"links":[{"header":"Product","items":[{"label":"Pricing","href":"https://withallo.com/pricing"},{"label":"Download","href":"https://withallo.com/download"},{"label":"Features","href":"https://withallo.com/features"}]},{"header":"Resources","items":[{"label":"Help Center","href":"https://help.withallo.com"},{"label":"Contact Support","href":"https://help.withallo.com/en/support/contact"},{"label":"System status","href":"https://status.withallo.com"},{"label":"Trust center","href":"https://trust.themobilefirstcompany.com/"}]},{"header":"Company","items":[{"label":"About","href":"https://withallo.com/about"},{"label":"Blog","href":"https://withallo.com/blog"}]},{"header":"Legal","items":[{"label":"Privacy Policy","href":"https://withallo.com/privacy-policy"},{"label":"Terms of Service","href":"https://withallo.com/terms-conditions"},{"label":"Trust Center","href":"https://trust.themobilefirstcompany.com"}]}]},"search":{"prompt":"Search documentation..."},"seo":{"metatags":{"canonical":"https://help.withallo.com","og:locale":"en_US","twitter:site":"@mobilefirstco"}},"icons":{"library":"lucide"},"integrations":{"ga4":{"measurementId":"G-BJ9CLYY37R"},"intercom":{"appId":"q4vb84fg"},"telemetry":{"enabled":true}},"contextual":{"options":["copy","view","chatgpt","claude","cursor"],"display":"header"},"thumbnails":{"fonts":{"family":"Inter"}},"interaction":{"drilldown":false},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":"en/get-started"},{"language":"fr","href":"fr/get-started"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"themobilefirstcompany","hasAudioNarration":false,"actualSubdomain":"themobilefirstcompany","customDomains":["help.withallo.com"],"gitSource":{"type":"github","owner":"themobilefirstco","repo":"doc-allo","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae21016f9cefd8f8d7a859a","collectionId":"fa5c0977-8f46-4274-b866-90fee48cbaab","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae21016f9cefd8f8d7a859a"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae21f6b5236addf7a639600","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"en","tag":"API Reference","count":146},{"language":"fr","tag":"Référence API","count":146},{"language":"en","tag":"Help","count":103},{"language":"fr","tag":"Aide","count":103},{"language":"en","tag":"Integrations","count":39},{"language":"fr","tag":"Intégrations","count":39},{"language":"en","tag":"CRM","count":21},{"language":"fr","tag":"CRM","count":21},{"language":"fr","tag":"Numéros de téléphone","count":15},{"language":"en","tag":"Partner","count":14},{"language":"fr","tag":"Partner","count":14},{"language":"en","tag":"Webhooks","count":13},{"language":"fr","tag":"Webhooks","count":13},{"language":"en","tag":"AI Receptionist","count":12},{"language":"fr","tag":"Réceptionniste IA","count":12},{"language":"en","tag":"Incoming calls","count":11},{"language":"fr","tag":"Appels entrants","count":11},{"language":"en","tag":"SMS","count":10},{"language":"en","tag":"Conversations","count":10},{"language":"fr","tag":"SMS","count":10}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/v2/api-reference/inboxes/update-inbox","slug":"/en/v2/api-reference/inboxes/update-inbox","pageMetadata":{"title":"Update inbox","openapi":"PATCH /v2/api/inboxes/{inbox_id}","description":"Updates the fields sent and leaves the others unchanged. Use `notifications_muted` to mute or unmute the inbox. Sending `sources` replaces the whole list. For a teammate's inbox, send `user_id` in the body. Size limits (`name` over 80 characters, `emoji` over 16, more than 100 sources or 10 conditions per source) return `400` `INVALID_REQUEST_BODY` with `field_errors`. A menu path not listed by the line's `menu_options`, or a null source, condition or digit, returns `400` `INVALID_INBOX_SOURCE`. Menu conditions are only accepted on a line whose `menu_options` list is not empty, with paths from that list; on other lines use a whole-line source (empty `conditions`). With `user_id`, an inbox with no source in a workspace the caller manages returns `404`, and `sources` replaces only the lines in the caller's workspaces: the teammate's other-workspace lines are kept.","href":"/en/v2/api-reference/inboxes/update-inbox"},"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: [\"Updates the fields sent and leaves the others unchanged. Use \", _jsx(_components.code, {\n children: \"notifications_muted\"\n }), \" to mute or unmute the inbox. Sending \", _jsx(_components.code, {\n children: \"sources\"\n }), \" replaces the whole list. For a teammate’s inbox, send \", _jsx(_components.code, {\n children: \"user_id\"\n }), \" in the body. Size limits (\", _jsx(_components.code, {\n children: \"name\"\n }), \" over 80 characters, \", _jsx(_components.code, {\n children: \"emoji\"\n }), \" over 16, more than 100 sources or 10 conditions per source) return \", _jsx(_components.code, {\n children: \"400\"\n }), \" \", _jsx(_components.code, {\n children: \"INVALID_REQUEST_BODY\"\n }), \" with \", _jsx(_components.code, {\n children: \"field_errors\"\n }), \". A menu path not listed by the line’s \", _jsx(_components.code, {\n children: \"menu_options\"\n }), \", or a null source, condition or digit, returns \", _jsx(_components.code, {\n children: \"400\"\n }), \" \", _jsx(_components.code, {\n children: \"INVALID_INBOX_SOURCE\"\n }), \". Menu conditions are only accepted on a line whose \", _jsx(_components.code, {\n children: \"menu_options\"\n }), \" list is not empty, with paths from that list; on other lines use a whole-line source (empty \", _jsx(_components.code, {\n children: \"conditions\"\n }), \"). With \", _jsx(_components.code, {\n children: \"user_id\"\n }), \", an inbox with no source in a workspace the caller manages returns \", _jsx(_components.code, {\n children: \"404\"\n }), \", and \", _jsx(_components.code, {\n children: \"sources\"\n }), \" replaces only the lines in the caller’s workspaces: the teammate’s other-workspace lines are kept.\"]\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Note,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Required scope:`}),` `,_jsx(_components.code,{children:`INBOXES_WRITE`})]})}),`\n`,_jsx(Heading,{level:`2`,id:`behavior`,children:`Behavior`}),`\n`,_jsxs(_components.p,{children:[`Updates only the fields you send and returns the inbox. Sending `,_jsx(_components.code,{children:`sources`}),` replaces the whole list. Sending `,_jsx(_components.code,{children:`filters`}),` replaces the saved filters, and `,_jsx(_components.code,{children:`\"filters\": null`}),` clears them. The app’s Needs action and Mine settings on the inbox are kept either way. Sending `,_jsx(_components.code,{children:`\"emoji\": \"\"`}),` clears the emoji. An absent or `,_jsx(_components.code,{children:`null`}),` emoji keeps it.`]}),`\n`,_jsxs(_components.p,{children:[`To mute an inbox, send `,_jsx(_components.code,{children:`{\"notifications_muted\": true}`}),`. To unmute it, send `,_jsx(_components.code,{children:`false`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Send `,_jsx(_components.code,{children:`user_id`}),` in the JSON body to update a teammate’s inbox. Only admins and managers of the teammate’s workspace can do that. An inbox with no source in a workspace the caller manages returns `,_jsx(_components.code,{children:`404`}),`. Sending `,_jsx(_components.code,{children:`sources`}),` replaces only the lines in the caller’s workspaces: the teammate’s lines from other workspaces are kept.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INBOX_NAME_REQUIRED`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`name`}),` is sent blank`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_INBOX_SOURCE`})}),_jsxs(_components.td,{children:[`A source, condition or digit is null or invalid, a menu path is not in that line’s `,_jsx(_components.a,{href:`/en/v2/api-reference/inboxes/list-menu-options`,children:`menu options`}),`, two sources share an `,_jsx(_components.code,{children:`allo_number`}),`, or a teammate inbox would have no line in the caller’s workspace`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_REQUEST_BODY`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`name`}),` over 80 characters, `,_jsx(_components.code,{children:`emoji`}),` over 16, more than 100 sources, or more than 10 conditions in a source. `,_jsx(_components.code,{children:`field_errors`}),` names each field`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_INBOX_FILTERS`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`filters`}),` has an unknown key or an invalid value`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`FORBIDDEN`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`user_id`}),` is set and the caller is not an admin or manager of that teammate’s workspace`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ALLO_NUMBER_FORBIDDEN`})}),_jsxs(_components.td,{children:[`A source line is not accessible to the inbox owner, or, with `,_jsx(_components.code,{children:`user_id`}),`, is not in a workspace the caller manages`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INBOX_NOT_FOUND`})}),_jsxs(_components.td,{children:[`No inbox with this ID belongs to the inbox owner, or, with `,_jsx(_components.code,{children:`user_id`}),`, it has no source in a workspace the caller manages`]})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update inbox","openapi":"PATCH /v2/api/inboxes/{inbox_id}","description":"Updates the fields sent and leaves the others unchanged. Use `notifications_muted` to mute or unmute the inbox. Sending `sources` replaces the whole list. For a teammate's inbox, send `user_id` in the body. Size limits (`name` over 80 characters, `emoji` over 16, more than 100 sources or 10 conditions per source) return `400` `INVALID_REQUEST_BODY` with `field_errors`. A menu path not listed by the line's `menu_options`, or a null source, condition or digit, returns `400` `INVALID_INBOX_SOURCE`. Menu conditions are only accepted on a line whose `menu_options` list is not empty, with paths from that list; on other lines use a whole-line source (empty `conditions`). With `user_id`, an inbox with no source in a workspace the caller manages returns `404`, and `sources` replaces only the lines in the caller's workspaces: the teammate's other-workspace lines are kept.","href":"/en/v2/api-reference/inboxes/update-inbox"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Behavior","slug":"behavior","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/themobilefirstcompany/8a9814acae5adfe6/webmcp.js"],"openApiReferenceData":{"operation":{"summary":"Update inbox","description":"Updates the fields sent and leaves the others unchanged. Use `notifications_muted` to mute or unmute the inbox. Sending `sources` replaces the whole list. For a teammate's inbox, send `user_id` in the body. Size limits (`name` over 80 characters, `emoji` over 16, more than 100 sources or 10 conditions per source) return `400` `INVALID_REQUEST_BODY` with `field_errors`. A menu path not listed by the line's `menu_options`, or a null source, condition or digit, returns `400` `INVALID_INBOX_SOURCE`. Menu conditions are only accepted on a line whose `menu_options` list is not empty, with paths from that list; on other lines use a whole-line source (empty `conditions`). With `user_id`, an inbox with no source in a workspace the caller manages returns `404`, and `sources` replaces only the lines in the caller's workspaces: the teammate's other-workspace lines are kept.","operationId":"updateInbox","tags":["Inboxes"],"security":["9afa397c-f666-456b-be74-108601c6e606"],"parameters":["424452d4-8ae7-4981-9ac0-8b1feb3df4fd"],"requestBody":"4b9010bf-42be-4ca7-b62c-2fc303e26b6b","responses":{"200":"ca1a2ada-8d73-47a8-a9c7-1effcefd6b26","400":"9bb7453a-4d4b-418a-b3ea-987123a0b101","401":"1c1cf808-9221-4a48-b02f-e6aee6d51576","403":"523e5c32-4cf6-4c2c-b044-5db9f46216a3","404":"a4fcc0f2-9ae1-4c60-a7f1-e3c8b37226a3","429":"18eed379-d04d-4a9a-b16c-4b831ca5a3c4"},"method":"patch","type":"path","servers":["e3b1cf1e-d252-4a41-aa6a-ab3f67fe655f"],"path":"/v2/api/inboxes/{inbox_id}","baseUrlOptions":["https://api.withallo.com"],"title":"Update inbox","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"424452d4-8ae7-4981-9ac0-8b1feb3df4fd":{"name":"inbox_id","in":"path","required":true,"description":"Inbox ID (`inb-*`).","schema":{"type":"string","example":"inb-abc123","isRequired":true,"description":"Inbox ID (`inb-*`).","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":80,"example":"Sales","description":"Cannot be blank.","uniqueKey":"name","typeLabel":"string"},"emoji":{"oneOf":[{"type":"string","maxLength":16,"description":"`\"\"` clears the emoji. Absent or `null` keeps it.","example":"💼","uniqueKey":"emoji.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":16,"description":"`\"\"` clears the emoji. Absent or `null` keeps it.","example":"💼","uniqueKey":"emoji.oneOf.1","typeLabel":"null"}],"uniqueKey":"emoji","typeLabel":"string | null"},"sources":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"allo_number":{"type":"string","description":"Allo line (E.164). Each line appears once in `sources`.","example":"+33612345678","isRequired":true,"uniqueKey":"sources.items.[INDEX].allo_number","typeLabel":"string"},"conditions":{"type":"array","maxItems":10,"items":{"oneOf":[{"type":"object","description":"Narrows a source to calls that went through part of the line's phone menu. A source holds at most 10 conditions, and an inbox at most 60 menu steps in all.","required":["type","node_id","digits","include_no_choice"],"properties":{"type":{"type":"string","enum":["MENU_OPTION"],"isRequired":true,"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"node_id":{"type":"string","description":"The menu node.","example":"node-3","isRequired":true,"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.0.node_id","typeLabel":"string"},"digits":{"type":"array","items":{"type":"string","pattern":"^[0-9]$","uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.0.digits.items.[INDEX]","typeLabel":"string"},"description":"Keys that match, distinct. May be `[]` only when `include_no_choice` is `true`, to match calls that reached the menu without pressing a key.","example":["1"],"isRequired":true,"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.0.digits","typeLabel":"string[]"},"include_no_choice":{"type":"boolean","description":"Also match calls that reached the menu without pressing a key.","example":false,"isRequired":true,"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.0.include_no_choice","typeLabel":"boolean"}},"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Narrows a source to calls that went through part of the line's phone menu. A source holds at most 10 conditions, and an inbox at most 60 menu steps in all.","required":["type","branches","include_no_choice"],"properties":{"type":{"type":"string","enum":["MENU_BRANCH"],"isRequired":true,"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"branches":{"type":"array","minItems":1,"maxItems":20,"description":"Each branch lists the menu choices from the first menu down to the option picked.","items":{"type":"array","minItems":1,"maxItems":6,"items":{"type":"object","properties":{"node_id":{"type":"string","description":"ID of the phone-menu node in the line's published call flow.","example":"node-3","isRequired":true,"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.branches.items.[INDEX].items.[INDEX].node_id","typeLabel":"string"},"digit":{"type":"string","pattern":"^[0-9*#]$","description":"Key pressed at that menu.","example":"2","isRequired":true,"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.branches.items.[INDEX].items.[INDEX].digit","typeLabel":"string"}},"required":["node_id","digit"],"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.branches.items.[INDEX].items.[INDEX]","typeLabel":"object"},"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.branches.items.[INDEX]","typeLabel":"object[]"},"isRequired":true,"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.branches","typeLabel":"object[][]"},"include_no_choice":{"type":"boolean","description":"Also match calls that reached the menu without pressing a key.","example":false,"isRequired":true,"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.include_no_choice","typeLabel":"boolean"}},"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"sources.items.[INDEX].conditions.items.[INDEX]","typeLabel":"object"},"description":"Empty or absent means every conversation on the line.","uniqueKey":"sources.items.[INDEX].conditions","typeLabel":"object[]"}},"required":["allo_number"],"uniqueKey":"sources.items.[INDEX]","typeLabel":"object"},"description":"Replaces the whole list. With `user_id`, only the lines in the caller's workspaces are replaced.","uniqueKey":"sources","typeLabel":"object[]"},"filters":{"oneOf":[{"type":"object","description":"Replaces the saved filters. `null` clears them, absent keeps them. The app's Needs action and Mine settings are kept either way.","properties":{"types":{"type":"array","items":{"type":"string","enum":["INBOUND_CALL","OUTBOUND_CALL","TRANSFERRED","INBOUND_TEXT_MESSAGE","OUTBOUND_TEXT_MESSAGE","VOICEMAIL","AI_ASSISTANT"],"uniqueKey":"filters.oneOf.0.types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"example":["INBOUND_CALL"],"uniqueKey":"filters.oneOf.0.types","typeLabel":"enum\u003cstring>[]"},"user_ids":{"type":"array","items":{"type":"string","uniqueKey":"filters.oneOf.0.user_ids.items.[INDEX]","typeLabel":"string"},"description":"Teammates (`usr-*`), up to 50.","example":[],"maxItems":50,"uniqueKey":"filters.oneOf.0.user_ids","typeLabel":"string[]"},"contact_ids":{"type":"array","items":{"type":"string","uniqueKey":"filters.oneOf.0.contact_ids.items.[INDEX]","typeLabel":"string"},"example":[],"maxItems":50,"description":"Contacts, up to 50.","uniqueKey":"filters.oneOf.0.contact_ids","typeLabel":"string[]"},"contact_list_ids":{"type":"array","items":{"type":"string","uniqueKey":"filters.oneOf.0.contact_list_ids.items.[INDEX]","typeLabel":"string"},"example":[],"maxItems":10,"description":"Contact lists, up to 10.","uniqueKey":"filters.oneOf.0.contact_list_ids","typeLabel":"string[]"}},"uniqueKey":"filters.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"filters.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters","typeLabel":"object | null"},"notifications_muted":{"type":"boolean","example":false,"uniqueKey":"notifications_muted","typeLabel":"boolean"},"user_id":{"type":"string","description":"Update this teammate's inbox (`usr-*`). The caller must be an admin or manager of that teammate's workspace.","example":"usr-abc123","uniqueKey":"user_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"notifications_muted":true},"examples":{"Example":{"title":"Example","value":{"notifications_muted":true}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"ca1a2ada-8d73-47a8-a9c7-1effcefd6b26":{"description":"Inbox updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","example":"inb-abc123","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"name":{"type":"string","example":"Sales","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"emoji":{"oneOf":[{"type":"string","example":"💼","isRequired":true,"uniqueKey":"data.emoji.oneOf.0","typeLabel":"string"},{"type":"null","example":"💼","isRequired":true,"uniqueKey":"data.emoji.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.emoji","typeLabel":"string | null"},"sources":{"type":"array","items":{"type":"object","properties":{"allo_number":{"type":"string","description":"Allo line (E.164).","example":"+33612345678","isRequired":true,"uniqueKey":"data.sources.items.[INDEX].allo_number","typeLabel":"string"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","description":"Narrows a source to calls that went through part of the line's phone menu. A source holds at most 10 conditions, and an inbox at most 60 menu steps in all.","required":["type","node_id","digits","include_no_choice"],"properties":{"type":{"type":"string","enum":["MENU_OPTION"],"isRequired":true,"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"node_id":{"type":"string","description":"The menu node.","example":"node-3","isRequired":true,"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.0.node_id","typeLabel":"string"},"digits":{"type":"array","items":{"type":"string","pattern":"^[0-9]$","uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.0.digits.items.[INDEX]","typeLabel":"string"},"description":"Keys that match, distinct. May be `[]` only when `include_no_choice` is `true`, to match calls that reached the menu without pressing a key.","example":["1"],"isRequired":true,"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.0.digits","typeLabel":"string[]"},"include_no_choice":{"type":"boolean","description":"Also match calls that reached the menu without pressing a key.","example":false,"isRequired":true,"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.0.include_no_choice","typeLabel":"boolean"}},"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Narrows a source to calls that went through part of the line's phone menu. A source holds at most 10 conditions, and an inbox at most 60 menu steps in all.","required":["type","branches","include_no_choice"],"properties":{"type":{"type":"string","enum":["MENU_BRANCH"],"isRequired":true,"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"branches":{"type":"array","minItems":1,"maxItems":20,"description":"Each branch lists the menu choices from the first menu down to the option picked.","items":{"type":"array","minItems":1,"maxItems":6,"items":{"type":"object","properties":{"node_id":{"type":"string","description":"ID of the phone-menu node in the line's published call flow.","example":"node-3","isRequired":true,"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.branches.items.[INDEX].items.[INDEX].node_id","typeLabel":"string"},"digit":{"type":"string","pattern":"^[0-9*#]$","description":"Key pressed at that menu.","example":"2","isRequired":true,"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.branches.items.[INDEX].items.[INDEX].digit","typeLabel":"string"}},"required":["node_id","digit"],"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.branches.items.[INDEX].items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.branches.items.[INDEX]","typeLabel":"object[]"},"isRequired":true,"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.branches","typeLabel":"object[][]"},"include_no_choice":{"type":"boolean","description":"Also match calls that reached the menu without pressing a key.","example":false,"isRequired":true,"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.1.include_no_choice","typeLabel":"boolean"}},"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"data.sources.items.[INDEX].conditions.items.[INDEX]","typeLabel":"object"},"description":"Empty means every conversation on the line.","maxItems":10,"isRequired":true,"uniqueKey":"data.sources.items.[INDEX].conditions","typeLabel":"object[]"}},"required":["allo_number","conditions"],"uniqueKey":"data.sources.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.sources","typeLabel":"object[]"},"filters":{"type":"object","description":"The saved filters, always returned with every key.","required":["types","user_ids","contact_ids","contact_list_ids"],"properties":{"types":{"type":"array","items":{"type":"string","enum":["INBOUND_CALL","OUTBOUND_CALL","TRANSFERRED","INBOUND_TEXT_MESSAGE","OUTBOUND_TEXT_MESSAGE","VOICEMAIL","AI_ASSISTANT"],"uniqueKey":"data.filters.types.items.[INDEX]","typeLabel":"enum\u003cstring>"},"example":["INBOUND_CALL"],"isRequired":true,"uniqueKey":"data.filters.types","typeLabel":"enum\u003cstring>[]"},"user_ids":{"type":"array","items":{"type":"string","uniqueKey":"data.filters.user_ids.items.[INDEX]","typeLabel":"string"},"description":"Teammates (`usr-*`), up to 50.","example":[],"maxItems":50,"isRequired":true,"uniqueKey":"data.filters.user_ids","typeLabel":"string[]"},"contact_ids":{"type":"array","items":{"type":"string","uniqueKey":"data.filters.contact_ids.items.[INDEX]","typeLabel":"string"},"example":[],"maxItems":50,"description":"Contacts, up to 50.","isRequired":true,"uniqueKey":"data.filters.contact_ids","typeLabel":"string[]"},"contact_list_ids":{"type":"array","items":{"type":"string","uniqueKey":"data.filters.contact_list_ids.items.[INDEX]","typeLabel":"string"},"example":[],"maxItems":10,"description":"Contact lists, up to 10.","isRequired":true,"uniqueKey":"data.filters.contact_list_ids","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"data.filters","typeLabel":"object"},"notifications_muted":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"data.notifications_muted","typeLabel":"boolean"}},"required":["id","name","emoji","sources","filters","notifications_muted"],"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"id":"inb-abc123","name":"Sales","emoji":"💼","sources":[{"allo_number":"+33612345678","conditions":[{"type":"MENU_BRANCH","branches":[[{"node_id":"node-1","digit":"1"},{"node_id":"node-3","digit":"2"}]],"include_no_choice":false}]}],"filters":{"types":["INBOUND_CALL"],"user_ids":[],"contact_ids":[],"contact_list_ids":[]},"notifications_muted":true}},"examples":{"Example":{"title":"Example","value":{"data":{"id":"inb-abc123","name":"Sales","emoji":"💼","sources":[{"allo_number":"+33612345678","conditions":[{"type":"MENU_BRANCH","branches":[[{"node_id":"node-1","digit":"1"},{"node_id":"node-3","digit":"2"}]],"include_no_choice":false}]}],"filters":{"types":["INBOUND_CALL"],"user_ids":[],"contact_ids":[],"contact_list_ids":[]},"notifications_muted":true}}}},"exampleType":"examples"}},"exampleType":"examples"},"9bb7453a-4d4b-418a-b3ea-987123a0b101":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","uniqueKey":"error.retryable","typeLabel":"boolean"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"},"retry_after_seconds":{"oneOf":[{"type":"integer","uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.retry_after_seconds","typeLabel":"integer | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","retryable":true,"request_id":"\u003cstring>","retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"1c1cf808-9221-4a48-b02f-e6aee6d51576":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","uniqueKey":"error.retryable","typeLabel":"boolean"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"},"retry_after_seconds":{"oneOf":[{"type":"integer","uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.retry_after_seconds","typeLabel":"integer | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","retryable":true,"request_id":"\u003cstring>","retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"523e5c32-4cf6-4c2c-b044-5db9f46216a3":{"description":"API key lacks the required scope or access to the resource","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","uniqueKey":"error.retryable","typeLabel":"boolean"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"},"retry_after_seconds":{"oneOf":[{"type":"integer","uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.retry_after_seconds","typeLabel":"integer | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","retryable":true,"request_id":"\u003cstring>","retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"a4fcc0f2-9ae1-4c60-a7f1-e3c8b37226a3":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","uniqueKey":"error.retryable","typeLabel":"boolean"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"},"retry_after_seconds":{"oneOf":[{"type":"integer","uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.retry_after_seconds","typeLabel":"integer | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","retryable":true,"request_id":"\u003cstring>","retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"18eed379-d04d-4a9a-b16c-4b831ca5a3c4":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","uniqueKey":"error.retryable","typeLabel":"boolean"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"},"retry_after_seconds":{"oneOf":[{"type":"integer","uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.retry_after_seconds","typeLabel":"integer | null"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>","retryable":true,"request_id":"\u003cstring>","retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"9afa397c-f666-456b-be74-108601c6e606":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"e3b1cf1e-d252-4a41-aa6a-ab3f67fe655f":{"url":"https://api.withallo.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Authorization","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"themobilefirstcompany","siteName":"Allo — Help Center","title":"Update inbox - Allo — Help Center","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/v2/api-reference/inboxes/update-inbox","matchLevel":0},"fr":{"href":"/fr/v2/api-reference/inboxes/update-inbox","matchLevel":1}}},"lastModified":"2026-10-28T14:54:58.436Z","originalFileLocation":"en/v2/api-reference/inboxes/update-inbox.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Updates the fields sent and leaves the others unchanged. Use notifications_muted to mute or unmute the inbox. Sending sources replaces the whole list. For a teammate\u0026#x27;s inbox, send user_id in the body. Size limits (name over 80 characters, emoji over 16, more than 100 sources or 10 conditions per source) return 400 INVALID_REQUEST_BODY with field_errors. A menu path not listed by the line\u0026#x27;s menu_options, or a null source, condition or digit, returns 400 INVALID_INBOX_SOURCE. Menu conditions are only accepted on a line whose menu_options list is not empty, with paths from that list; on other lines use a whole-line source (empty conditions). With user_id, an inbox with no source in a workspace the caller manages returns 404, and sources replaces only the lines in the caller\u0026#x27;s workspaces: the teammate\u0026#x27;s other-workspace lines are kept.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Allo — Help Center\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/themobilefirstcompany/XpmSCPLu2mWezDP7/_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/themobilefirstcompany/XpmSCPLu2mWezDP7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/themobilefirstcompany/XpmSCPLu2mWezDP7/_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/themobilefirstcompany/XpmSCPLu2mWezDP7/_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/themobilefirstcompany/XpmSCPLu2mWezDP7/_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/themobilefirstcompany/XpmSCPLu2mWezDP7/_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/themobilefirstcompany/XpmSCPLu2mWezDP7/_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/themobilefirstcompany/XpmSCPLu2mWezDP7/_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/themobilefirstcompany/XpmSCPLu2mWezDP7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update inbox - Allo — Help Center\">\u003cmeta data-mint-head property=\"og:description\" content=\"Updates the fields sent and leaves the others unchanged. Use notifications_muted to mute or unmute the inbox. Sending sources replaces the whole list. For a teammate\u0026#x27;s inbox, send user_id in the body. Size limits (name over 80 characters, emoji over 16, more than 100 sources or 10 conditions per source) return 400 INVALID_REQUEST_BODY with field_errors. A menu path not listed by the line\u0026#x27;s menu_options, or a null source, condition or digit, returns 400 INVALID_INBOX_SOURCE. Menu conditions are only accepted on a line whose menu_options list is not empty, with paths from that list; on other lines use a whole-line source (empty conditions). With user_id, an inbox with no source in a workspace the caller manages returns 404, and sources replaces only the lines in the caller\u0026#x27;s workspaces: the teammate\u0026#x27;s other-workspace lines are kept.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Allo — Help Center\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://themobilefirstcompany.mintlify.app/_mintlify/api/og/v2?division=Inboxes\u0026amp;title=Update+inbox\u0026amp;description=Updates+the+fields+sent+and+leaves+the+others+unchanged.+Use+%60notifications_muted%60+to+mute+or+unmute+the+inbox.+Sending+%60sources%60+replaces+the+whole+list.+For+a\u0026amp;theme=79d05b053982c0bb2603e704\u0026amp;signature=5e12b1a6111fbffe75ddfbe77b2465a883839647705d8fa056037c7299a0f1c8\">\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=\"Update inbox - Allo — Help Center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Updates the fields sent and leaves the others unchanged. Use notifications_muted to mute or unmute the inbox. Sending sources replaces the whole list. For a teammate\u0026#x27;s inbox, send user_id in the body. Size limits (name over 80 characters, emoji over 16, more than 100 sources or 10 conditions per source) return 400 INVALID_REQUEST_BODY with field_errors. A menu path not listed by the line\u0026#x27;s menu_options, or a null source, condition or digit, returns 400 INVALID_INBOX_SOURCE. Menu conditions are only accepted on a line whose menu_options list is not empty, with paths from that list; on other lines use a whole-line source (empty conditions). With user_id, an inbox with no source in a workspace the caller manages returns 404, and sources replaces only the lines in the caller\u0026#x27;s workspaces: the teammate\u0026#x27;s other-workspace lines are kept.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://themobilefirstcompany.mintlify.app/_mintlify/api/og/v2?division=Inboxes\u0026amp;title=Update+inbox\u0026amp;description=Updates+the+fields+sent+and+leaves+the+others+unchanged.+Use+%60notifications_muted%60+to+mute+or+unmute+the+inbox.+Sending+%60sources%60+replaces+the+whole+list.+For+a\u0026amp;theme=79d05b053982c0bb2603e704\u0026amp;signature=5e12b1a6111fbffe75ddfbe77b2465a883839647705d8fa056037c7299a0f1c8\">\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/themobilefirstcompany/XpmSCPLu2mWezDP7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Allo — Help Center\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#002C2A\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/v2/api-reference/inboxes/update-inbox.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://help.withallo.com/fr/v2/api-reference/inboxes/update-inbox\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.withallo.com/#organization\",\"name\":\"Allo — Help Center\",\"url\":\"https://help.withallo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/themobilefirstcompany/lUQseAX2HkM5_D4I/Allo-logo-dark.svg?fit=max\u0026auto=format\u0026n=lUQseAX2HkM5_D4I\u0026q=85\u0026s=fc710c4b2d7fad80babb5aff40fd445f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.withallo.com#website\",\"name\":\"Allo — Help Center\",\"url\":\"https://help.withallo.com\",\"publisher\":{\"@id\":\"https://help.withallo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox#webpage\",\"url\":\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox\",\"name\":\"Update inbox\",\"description\":\"Updates the fields sent and leaves the others unchanged. Use notifications_muted to mute or unmute the inbox. Sending sources replaces the whole list. For a teammate's inbox, send user_id in the body. Size limits (name over 80 characters, emoji over 16, more than 100 sources or 10 conditions per source) return 400 INVALID_REQUEST_BODY with field_errors. A menu path not listed by the line's menu_options, or a null source, condition or digit, returns 400 INVALID_INBOX_SOURCE. Menu conditions are only accepted on a line whose menu_options list is not empty, with paths from that list; on other lines use a whole-line source (empty conditions). With user_id, an inbox with no source in a workspace the caller manages returns 404, and sources replaces only the lines in the caller's workspaces: the teammate's other-workspace lines are kept.\",\"dateModified\":\"2026-10-28T14:54:58.436Z\",\"isPartOf\":{\"@id\":\"https://help.withallo.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Inboxes\",\"item\":\"https://help.withallo.com/en/v2/api-reference/inboxes/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update inbox\",\"item\":\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox#apireference\",\"headline\":\"Update inbox\",\"name\":\"Update inbox\",\"description\":\"Updates the fields sent and leaves the others unchanged. Use notifications_muted to mute or unmute the inbox. Sending sources replaces the whole list. For a teammate's inbox, send user_id in the body. Size limits (name over 80 characters, emoji over 16, more than 100 sources or 10 conditions per source) return 400 INVALID_REQUEST_BODY with field_errors. A menu path not listed by the line's menu_options, or a null source, condition or digit, returns 400 INVALID_INBOX_SOURCE. Menu conditions are only accepted on a line whose menu_options list is not empty, with paths from that list; on other lines use a whole-line source (empty conditions). With user_id, an inbox with no source in a workspace the caller manages returns 404, and sources replaces only the lines in the caller's workspaces: the teammate's other-workspace lines are kept.\",\"url\":\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox\",\"mainEntityOfPage\":{\"@id\":\"https://help.withallo.com/en/v2/api-reference/inboxes/update-inbox#webpage\"},\"dateModified\":\"2026-10-28T14:54:58.436Z\",\"publisher\":{\"@id\":\"https://help.withallo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://help.withallo.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Allo — Help Center\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Allo — Help Center","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Help","pages":[{"title":"Help","href":"/en/get-started"}]},{"tab":"API Reference","groups":[{"group":"API","pages":[{"title":"Overview","href":"/en/v2/api-reference/introduction"},{"title":"Authentication","href":"/en/v2/api-reference/guides/authentication"},{"title":"Rate limits","href":"/en/v2/api-reference/guides/rate-limits"},{"title":"Pagination","href":"/en/v2/api-reference/guides/pagination"},{"title":"Error handling","href":"/en/v2/api-reference/guides/error-handling"},{"title":"Error codes","href":"/en/v2/api-reference/guides/error-codes"},{"title":"Common use cases","href":"/en/v2/api-reference/guides/common-use-cases"}]},{"group":"Webhooks","pages":[{"title":"Overview","href":"/en/v2/api-reference/webhooks/overview"},{"title":"List webhooks","openapi":"GET /v2/api/webhooks","href":"/en/v2/api-reference/webhooks/get-webhooks"},{"title":"Get webhook","openapi":"GET /v2/api/webhooks/{webhook_id}","href":"/en/v2/api-reference/webhooks/get-webhook"},{"title":"Create webhook","openapi":"POST /v2/api/webhooks","href":"/en/v2/api-reference/webhooks/create-webhook"},{"title":"Update webhook","openapi":"PUT /v2/api/webhooks/{webhook_id}","href":"/en/v2/api-reference/webhooks/update-webhook"},{"title":"Delete webhook","openapi":"DELETE /v2/api/webhooks/{webhook_id}","href":"/en/v2/api-reference/webhooks/delete-webhook"},{"title":"List event types","openapi":"GET /v2/api/webhooks/event_types","href":"/en/v2/api-reference/webhooks/list-event-types"},{"title":"Event catalog","href":"/en/v2/api-reference/webhooks/event-catalog"},{"title":"Verifying webhook signatures","href":"/en/v2/api-reference/webhooks/verifying-signatures"},{"title":"Delivery and retries","href":"/en/v2/api-reference/webhooks/delivery-and-retries"},{"title":"Testing webhooks","href":"/en/v2/api-reference/webhooks/testing"},{"title":"Best practices","href":"/en/v2/api-reference/webhooks/best-practices"},{"title":"Troubleshoot","href":"/en/v2/api-reference/webhooks/troubleshooting"}]},{"group":"Conversations","pages":[{"title":"Overview","href":"/en/v2/api-reference/conversations/overview"},{"title":"List conversations","openapi":"GET /v2/api/conversations","href":"/en/v2/api-reference/conversations/list-conversations"},{"title":"Get conversation item","openapi":"GET /v2/api/conversations/items/{id}","href":"/en/v2/api-reference/conversations/get-item"},{"title":"Get recording download link","openapi":"GET /v2/api/conversations/items/{id}/recording","href":"/en/v2/api-reference/conversations/get-item-recording"},{"title":"Search conversation items","openapi":"POST /v2/api/conversations/items/search","href":"/en/v2/api-reference/conversations/search-conversation-items"},{"title":"Get many conversation items","openapi":"POST /v2/api/conversations/items/batch","href":"/en/v2/api-reference/conversations/batch-get"},{"title":"Execute conversation action","openapi":"PUT /v2/api/conversations/{contact_number}/action","href":"/en/v2/api-reference/conversations/execute-action"},{"title":"Update call summary","openapi":"PATCH /v2/api/conversations/items/{id}/summary","href":"/en/v2/api-reference/conversations/update-summary"},{"title":"Pin conversation","openapi":"PUT /v2/api/conversations/{contact_number}/pin","href":"/en/v2/api-reference/conversations/pin-conversation"},{"title":"Unpin conversation","openapi":"DELETE /v2/api/conversations/{contact_number}/pin","href":"/en/v2/api-reference/conversations/unpin-conversation"}]},{"group":"CRM","pages":[{"title":"Overview","href":"/en/v2/api-reference/crm/overview"}]},{"group":"People","pages":[{"title":"Overview","href":"/en/v2/api-reference/crm/people-overview"},{"title":"Get person","openapi":"GET /v2/api/crm/people/{id}","href":"/en/v2/api-reference/crm/get-person"},{"title":"Create person","openapi":"POST /v2/api/crm/people","href":"/en/v2/api-reference/crm/create-person"},{"title":"Update person","openapi":"PUT /v2/api/crm/people/{id}","href":"/en/v2/api-reference/crm/update-person"},{"title":"Search people","openapi":"POST /v2/api/crm/people/search","href":"/en/v2/api-reference/crm/search-people"}]},{"group":"Custom fields","pages":[{"title":"Overview","href":"/en/v2/api-reference/crm/attributes-overview"},{"title":"List custom fields","openapi":"GET /v2/api/crm/attributes","href":"/en/v2/api-reference/crm/list-attributes"},{"title":"Create custom field","openapi":"POST /v2/api/crm/attributes","href":"/en/v2/api-reference/crm/create-attribute"},{"title":"Update custom field","openapi":"PATCH /v2/api/crm/attributes/{key}","href":"/en/v2/api-reference/crm/update-attribute"},{"title":"Delete custom field","openapi":"DELETE /v2/api/crm/attributes/{key}","href":"/en/v2/api-reference/crm/delete-attribute"}]},{"group":"Views","pages":[{"title":"Overview","href":"/en/v2/api-reference/crm/views-overview"},{"title":"List views","openapi":"GET /v2/api/crm/views","href":"/en/v2/api-reference/crm/list-views"},{"title":"Get view","openapi":"GET /v2/api/crm/views/{id}","href":"/en/v2/api-reference/crm/get-view"},{"title":"Create view","openapi":"POST /v2/api/crm/views","href":"/en/v2/api-reference/crm/create-view"},{"title":"Update view","openapi":"PATCH /v2/api/crm/views/{id}","href":"/en/v2/api-reference/crm/update-view"},{"title":"Delete view","openapi":"DELETE /v2/api/crm/views/{id}","href":"/en/v2/api-reference/crm/delete-view"}]},{"group":"Companies","pages":[{"title":"Overview","href":"/en/v2/api-reference/crm/companies-overview"},{"title":"Get company","openapi":"GET /v2/api/crm/companies/{id}","href":"/en/v2/api-reference/crm/get-company"},{"title":"Create company","openapi":"POST /v2/api/crm/companies","href":"/en/v2/api-reference/crm/create-company"},{"title":"Update company","openapi":"PUT /v2/api/crm/companies/{id}","href":"/en/v2/api-reference/crm/update-company"},{"title":"Search companies","openapi":"POST /v2/api/crm/companies/search","href":"/en/v2/api-reference/crm/search-companies"},{"title":"List company attributes","openapi":"GET /v2/api/crm/companies/attributes","href":"/en/v2/api-reference/crm/list-company-attributes"},{"title":"Create company attribute","openapi":"POST /v2/api/crm/companies/attributes","href":"/en/v2/api-reference/crm/create-company-attribute"},{"title":"Update company attribute","openapi":"PATCH /v2/api/crm/companies/attributes/{key}","href":"/en/v2/api-reference/crm/update-company-attribute"},{"title":"Delete company attribute","openapi":"DELETE /v2/api/crm/companies/attributes/{key}","href":"/en/v2/api-reference/crm/delete-company-attribute"}]},{"group":"Deals","pages":[{"title":"Overview","href":"/en/v2/api-reference/crm/deals-overview"},{"title":"Search deals","openapi":"POST /v2/api/crm/deals/search","href":"/en/v2/api-reference/crm/search-deals"},{"title":"Get deal","openapi":"GET /v2/api/crm/deals/{id}","href":"/en/v2/api-reference/crm/get-deal"}]},{"group":"Notes","pages":[{"title":"Overview","href":"/en/v2/api-reference/notes/overview"},{"title":"List conversation notes","openapi":"GET /v2/api/conversations/{contact_number}/notes","href":"/en/v2/api-reference/notes/list-conversation-notes"},{"title":"Create conversation note","openapi":"POST /v2/api/conversations/{contact_number}/notes","href":"/en/v2/api-reference/notes/create-conversation-note"},{"title":"Get conversation note","openapi":"GET /v2/api/conversations/notes/{id}","href":"/en/v2/api-reference/notes/get-conversation-note"},{"title":"Update conversation note","openapi":"PATCH /v2/api/conversations/notes/{id}","href":"/en/v2/api-reference/notes/update-conversation-note"},{"title":"Delete conversation note","openapi":"DELETE /v2/api/conversations/notes/{id}","href":"/en/v2/api-reference/notes/delete-conversation-note"},{"title":"List person notes","openapi":"GET /v2/api/crm/people/{person_id}/notes","href":"/en/v2/api-reference/notes/list-person-notes"},{"title":"Create person note","openapi":"POST /v2/api/crm/people/{person_id}/notes","href":"/en/v2/api-reference/notes/create-person-note"},{"title":"Update person note","openapi":"PATCH /v2/api/crm/people/{person_id}/notes/{note_id}","href":"/en/v2/api-reference/notes/update-person-note"},{"title":"Delete person note","openapi":"DELETE /v2/api/crm/people/{person_id}/notes/{note_id}","href":"/en/v2/api-reference/notes/delete-person-note"}]},{"group":"Threads","pages":[{"title":"Overview","href":"/en/v2/api-reference/threads/overview"},{"title":"Get thread","openapi":"GET /v2/api/threads/{id}","href":"/en/v2/api-reference/threads/get-thread"},{"title":"Find thread","openapi":"GET /v2/api/threads","href":"/en/v2/api-reference/threads/find-thread"},{"title":"Create thread","openapi":"POST /v2/api/threads","href":"/en/v2/api-reference/threads/create-thread"},{"title":"Create thread comment","openapi":"POST /v2/api/threads/{id}/comments","href":"/en/v2/api-reference/threads/create-comment"},{"title":"Update thread comment","openapi":"PATCH /v2/api/threads/comments/{comment_id}","href":"/en/v2/api-reference/threads/update-comment"},{"title":"Resolve thread","openapi":"POST /v2/api/threads/{id}/resolve","href":"/en/v2/api-reference/threads/resolve-thread"},{"title":"Unresolve thread","openapi":"POST /v2/api/threads/{id}/unresolve","href":"/en/v2/api-reference/threads/unresolve-thread"}]},{"group":"Inboxes","pages":[{"title":"Overview","href":"/en/v2/api-reference/inboxes/overview"},{"title":"List inboxes","openapi":"GET /v2/api/inboxes","href":"/en/v2/api-reference/inboxes/list-inboxes"},{"title":"Get inbox suggestions","openapi":"GET /v2/api/inboxes/suggestions","href":"/en/v2/api-reference/inboxes/get-inbox-suggestions"},{"title":"List menu options","openapi":"GET /v2/api/numbers/{number}/menu_options","href":"/en/v2/api-reference/inboxes/list-menu-options"},{"title":"Create inbox","openapi":"POST /v2/api/inboxes","description":"Creates an inbox for the caller, or for a teammate with `user_id` in the body. Every source line must be accessible to the inbox owner. Up to 50 inboxes per user. Size limits (`name` over 80 characters, `emoji` over 16, more than 100 sources or 10 conditions per source) return `400` `INVALID_REQUEST_BODY` with `field_errors`. A menu path not listed by the line's `menu_options`, or a null source, condition or digit, returns `400` `INVALID_INBOX_SOURCE`. Menu conditions are only accepted on a line whose `menu_options` list is not empty, with paths from that list; on other lines use a whole-line source (empty `conditions`). For a teammate, the inbox must hold at least one line of the caller's workspace.","href":"/en/v2/api-reference/inboxes/create-inbox"},{"title":"Update inbox","openapi":"PATCH /v2/api/inboxes/{inbox_id}","href":"/en/v2/api-reference/inboxes/update-inbox"},{"title":"Delete inbox","openapi":"DELETE /v2/api/inboxes/{inbox_id}","description":"Deletes the inbox. Conversations are not affected. With `user_id`, an inbox with no source in a workspace the caller manages returns `404`, and an inbox that also holds lines from another workspace returns `403` `FORBIDDEN`.","href":"/en/v2/api-reference/inboxes/delete-inbox"}]},{"group":"Phone Numbers","pages":[{"title":"Overview","href":"/en/v2/api-reference/phone-numbers/overview"},{"title":"List phone numbers","openapi":"GET /v2/api/numbers","href":"/en/v2/api-reference/phone-numbers/list-numbers"},{"title":"Get call flow","openapi":"GET /v2/api/numbers/{number}/call_flow","href":"/en/v2/api-reference/phone-numbers/get-call-flow"},{"title":"Get call flow draft","openapi":"GET /v2/api/numbers/{number}/call_flow/draft","href":"/en/v2/api-reference/phone-numbers/get-call-flow-draft"},{"title":"Save call flow draft","openapi":"PUT /v2/api/numbers/{number}/call_flow/draft","href":"/en/v2/api-reference/phone-numbers/save-call-flow-draft"},{"title":"Publish call flow","openapi":"POST /v2/api/numbers/{number}/call_flow/publish","href":"/en/v2/api-reference/phone-numbers/publish-call-flow"}]},{"group":"AI Receptionist","pages":[{"title":"Overview","href":"/en/v2/api-reference/agent/overview"},{"title":"Get configuration","openapi":"GET /v2/api/numbers/{number}/agent","href":"/en/v2/api-reference/agent/get-agent"},{"title":"Update configuration","openapi":"PATCH /v2/api/numbers/{number}/agent","href":"/en/v2/api-reference/agent/update-agent"},{"title":"Set prompt","openapi":"PUT /v2/api/numbers/{number}/agent/prompt","href":"/en/v2/api-reference/agent/set-agent-prompt"},{"title":"Turn on or off","openapi":"PUT /v2/api/numbers/{number}/agent/status","href":"/en/v2/api-reference/agent/set-agent-status"},{"title":"Add website knowledge","openapi":"POST /v2/api/numbers/{number}/agent/knowledge/websites","href":"/en/v2/api-reference/agent/add-website-knowledge"},{"title":"Enable or disable a website","openapi":"PATCH /v2/api/numbers/{number}/agent/knowledge/websites/{id}","href":"/en/v2/api-reference/agent/update-website-knowledge"},{"title":"Delete website knowledge","openapi":"DELETE /v2/api/numbers/{number}/agent/knowledge/websites/{id}","href":"/en/v2/api-reference/agent/delete-website-knowledge"},{"title":"Delete file knowledge","openapi":"DELETE /v2/api/numbers/{number}/agent/knowledge/files/{id}","href":"/en/v2/api-reference/agent/delete-file-knowledge"},{"title":"List calendars","openapi":"GET /v2/api/calendars","href":"/en/v2/api-reference/agent/list-calendars"},{"title":"Get a calendar","openapi":"GET /v2/api/calendars/{id}","href":"/en/v2/api-reference/agent/get-calendar"},{"title":"List voices","openapi":"GET /v2/api/voices","href":"/en/v2/api-reference/agent/list-voices"}]},{"group":"Tags","pages":[{"title":"Overview","href":"/en/v2/api-reference/tags/overview"},{"title":"List tags","openapi":"GET /v2/api/tags","href":"/en/v2/api-reference/tags/list-tags"},{"title":"Create tag","openapi":"POST /v2/api/tags","href":"/en/v2/api-reference/tags/create-tag"},{"title":"Delete tag","openapi":"DELETE /v2/api/tags/{id}","href":"/en/v2/api-reference/tags/delete-tag"},{"title":"Add tags","openapi":"POST /v2/api/conversations/items/{id}/tags","href":"/en/v2/api-reference/tags/add-tags"},{"title":"Remove tag","openapi":"DELETE /v2/api/conversations/items/{id}/tags/{tag}","href":"/en/v2/api-reference/tags/remove-tag"}]},{"group":"Summary Templates","pages":[{"title":"Overview","href":"/en/v2/api-reference/summary-templates/overview"},{"title":"List summary templates","openapi":"GET /v2/api/summary_templates","href":"/en/v2/api-reference/summary-templates/list-summary-templates"},{"title":"Get summary template","openapi":"GET /v2/api/summary_templates/{id}","href":"/en/v2/api-reference/summary-templates/get-summary-template"},{"title":"Create summary template","openapi":"POST /v2/api/summary_templates","href":"/en/v2/api-reference/summary-templates/create-summary-template"},{"title":"Update summary template","openapi":"PUT /v2/api/summary_templates/{id}","href":"/en/v2/api-reference/summary-templates/update-summary-template"},{"title":"Delete summary template","openapi":"DELETE /v2/api/summary_templates/{id}","href":"/en/v2/api-reference/summary-templates/delete-summary-template"},{"title":"Set a number's default template","openapi":"PUT /v2/api/numbers/{number}/default_summary_template","href":"/en/v2/api-reference/summary-templates/set-number-default-summary-template"}]},{"group":"Users","pages":[{"title":"Overview","href":"/en/v2/api-reference/users/overview"},{"title":"Me","openapi":"GET /v2/api/me","href":"/en/v2/api-reference/users/me"},{"title":"List users","openapi":"GET /v2/api/users","href":"/en/v2/api-reference/users/list-users"},{"title":"Get user","openapi":"GET /v2/api/users/{id}","href":"/en/v2/api-reference/users/get-user"}]},{"group":"SMS","pages":[{"title":"Overview","href":"/en/v2/api-reference/sms/overview"},{"title":"Send SMS","openapi":"POST /v1/api/sms","href":"/en/v2/api-reference/sms/send-sms"},{"title":"Send SMS (France)","openapi":"POST /v1/api/sms#france","href":"/en/v2/api-reference/sms/send-sms-france"}]},{"group":"Analytics","pages":[{"title":"Overview","href":"/en/v2/api-reference/analytics/overview"},{"title":"Team metrics","openapi":"POST /v2/api/analytics/overview","href":"/en/v2/api-reference/analytics/team-summary"},{"title":"Outbound metrics","openapi":"POST /v2/api/analytics/outbound","href":"/en/v2/api-reference/analytics/outbound"}]},{"group":"Power Dialer","pages":[{"title":"Overview","href":"/en/v2/api-reference/dialing-queues/overview"},{"title":"List current queue numbers","openapi":"GET /v2/api/dialing-queues/current","href":"/en/v2/api-reference/dialing-queues/get-current"},{"title":"Upsert current queue","openapi":"PATCH /v2/api/dialing-queues/current","href":"/en/v2/api-reference/dialing-queues/update-current"},{"title":"Append numbers","openapi":"POST /v2/api/dialing-queues/current/numbers","href":"/en/v2/api-reference/dialing-queues/append-numbers"},{"title":"Clear queue numbers","openapi":"DELETE /v2/api/dialing-queues/current/numbers","href":"/en/v2/api-reference/dialing-queues/clear-numbers"},{"title":"Reset current queue","openapi":"POST /v2/api/dialing-queues/current","href":"/en/v2/api-reference/dialing-queues/reset-current"},{"title":"Reassign queue","openapi":"PATCH /v2/api/dialing-queues/{queue_id}/assignee","href":"/en/v2/api-reference/dialing-queues/assign-queue"}]},{"group":"Partner","pages":[{"title":"Overview","href":"/en/v2/api-reference/partner/overview"},{"title":"Get account price","openapi":"GET /v2/api/partner/accounts/price","href":"/en/v2/api-reference/partner/get-price"},{"title":"Create account","openapi":"POST /v2/api/partner/accounts","href":"/en/v2/api-reference/partner/create-account"},{"title":"Get account","openapi":"GET /v2/api/partner/accounts/{id}","href":"/en/v2/api-reference/partner/get-account"},{"title":"Deactivate account","openapi":"DELETE /v2/api/partner/accounts/{id}","href":"/en/v2/api-reference/partner/delete-account"},{"title":"Get number price","openapi":"GET /v2/api/partner/accounts/{id}/numbers/price","href":"/en/v2/api-reference/partner/get-number-price"},{"title":"Add number","openapi":"POST /v2/api/partner/accounts/{id}/numbers","href":"/en/v2/api-reference/partner/add-number"},{"title":"Add member","openapi":"POST /v2/api/partner/accounts/{id}/members","href":"/en/v2/api-reference/partner/add-member"},{"title":"List members","openapi":"GET /v2/api/partner/accounts/{id}/members","href":"/en/v2/api-reference/partner/list-members"},{"title":"Get prepaid credit","openapi":"GET /v2/api/partner/credit","href":"/en/v2/api-reference/partner/get-credit"},{"title":"Get eSIM offer","openapi":"GET /v2/api/partner/accounts/{account_id}/esims/offer","href":"/en/v2/api-reference/partner/get-esim-offer"},{"title":"Order eSIM","openapi":"POST /v2/api/partner/accounts/{account_id}/esims","href":"/en/v2/api-reference/partner/order-esim"},{"title":"Get eSIM","openapi":"GET /v2/api/partner/esims/{id}","href":"/en/v2/api-reference/partner/get-esim"},{"title":"Get eSIM activation code","openapi":"GET /v2/api/partner/esims/{id}/activation_code","href":"/en/v2/api-reference/partner/get-esim-activation-code"}]}]}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/v2/api-reference/inboxes/update-inbox"}]}]},"title":"Update inbox - Allo — Help Center","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}