{"id":7790,"date":"2026-05-17T06:20:59","date_gmt":"2026-05-17T03:20:59","guid":{"rendered":"http:\/\/mohamed"},"modified":"2026-05-18T15:00:00","modified_gmt":"2026-05-18T12:00:00","slug":"api-error-responses","status":"publish","type":"docs","link":"https:\/\/docs.tawarly.com\/ar\/rise-audit-pro-documentation\/api-webhooks-and-audit-record-management\/api-error-responses\/","title":{"rendered":"API Error Responses"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>API error responses explain why a request failed and how the integration should react.<\/p>\n<h2>Common statuses<\/h2>\n<table>\n<thead>\n<tr>\n<th>Status<\/th>\n<th>Meaning<\/th>\n<th>Typical fix<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>400<\/code><\/td>\n<td>Bad request<\/td>\n<td>Check query parameters.<\/td>\n<\/tr>\n<tr>\n<td><code>401<\/code><\/td>\n<td>Unauthorized<\/td>\n<td>Check API key header.<\/td>\n<\/tr>\n<tr>\n<td><code>403<\/code><\/td>\n<td>Forbidden<\/td>\n<td>Check scope.<\/td>\n<\/tr>\n<tr>\n<td><code>404<\/code><\/td>\n<td>Not found<\/td>\n<td>Check endpoint URL.<\/td>\n<\/tr>\n<tr>\n<td><code>429<\/code><\/td>\n<td>Too many requests<\/td>\n<td>Slow down and retry later.<\/td>\n<\/tr>\n<tr>\n<td><code>500<\/code><\/td>\n<td>Server error<\/td>\n<td>Check server logs and Plugin Health.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Example response<\/h2>\n<pre><code>{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"missing_scope\",\n    \"message\": \"This API key does not have permission to access activity logs.\"\n  }\n}<\/code><\/pre>\n<h2>Handling rule<\/h2>\n<p>Retry only when the error is temporary. Do not repeatedly retry 401, 403, or validation errors without fixing the request.<\/p>","protected":false},"excerpt":{"rendered":"<p>Overview API error responses explain why a request failed and how the integration should react. Common statuses Status Meaning Typical fix 400 Bad request Check query parameters. 401 Unauthorized Check API key header. 403 Forbidden Check scope. 404 Not found Check endpoint URL. 429 Too many requests Slow down and retry later. 500 Server error [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":8292,"menu_order":11,"comment_status":"closed","ping_status":"closed","template":"","doc_tag":[],"doc_badge":[],"class_list":["post-7790","docs","type-docs","status-publish","hentry"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>API Error Responses - Tawarly Ltd<\/title>\n<meta name=\"robots\" content=\"noindex, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta property=\"og:locale\" content=\"ar_AR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"API Error Responses - Tawarly Ltd\" \/>\n<meta property=\"og:description\" content=\"Overview API error responses explain why a request failed and how the integration should react. Common statuses Status Meaning Typical fix 400 Bad request Check query parameters. 401 Unauthorized Check API key header. 403 Forbidden Check scope. 404 Not found Check endpoint URL. 429 Too many requests Slow down and retry later. 500 Server error [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.tawarly.com\/ar\/docs\/rise-audit-pro-documentation\/api-webhooks-and-audit-record-management\/api-error-responses\/\" \/>\n<meta property=\"og:site_name\" content=\"Tawarly Ltd\" \/>\n<meta property=\"article:modified_time\" content=\"2026-05-18T12:00:00+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/docs.tawarly.com\\\/docs\\\/rise-audit-pro-documentation\\\/api-webhooks-and-audit-record-management\\\/api-error-responses\\\/\",\"url\":\"https:\\\/\\\/docs.tawarly.com\\\/docs\\\/rise-audit-pro-documentation\\\/api-webhooks-and-audit-record-management\\\/api-error-responses\\\/\",\"name\":\"API Error Responses - Tawarly Ltd\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docs.tawarly.com\\\/#website\"},\"datePublished\":\"2026-05-17T03:20:59+00:00\",\"dateModified\":\"2026-05-18T12:00:00+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/docs.tawarly.com\\\/docs\\\/rise-audit-pro-documentation\\\/api-webhooks-and-audit-record-management\\\/api-error-responses\\\/#breadcrumb\"},\"inLanguage\":\"ar\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/docs.tawarly.com\\\/docs\\\/rise-audit-pro-documentation\\\/api-webhooks-and-audit-record-management\\\/api-error-responses\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/docs.tawarly.com\\\/docs\\\/rise-audit-pro-documentation\\\/api-webhooks-and-audit-record-management\\\/api-error-responses\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/docs.tawarly.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rise Audit Pro Documentation\",\"item\":\"https:\\\/\\\/docs.tawarly.com\\\/docs\\\/rise-audit-pro-documentation\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"API, Webhooks and Audit Record Management\",\"item\":\"https:\\\/\\\/docs.tawarly.com\\\/docs\\\/rise-audit-pro-documentation\\\/api-webhooks-and-audit-record-management\\\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"API Error Responses\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/docs.tawarly.com\\\/#website\",\"url\":\"https:\\\/\\\/docs.tawarly.com\\\/\",\"name\":\"Tawarly Ltd\",\"description\":\"inspired by the future\",\"publisher\":{\"@id\":\"https:\\\/\\\/docs.tawarly.com\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/docs.tawarly.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"ar\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/docs.tawarly.com\\\/#organization\",\"name\":\"Tawarly Ltd\",\"url\":\"https:\\\/\\\/docs.tawarly.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"ar\",\"@id\":\"https:\\\/\\\/docs.tawarly.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/docs.tawarly.com\\\/wp-content\\\/uploads\\\/2021\\\/03\\\/logo-full.png\",\"contentUrl\":\"https:\\\/\\\/docs.tawarly.com\\\/wp-content\\\/uploads\\\/2021\\\/03\\\/logo-full.png\",\"width\":300,\"height\":81,\"caption\":\"Tawarly Ltd\"},\"image\":{\"@id\":\"https:\\\/\\\/docs.tawarly.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"API Error Responses - Tawarly Ltd","robots":{"index":"noindex","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"og_locale":"ar_AR","og_type":"article","og_title":"API Error Responses - Tawarly Ltd","og_description":"Overview API error responses explain why a request failed and how the integration should react. Common statuses Status Meaning Typical fix 400 Bad request Check query parameters. 401 Unauthorized Check API key header. 403 Forbidden Check scope. 404 Not found Check endpoint URL. 429 Too many requests Slow down and retry later. 500 Server error [&hellip;]","og_url":"https:\/\/docs.tawarly.com\/ar\/docs\/rise-audit-pro-documentation\/api-webhooks-and-audit-record-management\/api-error-responses\/","og_site_name":"Tawarly Ltd","article_modified_time":"2026-05-18T12:00:00+00:00","twitter_card":"summary_large_image","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.tawarly.com\/docs\/rise-audit-pro-documentation\/api-webhooks-and-audit-record-management\/api-error-responses\/","url":"https:\/\/docs.tawarly.com\/docs\/rise-audit-pro-documentation\/api-webhooks-and-audit-record-management\/api-error-responses\/","name":"API Error Responses - Tawarly Ltd","isPartOf":{"@id":"https:\/\/docs.tawarly.com\/#website"},"datePublished":"2026-05-17T03:20:59+00:00","dateModified":"2026-05-18T12:00:00+00:00","breadcrumb":{"@id":"https:\/\/docs.tawarly.com\/docs\/rise-audit-pro-documentation\/api-webhooks-and-audit-record-management\/api-error-responses\/#breadcrumb"},"inLanguage":"ar","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.tawarly.com\/docs\/rise-audit-pro-documentation\/api-webhooks-and-audit-record-management\/api-error-responses\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.tawarly.com\/docs\/rise-audit-pro-documentation\/api-webhooks-and-audit-record-management\/api-error-responses\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.tawarly.com\/"},{"@type":"ListItem","position":2,"name":"Rise Audit Pro Documentation","item":"https:\/\/docs.tawarly.com\/docs\/rise-audit-pro-documentation\/"},{"@type":"ListItem","position":3,"name":"API, Webhooks and Audit Record Management","item":"https:\/\/docs.tawarly.com\/docs\/rise-audit-pro-documentation\/api-webhooks-and-audit-record-management\/"},{"@type":"ListItem","position":4,"name":"API Error Responses"}]},{"@type":"WebSite","@id":"https:\/\/docs.tawarly.com\/#website","url":"https:\/\/docs.tawarly.com\/","name":"Tawarly Ltd","description":"inspired by the future","publisher":{"@id":"https:\/\/docs.tawarly.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.tawarly.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"ar"},{"@type":"Organization","@id":"https:\/\/docs.tawarly.com\/#organization","name":"Tawarly Ltd","url":"https:\/\/docs.tawarly.com\/","logo":{"@type":"ImageObject","inLanguage":"ar","@id":"https:\/\/docs.tawarly.com\/#\/schema\/logo\/image\/","url":"https:\/\/docs.tawarly.com\/wp-content\/uploads\/2021\/03\/logo-full.png","contentUrl":"https:\/\/docs.tawarly.com\/wp-content\/uploads\/2021\/03\/logo-full.png","width":300,"height":81,"caption":"Tawarly Ltd"},"image":{"@id":"https:\/\/docs.tawarly.com\/#\/schema\/logo\/image\/"}}]}},"author_avatar":"https:\/\/secure.gravatar.com\/avatar\/08585f715052565fc38d5f512ef098033f30c14d4c14becefded93819a77543c?s=96&d=mm&r=g","author_name":"mohamed","_links":{"self":[{"href":"https:\/\/docs.tawarly.com\/ar\/wp-json\/wp\/v2\/docs\/7790","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.tawarly.com\/ar\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/docs.tawarly.com\/ar\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/docs.tawarly.com\/ar\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.tawarly.com\/ar\/wp-json\/wp\/v2\/comments?post=7790"}],"version-history":[{"count":1,"href":"https:\/\/docs.tawarly.com\/ar\/wp-json\/wp\/v2\/docs\/7790\/revisions"}],"predecessor-version":[{"id":8222,"href":"https:\/\/docs.tawarly.com\/ar\/wp-json\/wp\/v2\/docs\/7790\/revisions\/8222"}],"up":[{"embeddable":true,"href":"https:\/\/docs.tawarly.com\/ar\/wp-json\/wp\/v2\/docs\/8292"}],"wp:attachment":[{"href":"https:\/\/docs.tawarly.com\/ar\/wp-json\/wp\/v2\/media?parent=7790"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/docs.tawarly.com\/ar\/wp-json\/wp\/v2\/doc_tag?post=7790"},{"taxonomy":"doc_badge","embeddable":true,"href":"https:\/\/docs.tawarly.com\/ar\/wp-json\/wp\/v2\/doc_badge?post=7790"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}