Airtable API Common Troubleshooting | Airtable Support

link管理

链接快照平台

输入网页链接，自动生成快照
标签化管理网页链接

相关文章推荐

痴情的雪糕 · DELETE - Apache Doris· 4 周前 ·

聪明伶俐的跑步鞋 · sfguide-using-snowflak ...· 3 周前 ·

酷酷的柑橘 · PolarDB-X1.0的常见错误码及解决方 ...· 2 周前 ·

魁梧的八宝粥 · Re: Reading external ...· 2 周前 ·

会开车的山楂 · Linux Error Number ...· 2 天前 ·

细心的针织衫 · 深蓝SL03价格明细，长安SL03深蓝多少钱 ...· 2 月前 ·

威武的日记本 · 什么是公共卫生事件· 7 月前 ·

强健的碗 · 失衡凶間之罪與殺影評｜ ...· 1 年前 ·

完美的地瓜 · 3D Printing - Media ...· 1 年前 ·

玉树临风的黄瓜 · 在安卓系统中，如何使用ObjectAnima ...· 1 年前 ·

</noscript> <div class="mobile_header_logo"/><div class="search_overlay"/><header id="doc_header"><div class="header_top"><div class="container"><a href="/" class="header_logo"> <img src="//cdn.airtable.document360.io/logo/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/360446de52ff494081b795b87a150ef3-Airtable_Logo.png" alt="Airtable Support"/> </a><div class="header_top_nav"><div class="header_top_nav_left"><ul/></div><div class="header_top_nav_right"><ul><li><a href="//support.airtable.com/docs/contacting-airtable-support?contact_support=true" style="background:#ffffff;color:#333333" class="action-item">Contact Support</a></li><li><a href="//airtable.com/signup" target="_blank" style="background:#0768f8;color:#ffffff" class="action-item">Sign up for free</a></li></ul></div><div class="header_top_nav_options"/></div><div class="clearfix"/></div></div><div id="smartBarContainer1"/><div class="header_bottom"><div class="container"><div class="header_bottom_nav javascriptDisabled"><ul><li><a href="/v1/en" class="home-icon"><i class="fal fa-home"/></a></li>  <li class="whats-new-icon"><a href="/docs/en/whats-newx" class="whats-new-icon"><span title="What's New"><i class="fal fa-gift"/></span></a></li><li class="header-dropdown-selection-list"><div class="header-dropdown-selection" id="language-versions-ddl"><div class="btn-select"><span class="v-name">English</span></div><div class="header-dropdown language"><ul><li><a class="active" href="/docs/en/airtable-api-common-troubleshooting" title="en"> English </a></li><li><a class="active" href="/docs/fr/airtable-api-common-troubleshooting" title="fr"> French </a></li><li><a class="active" href="/docs/de/airtable-api-common-troubleshooting" title="de"> German </a></li><li><a class="active" href="/docs/es/airtable-api-common-troubleshooting" title="es"> Spanish </a></li></ul></div></div></li></ul><div class="header_search"><div class="header_search_box" id="header_search_box"><div class="aa-input-container search-form" id="aa-input-container"><div name="searchform" id="Searchform"><input type="search" id="aa-search-input" class="aa-input-search" placeholder="Search" name="search" autocomplete="off"/> <a class="ais-SearchBox-submit" id="all_search_results" href="#"> <svg xmlns="http://www.w3.org/2000/svg" width="10" height="10" viewbox="0 0 40 40"><path d="M26.804 29.01c-2.832 2.34-6.465 3.746-10.426 3.746C7.333 32.756 0 25.424 0 16.378 0 7.333 7.333 0 16.378 0c9.046 0 16.378 7.333 16.378 16.378 0 3.96-1.406 7.594-3.746 10.426l10.534 10.534c.607.607.61 1.59-.004 2.202-.61.61-1.597.61-2.202.004L26.804 29.01zm-10.426.627c7.323 0 13.26-5.936 13.26-13.26 0-7.32-5.937-13.257-13.26-13.257C9.056 3.12 3.12 9.056 3.12 16.378c0 7.323 5.936 13.26 13.258 13.26z"/></svg> </a> <button class="ais-SearchBox-reset" style="" id="cancel-search-input"> <svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 20 20" width="10" height="10"><path d="M8.114 10L.944 2.83 0 1.885 1.886 0l.943.943L10 8.113l7.17-7.17.944-.943L20 1.886l-.943.943-7.17 7.17 7.17 7.17.943.944L18.114 20l-.943-.943-7.17-7.17-7.17 7.17-.944.943L0 18.114l.943-.943L8.113 10z"/></svg> </button> <span class="ais-SearchBox-loadingIndicator" style="" id="search-input-loading"> <svg width="16" height="16" viewbox="0 0 38 38" xmlns="http://www.w3.org/2000/svg" stroke="#444"><g fill="none" fillrule="evenodd"><g transform="translate(1 1)" strokewidth="2"><circle strokeopacity=".5" cx="18" cy="18" r="18"/><path d="M36 18c0-9.94-8.06-18-18-18" transform="rotate(3.02328 18 18)"><animatetransform attributename="transform" type="rotate" from="0 18 18" to="360 18 18" dur="1s" repeatcount="indefinite"/></path></g></g></svg> </span></div></div></div></div><div class="clearfix"/></div></div></div><div class="headermobile_nav360"/><div class="header_nav_menus"><div class="container"><ul><li class="multi-level-menu">Account<div class="multi-level-menu-content"><a href="//support.airtable.com/docs/managing-billable-collaborators-from-your-airtable-account">Account overview</a> <a href="//support.airtable.com/docs/billing-overview-and-faqs">Billing</a> <a href="//support.airtable.com/docs/airtable-security-practices">Policies</a></div></li><li class="multi-level-menu">API<div class="multi-level-menu-content"><a href="//support.airtable.com/docs/public-rest-api">API Overview</a> <a href="//support.airtable.com/docs/how-do-i-get-my-api-key-">Get your API key</a> <a href="//airtable.com/api" target="_blank">Documentation</a> <a href="//support.airtable.com/docs/api-common-troubleshooting">Troubleshooting</a></div></li><li class="multi-level-menu">Integrations<div class="multi-level-menu-content"><a href="//www.airtable.com/developers" target="_blank">Resources</a> <a href="//community.airtable.com/c/developers/55" target="_blank">Community</a></div></li><li class="multi-level-menu">Enterprise<div class="multi-level-menu-content"><a href="//support.airtable.com/docs/overview-enterprise-admin-panel">Admin Panel</a> <a href="//www.airtable.com/enterprise" target="_blank">Enterprise Plans</a> <a href="//www.airtable.com/security" target="_blank">Airtable Security</a> <a href="//www.airtable.com/tos" target="_blank">Terms of Service</a> <a href="//www.airtable.com/privacy" target="_blank">Privacy Policy</a></div></li><li class="multi-level-menu">Resources<div class="multi-level-menu-content"><a href="//community.airtable.com/" target="_blank">Community</a> <a href="//airtable.com/marketplace" target="_blank">Marketplace</a> <a href="//www.airtable.com/templates" target="_blank">Templates</a> <a href="//www.airtable.com/universe" target="_blank">Universe</a></div></li></ul></div></div><div id="bread-crumb-container"/></header><div class="main_content_block" id="doc_main_content"><div><div class="container docs-main"><div class="docs-main-content"><div class="left_sidebar" data-nosnippet=""><div class="left-sidebar-header">Contents <span>x</span></div><div class="left_sidebar_main"><div id="doc_left_sidebar" class="left_sidebar_nav first_ct_open"><div class="left_sidebar_nav_menu" id="left_sidebar_nav_menu" dir="auto"><ul id="categories" class="leftsidebarnav"><li class="article-title-container"><a href="introduction-to-airtable-basics"> <span class="article-title"> Getting started with Airtable </span> </a></li><li class="article-title-container"><a href="automations-overview-articles"> <span class="article-title"> Airtable Automations </span> </a></li><li class="article-title-container"><a href="creating-new-bases"> <span class="article-title"> Airtable Bases </span> </a></li><li class="article-title-container"><a href="airtable-public-betas"> <span class="article-title"> Airtable Betas </span> </a></li><li class="article-title-container"><a href="working-with-collaborators"> <span class="article-title"> Collaborating in Airtable </span> </a></li><li class="article-title-container"><a href="general-information"> <span class="article-title"> Airtable Enterprise Support </span> </a></li><li class="article-title-container"><a href="extensions-overview"> <span class="article-title"> Airtable Extensions </span> </a></li><li class="article-title-container"><a href="fields-overview"> <span class="article-title"> Airtable Fields </span> </a></li><li class="article-title-container"><a href="api"> <span class="article-title"> Integrating with Airtable </span> </a></li><li class="article-title-container"><a href="interface-designer-overview-articles"> <span class="article-title"> Airtable Interface Designer </span> </a></li><li class="article-title-container"><a href="webinars"> <span class="article-title"> Learning and Resources </span> </a></li><li class="article-title-container"><a href="account"> <span class="article-title"> Managing Airtable </span> </a></li><li class="article-title-container"><a href="airtable-security-practices"> <span class="article-title"> Airtable Policy </span> </a></li><li class="article-title-container"><a href="record-actions"> <span class="article-title"> Airtable Records </span> </a></li><li class="article-title-container"><a href="sync-overview-articles"> <span class="article-title"> Airtable Sync </span> </a></li><li class="article-title-container"><a href="view-basics"> <span class="article-title"> Airtable Views </span> </a></li><li class="article-title-container"><a href="creating-and-deleting-airtable-workspaces"> <span class="article-title"> Airtable Workspaces </span> </a></li></ul></div><div class="watermark_logo" style="display:block!important;visibility:visible!important;opacity:1!important"><a href="//document360.com/powered-by-document360/?utm_source=docs&amp;utm_medium=footer&amp;utm_campaign=poweredbylogo" target="_blank" style="display:block!important;visibility:visible!important;opacity:1!important"> <span>Powered by</span><img style="display:inline!important;visibility:visible!important" src="//cdn.airtable.document360.io/static/images/document360-logo.svg" alt="Document360"/> </a></div></div></div></div><div class="content_block" id="doc_content_block"><div id="loadingArticle" style=""><div class="content_container"><div class="content_container_text_sec"><div class="content_container_text_sec_in article-content-loading"><div class="content_block_head"><div class="article-title" dir="auto"><span/> <span/></div><hr/></div><div class="content_block_text"><div class="article-content"><div class="text"><span/> <span/> <span/> <span/></div><div class="text-img"><div class="image"/><div class="img-text"><span/><span/><span/><span/><span/><span/><span/><span/></div></div><div class="text-img"><div class="img-text"><span/><span/><span/><span/><span/><span/><span/><span/></div><div class="image"/></div><div class="text"><span/> <span/> <span/> <span/></div></div></div></div></div></div></div><div id="partialViewContainer"><div class="stickytop"><div class="sticky-details"><div class="article-top-head"><div class="article-title">Airtable API: Common troubleshooting</div><div class="artile_info"><ul><li><i class="fal fa-calendar-alt" aria-hidden="true"/><span>17 Jul 2024</span></li><li><i class="fal fa-clock" aria-hidden="true"/> <span> 8 Minutes to read </span></li></ul></div></div><div class="share-details"><p>Share this <i class="fal fa-hand-point-right"/></p><div class="share-buttons"><div id="shareIconsTop"/></div></div></div><div class="progress-container"><div class="progress-bar" id="progressBar"/></div></div><div class="content-header"><div class="container"><div class="article-action-items"><ul><li><div class="print_page action-item" id="print_PDF"><i class="fal fa-print"/> <span>Print</span></div></li><li><div class="share_content action-item" id="showShareIconsMobile"><i class="fal fa-share-square"/> <span>Share</span></div><div class="social_share" id="shareIconsContainerMobile"><div id="shareIconsMobile"/></div></li><li><div class="action-item" id="darkThemeMobile"><i class="fal fa-moon"/> <span>Dark</span></div><div class="action-item" id="lightThemeMobile"><i class="fal fa-sun"/> <span>Light</span></div></li><li><div class="generate_article_pdf action-item"><div class="generate_article_span"><i class="fal fa-file-pdf"/> <span>PDF</span></div><span class="generate_pdf_spinner" style=""/></div></li></ul></div><div class="left-sidebar-header-show"><i class="fal fa-list"/><span>Contents</span></div></div></div><div id="doc_content_block"><div class="content_container"><div class="content_container_text_sec"><div class="content_container_text_sec_in"><div id="smartBarContainer3"/><div class="content_block_head"><div class="content_block_article_head" dir="auto"><h1>Airtable API: Common troubleshooting</h1></div><div class="article-head-sec"><div class="article-info"><ul><li><i class="fal fa-calendar-alt" aria-hidden="true"/><span>Updated on 17 Jul 2024</span></li><li><i class="fal fa-clock" aria-hidden="true"/> <span> 8 Minutes to read </span></li></ul></div><div class="article-action-items"><ul><li><div class="print_page action-item" id="print_PDF_1"><i class="fal fa-print"/> <span>Print</span></div></li><li><div class="share_content action-item" id="showShareIcons"><i class="fal fa-share-square"/> <span>Share</span></div><div class="social_share" id="shareIconsContainer"><div id="shareIcons"/></div></li><li><div class="action-item" id="darkTheme"><i class="fal fa-moon"/> <span>Dark</span></div><div class="action-item" id="lightTheme"><i class="fal fa-sun"/> <span>Light</span></div></li><li><div class="generate_article_pdf action-item"><div class="generate_article_span"><span class="generate_pdf_spinner" style=""/> <i class="fal fa-file-pdf"/> <span>PDF</span></div></div></li></ul></div></div><hr/></div><div id="ai-article-summary-callout" class="ai-article-summary-callout"><div class="summary-content" id="summary-content"><div class="aisummary-title">Article summary</div><span class="close" id="close-ai-article-summary"><i class="fal fa-times-circle"/></span><div class="aisummary-content" id="aisummary-content"><p/></div></div><div class="summary-feedback"><div class="feedback">Did you find this summary helpful? <button class="btn thumbs-btn" id="thumbs-up"> <i class="fal fa-thumbs-up"/> </button> <button class="btn thumbs-btn" id="thumbs-up-dis" disabled="disabled"> <i class="fas fa-thumbs-up like"/> </button> <button class="btn thumbs-btn" id="thumbs-down"> <i class="fal fa-thumbs-down"/> </button> <button class="btn thumbs-btn" id="thumbs-down-dis" disabled="disabled"> <i class="fas fa-thumbs-down dislike"/> </button></div><div class="comment-box" id="comment-box"><input placeholder="Suggestions for improvements (Optional)" class="optional-comments" autocomplete="off"/> <button class="btn send-btn" id="send-btn"> <i class="fas fa-paper-plane send"/> </button></div><div class="feedback-sent">Thank you for your feedback</div></div></div><div class="content_block_text" dir="auto"><p dir="ltr" data-block-id="b96b6976-dac4-419f-8541-0e033fe109ad">At times, you may encounter errors while making API calls. This article is meant to explain and troubleshoot the most common errors or issues that folks run into. For an exhaustive listing of errors please refer to our <a href="//airtable.com/developers/web/api/introduction" target="_blank" translate="no">API documentation</a>. If you end up needing to send in a support ticket, please follow the guidelines listed in the last section to have the most efficient customer service experience.</p><p dir="ltr" data-block-id="0cae04f8-c278-4cc7-8d2d-81dca25945ed">2xx codes signify success, 4xx mostly represent user error, 5xx generally correspond to a server error. The error messages will return a JSON-encoded body that contains error and message fields. Those will provide specific error conditions and human-readable messages to identify what caused the error.</p><h2 dir="ltr" data-block-id="d8012391-1575-4d12-ae35-808233947bb8">Success code</h2><p dir="ltr" data-block-id="2fd1b4eb-2f21-4e16-aae3-612815084155"><strong>200 OK</strong> - Request completed successfully.</p><h2 dir="ltr" data-block-id="1adf8645-0c43-43c3-a732-026978518dfa">User error codes</h2><p dir="ltr" data-block-id="1c843d10-85db-4371-80ca-5f882f11aae0">These errors generally indicate a problem on the client side. If you are getting one of these, check your code and the request details.</p><ul dir="ltr" data-block-id="8e25fdcb-abe6-48f2-aa24-3937420d79d7"><li dir="ltr" data-block-id="cd0d1804-2584-4f66-8da0-5bb59ade6a56"><p dir="ltr" data-block-id="979731ee-9645-4a0e-b04c-6d144c6ae71b"><strong>400 Bad Request</strong> - The request encoding is invalid; the request can't be parsed as a valid JSON.</p></li><li dir="ltr" data-block-id="b89fd246-9d54-4a7d-9537-cbd424e2b97a"><p dir="ltr" data-block-id="f8e69f47-61fe-4b46-b533-34f500bf92ab"><strong>401 Unauthorized</strong> - Accessing a protected resource without authorization or with invalid credentials.</p><ul dir="ltr" data-block-id="1b400c49-1bad-4544-ad71-8b890b32bb6d"><li dir="ltr" data-block-id="9bff9f1c-cf0e-49b6-be19-df53940db41c"><p dir="ltr" data-block-id="0f53cabc-f0f3-4400-a9a8-b15c8fcebc12">401 error: authentication_required</p><ul dir="ltr" data-block-id="394f884a-c545-4a9d-bb14-bef55b4cd9e9"><li dir="ltr" data-block-id="8871129a-0360-4d4c-b7ec-ede50845dc44"><p dir="ltr" data-block-id="1252a951-8d0e-47cc-a9dc-5b2c9f32c3f0">Error meaning - The access token was not present in the request, or it was passed incorrectly.</p></li><li dir="ltr" data-block-id="830196eb-590b-4152-a8e9-8f129051a1b8"><p dir="ltr" data-block-id="a2583cb7-497a-42a7-816b-a4997854fc58">Troubleshooting steps - Find your access token and add it to your request. To include an access token in the request use the Authorization header. When using the Authorization header method, make sure to use Bearer authentication (rather than basic).</p></li></ul></li><li dir="ltr" data-block-id="f0292a45-f782-41a4-a45a-4bd97350ed8a"><p dir="ltr" data-block-id="d7ae06c4-80c5-466e-81e5-049cc5f674c1">401 error: unauthorized, invalid authentication token</p><ul dir="ltr" data-block-id="75261420-03c3-4f9b-81c2-d7c19020bda4"><li dir="ltr" data-block-id="265c20b0-5e74-497f-bb2a-3a459cdd4815"><p dir="ltr" data-block-id="504a70ae-06ad-47db-a376-e8ca9dc2095d">Error meaning - The access token that was provided is invalid.</p></li><li dir="ltr" data-block-id="9662163d-3380-491b-bcca-3d14aed0d110"><p dir="ltr" data-block-id="85afdf31-7519-45d8-a90c-b89baad841f3">Troubleshooting steps - Check that the access token you are using is the same as the access token you’ve already set up.</p></li></ul></li></ul></li><li dir="ltr" data-block-id="adeb1a7c-87ae-4ca1-a7dd-c2821ba8ff34"><p dir="ltr" data-block-id="ba727a22-a0cf-4184-8401-2da42afc015c"><strong>403 Forbidden</strong> - Accessing a protected resource with API credentials that don't have access to that resource. <a href="/docs/airtable-api-common-troubleshooting#example-error-responses" target="_self" translate="no">See below</a> for examples and suggested debugging steps.</p><ul dir="ltr" data-block-id="47af6531-7c51-4413-88fd-25b020118a72"><li dir="ltr" data-block-id="24976905-2084-4a5b-9616-4cedd3f8fcd6"><p dir="ltr" data-block-id="193963d8-e40a-4dfb-ba4e-57f17f8372cc">403 error: invalid_permissions</p><ul dir="ltr" data-block-id="46c86b4f-eb1f-4ff7-a3a1-cf2d589ed123"><li dir="ltr" data-block-id="8c7c49bf-0285-4950-8914-de184df6d1f0"><p dir="ltr" data-block-id="9f17423e-2501-466b-b78d-5f33c0a68b8e">Error meaning - The access token was passed correctly in the request, but you do not have permission to perform the action in the API request.</p></li><li dir="ltr" data-block-id="02005e7e-2eb2-4410-9f62-15c1e1bb6169"><p dir="ltr" data-block-id="fd786cd5-aaa1-420e-bb5c-580213b8a8ab">Troubleshooting steps - Reach out to a base/workspace owner or creator to have your permission level increased.</p></li></ul></li><li dir="ltr" data-block-id="f74830b2-7bc6-4c72-94ea-58e60346ff50"><p dir="ltr" data-block-id="9cad9f12-94af-4543-9c25-2437edeb64be">403 error: invalid_permissions (field or table operation limits)</p><ul dir="ltr" data-block-id="eb4737c2-df67-4e96-a5e8-0c190ea7f69a"><li dir="ltr" data-block-id="016ae4e4-146e-4a92-998b-92e46628cc97"><p dir="ltr" data-block-id="572a8a7c-33db-4f8c-ac3c-124ddba69a3d">Error meaning - There are table or field-level permissions that are prohibiting the operation; this means that the field or table has been configured to limit who can perform this operation.</p></li><li dir="ltr" data-block-id="a5e42b8d-43c8-4c2b-b254-c31f071972b4"><p dir="ltr" data-block-id="3fb0035b-e0d1-4efe-b4c6-466ef78db616">Troubleshooting steps - Check the fields and table being referenced in your API request. There are likely conflicting <a href="/docs/using-field-and-table-editing-permissions" target="_self" translate="no">field and table editing permissions</a>. Try performing the same operation as the API request, but within the Airtable UI - this should help to identify the specific field(s) that you are unable to edit by process of elimination.</p><p dir="ltr" data-block-id="ba486bbd-99c6-46cf-9b95-abcb84c2ec9e">This error can also occur when creating or updating a record and writing a new value to a linked record field. If we are unable to find a matching record in the linked (foreign) table, then we will attempt to create a record in that foreign table and set the primary field to the value given in the API request. That request to create the foreign record will fail if the foreign table is a synced table since it's not possible to create records in a synced table. It will also fail if the foreign table has a formula field as the primary field since it's not possible to write directly to a formula field.</p></li></ul></li></ul></li><li dir="ltr" data-block-id="be03e399-2465-405d-9129-e16d5ba5af1b"><p dir="ltr" data-block-id="efc5dc2c-07a4-405e-b382-229749c2f898"><strong>404 Not Found</strong> - Route or resource is not found. This error is returned when the request hits an undefined route, or if the resource doesn't exist (e.g. has been deleted).</p></li><li dir="ltr" data-block-id="330ab66f-7c16-4908-97a4-38feb35c8a21"><p dir="ltr" data-block-id="ed4c3de8-cf56-48fc-9b0b-401bb022beed"><strong>406 error: blocked</strong></p><ul dir="ltr" data-block-id="5f454db8-478f-4beb-81c2-2d77d7b819e8"><li dir="ltr" data-block-id="fc4f9ed0-8e53-4ba2-9030-7d80936ca796"><p dir="ltr" data-block-id="66d1aaff-64a4-4f44-9031-c1f58236104d">Error meaning - The request was blocked for security reasons.</p></li><li dir="ltr" data-block-id="8493e047-ac81-4a7a-b02b-fcae63ed6209"><p dir="ltr" data-block-id="fb23a93a-1d16-4129-a75b-21c5cbf9beb5">Troubleshooting steps - If you receive HTTP 406 errors from <a href="http://airtable.com" translate="no">airtable.com</a> or <a href="http://api.airtable.com" translate="no">api.airtable.com</a> and believe these are in error, <a href="/docs/airtable-api-common-troubleshooting#support-interaction-guidance" target="_self" translate="yes">follow the guidance listed here</a>.</p></li></ul></li><li dir="ltr" data-block-id="773464cf-20f9-4be1-949d-13116c3e120a"><p dir="ltr" data-block-id="2a79e3dd-ee92-4b11-8c6c-9af23bc3abd2"><strong>413 Request Entity Too Large</strong> - The request exceeded the maximum allowed payload size. You shouldn't encounter this under normal use.</p></li><li dir="ltr" data-block-id="4bb10b6b-7b27-4a91-9a4e-352fe0a02b95"><p dir="ltr" data-block-id="7d6e73f9-7703-4e13-9a3b-773c958c008e"><strong>422 Invalid Request</strong> - The request data is invalid. This includes most of the base-specific validations. You will receive a detailed error message and code pointing to the exact issue.</p><ul dir="ltr" data-block-id="7e30fad2-59c6-4787-9b02-34cb70ba5e49"><li dir="ltr" data-block-id="7d9a0cc3-95f5-44ef-8eb5-086fa105bea5"><p dir="ltr" data-block-id="6688a6ba-286c-40d5-aa3d-64e036e1f18d">422 error: invalid_request_body (unable to parse request body)</p><ul dir="ltr" data-block-id="f3a479fa-0f52-4ca6-9655-b6975f775c52"><li dir="ltr" data-block-id="19b721a1-f1d2-4305-8383-6d2aa649d7c8"><p dir="ltr" data-block-id="93dd42c5-a99d-499a-8887-eed5c9876058">Error meaning - Something is wrong with the request body.</p></li><li dir="ltr" data-block-id="82816cb3-f9d6-49c9-b8a7-98b6886e12ed"><p dir="ltr" data-block-id="67a549bd-ec16-446c-bf86-b3b5e29e2b1c">Troubleshooting steps - First, check that the request body is valid JSON, and matches the example request body for the desired operation in our API documentation. Also ensure that the Content-Type: application/json header is included if you are making a <code>POST</code>, <code>PUT</code>, or <code>PATCH</code> request.</p></li></ul></li><li dir="ltr" data-block-id="353ff433-8a73-4b97-86a0-0b91ef346c7d"><p dir="ltr" data-block-id="b449b3e1-99d3-4be7-8e4d-b9c0cd4ad46c">422 error: invalid_multiple_choice_options</p><ul dir="ltr" data-block-id="f91e59e7-42d1-4d93-a556-3696914df17d"><li dir="ltr" data-block-id="c3040d0b-cff5-4e38-aac7-36d3bd9f398a"><p dir="ltr" data-block-id="27e590a3-c35c-4000-8fd5-2c9054ad4605">Error meaning - A select field option that does not yet exist in the field was present in the API request body.</p></li><li dir="ltr" data-block-id="927a73d9-cc7a-4591-afd6-5760258c91c5"><p dir="ltr" data-block-id="aa6113e9-ba80-40a2-b20c-6cbbc4ac0a7e">Troubleshooting steps - When creating or updating records, if the choice string does not exactly match an existing option, the request will fail with an <code>INVALID_MULTIPLE_CHOICE_OPTIONS</code> error unless the typecast parameter is enabled. If typecast is enabled, a new choice will be created if one does not exactly match. To see an example of how to include the typecast parameter in your request body, visit the API documentation under "<a href="//airtable.com/developers/web/api/create-records" target="_blank" translate="yes">Create records</a>".</p></li></ul></li><li dir="ltr" data-block-id="39eadcd5-c70d-4f75-a37f-ce541852f3e8"><p dir="ltr" data-block-id="1906ad3a-30b0-40d9-ae7b-8852e0731e2f">422 error: FAILED_STATE_CHECK</p><ul dir="ltr" data-block-id="97a97652-5617-4487-9359-391f90725062"><li dir="ltr" data-block-id="ab82cca5-e9a4-462d-a2da-773e4a61dab7"><p dir="ltr" data-block-id="c83d9f18-4dbe-4ae2-add5-df95e060bde3">Error meaning - values and/or parameters in the endpoint path have been mismatched</p></li><li dir="ltr" data-block-id="a80a1104-967d-4914-b74e-d3953bdf567e"><p dir="ltr" data-block-id="ad520a39-9c0e-4dd0-b7d1-742395674fa2">Troubleshooting steps - Review the URL path and parameters to verify that the values indicated match and/or exist. This includes base Ids (aka application Ids), Table Ids, View ids, record Ids, etc.</p></li><li dir="ltr" data-block-id="75b70118-ba94-48bd-843d-5262864ca632"><p dir="ltr" data-block-id="4ef74753-c6cb-48a6-b6e0-2e35edba53fc">Example: Let’s say you have a base that includes Table A and Table B. Further, Table A includes View 1 whereas Table B includes View 2. If you make a request to the <a href="//airtable.com/developers/web/api/list-records" target="_blank" translate="no">List records</a> endpoint with Table A but use View 2 as a parameter, the request will error because View 2 does not belong to Table A.</p></li></ul></li><li data-block-id="23ac704a-bcb4-4aa6-a38f-c6b48d49e6fa"><p dir="ltr" data-block-id="ea6671b6-8a4f-4f40-b974-ee0658cf55c3">The 422 error may also occur when adding single-select or multiple-select field values using "typecast" without <a href="//support.airtable.com/docs/airtable-permissions-overview#:~:text=Field%20actions,-Owner/Creator" target="_blank" translate="yes">creator permissions</a> on a base.</p></li></ul></li><li dir="ltr" data-block-id="fcb223c7-12be-4e68-8c4f-cd6ea0e79c7a"><p dir="ltr" data-block-id="b7cdfe55-2035-412d-a292-8fd029e88e94"><strong>429 error: too_many_requests</strong></p><ul dir="ltr" data-block-id="6d84b8d3-5d84-43b8-acd2-d0724c9b4bb1"><li dir="ltr" data-block-id="c90e5fb1-6bd8-4631-9cae-52e348f311a1"><p dir="ltr" data-block-id="37af6b47-bf25-417e-85a6-c32940916cab">Error meaning - The rate limit of 5 requests per base per second was exceeded. You will need to wait 30 seconds before subsequent requests succeed.</p></li><li dir="ltr" data-block-id="319af942-41ea-42d2-8b83-55c928c33643"><p dir="ltr" data-block-id="fac4b8c2-60b6-46d5-85a8-a7c43af53071">Troubleshooting steps - Add timeouts to the code to ensure that it stays under the rate limit.</p></li></ul></li></ul><h2 dir="ltr" data-block-id="3f10daa3-5125-4bf7-9e0d-63e083f514c0">Server error codes</h2><p dir="ltr" data-block-id="f789231c-3464-4f19-a1cc-01e3f7d2b2d6">These errors generally represent an error on our side. In the event of a 5xx error code, detailed information about the error will be automatically recorded, and Airtable's developers will be notified. You can check our <a href="//status.airtable.com/" target="_blank" translate="no">Status Page</a> to see if there may be a reported incident at the time you received this error. If you receive any 500 error when there is no reported incident or downtime, please <a href="/docs/airtable-api-common-troubleshooting#support-interaction-guidance" target="_self" translate="yes">follow the guidance listed here</a>.</p><ul dir="ltr" data-block-id="48e9d398-96eb-4e33-a072-afa3fa5784e5"><li dir="ltr" data-block-id="ac18c687-eb8a-44da-952a-a1c225b8c04c"><p dir="ltr" data-block-id="9565292e-2a4e-4bb6-9d33-50d929de9627"><strong>500 Internal Server Error</strong> - The server encountered an unexpected condition.</p></li><li dir="ltr" data-block-id="c15532a5-cd86-4068-adf2-4303357f3c6f"><p dir="ltr" data-block-id="994eb80a-d1a8-4ac4-970e-16b9fa276c9c"><strong>502 Bad Gateway</strong> - Airtable's servers are restarting or an unexpected outage is in progress. You should generally not receive this error, and requests are safe to retry.</p></li><li dir="ltr" data-block-id="f85bd194-b64b-4c58-894c-4e8caa751076"><p dir="ltr" data-block-id="ee4b67ea-6233-4877-8343-7e4a8d11142d"><strong>503 Service Unavailable</strong> - The server could not process your request in time. The server could be temporarily unavailable, or it could have timed out processing your request. You should retry the request with backoffs.</p></li></ul><h2 dir="ltr" data-block-id="7f185cd7-53e0-4a5a-a0f0-f0afc415056a">Example error responses</h2><div class="solvvy-solution"><div class="details-wrapper details-wrapper_rendered" data-type="details-wrapper"><details data-opened="true"><summary><p dir="ltr" data-block-id="17cf7e58-e966-4b17-bd66-3071ec280383">403 - You don't have the right permission for the resource, or the resource was not found</p></summary><div data-type="details-content"><p dir="ltr" data-block-id="195e3dc8-d974-41d7-9696-92b625d91814">Check that both you and the token have access to the resource. For example, to access a base using a personal access token, your user must be a collaborator and the token must also have access to the base. <a href="//airtable.com/developers/web/api/authentication#scopes-and-resources-access" target="_blank" translate="no">See this guide</a> for more details.</p><pre dir="ltr" data-block-id="9efbd134-a611-4590-9f72-167ada388d89" language="plainText" data-custom-title="Custom" class="language-plainText"><code class="language-plainText" spellcheck="false">403 Forbidden "error": { "type": "INVALID_PERMISSIONS_OR_MODEL_NOT_FOUND", "message": "Invalid permissions, or the requested model was not found. Check that both your user and your token have the required permissions, and that the model names and/or ids are correct." }</code></pre><p dir="ltr" data-block-id="38d0e718-f56c-4982-8c40-37bb85764a6d">You don't have permission to create records in the given table. This is returned both when creating records directly, and when creating linked records while updating cell values. Check whether <a href="/docs/using-field-and-table-editing-permissions" target="_self" translate="no">the table or any fields you are setting values for have editing permissions</a> limited.</p><pre dir="ltr" data-block-id="c40a424e-aaa0-4a36-8220-1ea48033be5d" language="plainText" data-custom-title="Custom" class="language-plainText"><code class="language-plainText" spellcheck="false">403 Forbidden "error": { "type": "INVALID_PERMISSIONS", "message": "You are not permitted to create records in table TABLE_NAME (TABLE_ID)" }</code></pre><pre dir="ltr" data-block-id="75e382ec-adb0-4ccc-b148-05e766436bd1" language="plainText" data-custom-title="Custom" class="language-plainText"><code class="language-plainText" spellcheck="false">403 Forbidden "error": { "type": "INVALID_PERMISSIONS", "message": "You are not permitted to write cell values in field FIELD_NAME (FIELD_ID)" }</code></pre><p dir="ltr" data-block-id="b73fa683-b7fc-4c52-ad83-365c1213c563">You don't have the right permission for the action.</p><pre dir="ltr" data-block-id="6c12e4fd-f750-4ce1-9e9d-4953d04a8889" language="plainText" data-custom-title="Custom" class="language-plainText"><code class="language-plainText" spellcheck="false">403 Forbidden "error": { "type": "INVALID_PERMISSIONS", "message": "You are not permitted to perform this operation" }</code></pre></div></details><button class="details-arrow" type="details"/></div><button class="details-arrow" data-display="block"/><button class="details-arrow" data-display="block"/><div class="details-wrapper details-wrapper_rendered" data-type="details-wrapper"><details data-opened="true"><summary><p dir="ltr" data-block-id="0189aeab-ff75-4234-89fa-83cfd278c770">404 - The path is not valid</p></summary><div data-type="details-content"><pre dir="ltr" data-block-id="80a1475d-68b2-418c-a8ef-837ae279501f" language="plainText" data-custom-title="Custom" class="language-plainText"><code class="language-plainText" spellcheck="false">404 Not Found "error": "NOT_FOUND" }</code></pre><pre dir="ltr" data-block-id="8f4cf596-d1ad-451e-a856-801b327ad41a" language="plainText" data-custom-title="Custom" class="language-plainText"><code class="language-plainText" spellcheck="false">404 Not Found "error": { "type": "NOT_FOUND" }</code></pre></div></details><button class="details-arrow" type="details"/></div><button class="details-arrow" data-display="block"/><button class="details-arrow" data-display="block"/><div class="details-wrapper details-wrapper_rendered" data-type="details-wrapper"><details data-opened="true"><summary><p dir="ltr" data-block-id="e7b8d887-97ce-4bc8-a426-054325d491f8">422 - The path is correct, however, the body is either not understood or not permitted</p></summary><div data-type="details-content"><pre dir="ltr" data-block-id="e4d85cfe-994a-4be3-af81-b624e329c41e" language="plainText" data-custom-title="Custom" class="language-plainText"><code class="language-plainText" spellcheck="false">422 Unprocessable Entity "error": { "type": "INVALID_REQUEST_UNKNOWN", "message": "Invalid request: parameter validation failed. Check your request data." }</code></pre></div></details><button class="details-arrow" type="details"/></div><button class="details-arrow" data-display="block"/><button class="details-arrow" data-display="block"/><div class="details-wrapper details-wrapper_rendered" data-type="details-wrapper"><details data-opened="true"><summary><p dir="ltr" data-block-id="b18cf976-f380-48ad-bd6c-f4ddb09663cc">503 - The server is temporarily unavailable and the request should be retried</p></summary><div data-type="details-content"><p dir="ltr" data-block-id="799707dd-7342-4c0e-a761-c30cfdf7204e">The Retry-After header may be provided.</p><pre dir="ltr" data-block-id="20fb74ba-006e-47ea-b202-09fc56d7a4d9" language="plainText" data-custom-title="Custom" class="language-plainText"><code class="language-plainText" spellcheck="false">503 Service Unavailable