API requests are limited to 120 requests per minute per directory. This limit is designed to support automated workflows, including LLM-powered integrations that manage listings programmatically.If you exceed the rate limit, the API returns a 429 Too Many Requests response. Implement exponential backoff and retry logic to handle this gracefully.
When request validation fails, the API returns a 422 status code with validation error details:
{ "message": "The given data was invalid.", "errors": { "url": [ "The url field is required." ], "category_id": [ "The selected category id is invalid." ] }}
Always check if a listing exists before creating a new one using the /exists endpoint
Use pagination when retrieving large lists of listings
Include custom field values in your listing creation/update requests
Validate category and tag IDs before sending them in requests
Handle rate limiting by implementing exponential backoff for failed requests
Cache directory metadata like categories, tags, and custom fields to reduce API calls
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Directify","colors":{"primary":"#ff9d0f","light":"#ff9d0f","dark":"#ff9d0f"},"favicon":"https://mintcdn.com/directify/YL2HVxj-KgHoTZQe/logo/logo-small.png?fit=max\u0026auto=format\u0026n=YL2HVxj-KgHoTZQe\u0026q=85\u0026s=c979d377abde9b6cbdc478e4104ada0a","logo":{"light":"https://directify.app/images/logo.png","dark":"https://directify.app/images/logo.png","href":"https://directify.app/"},"navbar":{"links":[{"label":"Support","href":"mailto:support@directify.app"}],"primary":{"type":"button","label":"directify.app","href":"https://directify.app"}},"footer":{"socials":{"x":"https://x.com/directifyapp","discord":"https://discord.gg/B9hTD4kAJY","youtube":"https://www.youtube.com/@karakhanyans"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Roadmap","href":"https://directify.productlift.dev/","icon":"book-open-cover"},{"anchor":"Community","href":"https://discord.gg/B9hTD4kAJY","icon":"discord"},{"anchor":"Blog","href":"https://directify.app/blog/","icon":"newspaper"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"directify","hasAudioNarration":false,"actualSubdomain":"directify","customDomains":["docs.directify.app"],"gitSource":{"type":"github","owner":"venelinkochev","repo":"directify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae8ee102e0fe6ef1d99d0e6","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Documentation","count":58},{"language":"default","tag":"API","count":13},{"language":"default","tag":"Directories","count":10},{"language":"default","tag":"Integrations","count":9},{"language":"default","tag":"Listings","count":6},{"language":"default","tag":"AI \u0026 Automation","count":4},{"language":"default","tag":"Paid Submissions","count":3},{"language":"default","tag":"Blog","count":2},{"language":"default","tag":"Categories","count":2},{"language":"default","tag":"Custom Pages/Links","count":2}]},"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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-integration/authentication","slug":"/api-integration/authentication","pageMetadata":{"title":"Directify API Authentication with Sanctum Tokens","icon":"key","description":"Authenticate requests to the Directify REST API using Laravel Sanctum personal access tokens — generate, scope, rotate, and revoke from your account.","href":"/api-integration/authentication"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Authenticate requests to the Directify REST API using Laravel Sanctum personal access tokens — generate, scope, rotate, and revoke from your account.\"\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={code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsx(_components.p,{children:`All API endpoints require authentication using Laravel Sanctum. Include your API token in the Authorization header:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_API_TOKEN`})]}),`\n`]})})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`To get your API token, go to your Directify dashboard and click on `,_jsx(_components.strong,{children:`Settings → API`}),`. Then click on the `,_jsx(_components.strong,{children:`“Key” icon`}),` to generate a new token and copy it.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`base-url`,children:`Base URL`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://directify.app/api`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`rate-limiting`,children:`Rate Limiting`}),`\n`,_jsxs(_components.p,{children:[`API requests are limited to `,_jsx(_components.strong,{children:`120 requests per minute`}),` per directory. This limit is designed to support automated workflows, including LLM-powered integrations that manage listings programmatically.`]}),`\n`,_jsxs(_components.p,{children:[`If you exceed the rate limit, the API returns a `,_jsx(_components.code,{children:`429 Too Many Requests`}),` response. Implement exponential backoff and retry logic to handle this gracefully.`]}),`\n`,_jsx(Heading,{level:`2`,id:`error-responses`,children:`Error Responses`}),`\n`,_jsx(Heading,{level:`3`,id:`validation-errors`,children:`Validation Errors`}),`\n`,_jsx(_components.p,{children:`When request validation fails, the API returns a 422 status code with validation error details:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The given data was invalid.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"The url field is required.\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"category_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"The selected category id is invalid.\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`authentication-errors`,children:`Authentication Errors`}),`\n`,_jsx(_components.p,{children:`When authentication fails, the API returns a 401 status code:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Unauthenticated.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`authorization-errors`,children:`Authorization Errors`}),`\n`,_jsx(_components.p,{children:`When the user doesn’t have access to a directory, the API returns a 403 status code:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"You do not own this directory\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`not-found-errors`,children:`Not Found Errors`}),`\n`,_jsx(_components.p,{children:`When a resource is not found, the API returns a 404 status code:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"No query results for model [App`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\\\\`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`Models`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\\\\`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`Project] 123\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`best-practices`,children:`Best Practices`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Always check if a listing exists`}),` before creating a new one using the `,_jsx(_components.code,{children:`/exists`}),` endpoint`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Use pagination`}),` when retrieving large lists of listings`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Include custom field values`}),` in your listing creation/update requests`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Validate category and tag IDs`}),` before sending them in requests`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Handle rate limiting`}),` by implementing exponential backoff for failed requests`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Cache directory metadata`}),` like categories, tags, and custom fields to reduce API calls`]}),`\n`]})]})}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":"Directify API Authentication with Sanctum Tokens","icon":"key","description":"Authenticate requests to the Directify REST API using Laravel Sanctum personal access tokens — generate, scope, rotate, and revoke from your account.","href":"/api-integration/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Base URL","slug":"base-url","depth":2,"children":[]},{"title":"Rate Limiting","slug":"rate-limiting","depth":2,"children":[]},{"title":"Error Responses","slug":"error-responses","depth":2,"children":[{"title":"Validation Errors","slug":"validation-errors","depth":3,"children":[]},{"title":"Authentication Errors","slug":"authentication-errors","depth":3,"children":[]},{"title":"Authorization Errors","slug":"authorization-errors","depth":3,"children":[]},{"title":"Not Found Errors","slug":"not-found-errors","depth":3,"children":[]}]},{"title":"Best Practices","slug":"best-practices","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"directify","siteName":"Directify","title":"Directify API Authentication with Sanctum Tokens - Directify","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-18T16:00:27.767Z","originalFileLocation":"api-integration/authentication.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Authenticate requests to the Directify REST API using Laravel Sanctum personal access tokens — generate, scope, rotate, and revoke from your account.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Directify\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/directify/mC4GGNgjzVt-BeK3/_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/directify/mC4GGNgjzVt-BeK3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/directify/mC4GGNgjzVt-BeK3/_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/directify/mC4GGNgjzVt-BeK3/_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/directify/mC4GGNgjzVt-BeK3/_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/directify/mC4GGNgjzVt-BeK3/_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/directify/mC4GGNgjzVt-BeK3/_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/directify/mC4GGNgjzVt-BeK3/_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/directify/mC4GGNgjzVt-BeK3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Directify API Authentication with Sanctum Tokens - Directify\">\u003cmeta data-mint-head property=\"og:description\" content=\"Authenticate requests to the Directify REST API using Laravel Sanctum personal access tokens — generate, scope, rotate, and revoke from your account.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Directify\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.directify.app/api-integration/authentication\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://directify.mintlify.site/_mintlify/api/og/v2?division=API\u0026amp;title=Directify+API+Authentication+with+Sanctum+Tokens\u0026amp;description=Authenticate+requests+to+the+Directify+REST+API+using+Laravel+Sanctum+personal+access+tokens+%E2%80%94+generate%2C+scope%2C+rotate%2C+and+revoke+from+your+account.\u0026amp;theme=63a69a65dc732af1e97b6144\u0026amp;signature=84ae2668a35943462dd79e101233ef962ab4525820fb34e2d2f791e98eeef00d\">\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=\"Directify API Authentication with Sanctum Tokens - Directify\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Authenticate requests to the Directify REST API using Laravel Sanctum personal access tokens — generate, scope, rotate, and revoke from your account.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://directify.mintlify.site/_mintlify/api/og/v2?division=API\u0026amp;title=Directify+API+Authentication+with+Sanctum+Tokens\u0026amp;description=Authenticate+requests+to+the+Directify+REST+API+using+Laravel+Sanctum+personal+access+tokens+%E2%80%94+generate%2C+scope%2C+rotate%2C+and+revoke+from+your+account.\u0026amp;theme=63a69a65dc732af1e97b6144\u0026amp;signature=84ae2668a35943462dd79e101233ef962ab4525820fb34e2d2f791e98eeef00d\">\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/directify/mC4GGNgjzVt-BeK3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Directify\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff9d0f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.directify.app/api-integration/authentication\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-integration/authentication.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.directify.app/#organization\",\"name\":\"Directify\",\"url\":\"https://docs.directify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://directify.app/images/logo.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.directify.app#website\",\"name\":\"Directify\",\"url\":\"https://docs.directify.app\",\"publisher\":{\"@id\":\"https://docs.directify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.directify.app/api-integration/authentication#webpage\",\"url\":\"https://docs.directify.app/api-integration/authentication\",\"name\":\"Directify API Authentication with Sanctum Tokens\",\"description\":\"Authenticate requests to the Directify REST API using Laravel Sanctum personal access tokens — generate, scope, rotate, and revoke from your account.\",\"dateModified\":\"2026-05-18T16:00:27.767Z\",\"isPartOf\":{\"@id\":\"https://docs.directify.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.directify.app/api-integration/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.directify.app/api-integration/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Directify\",\"item\":\"https://docs.directify.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Directify API Authentication with Sanctum Tokens\",\"item\":\"https://docs.directify.app/api-integration/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.directify.app/api-integration/authentication#article\",\"headline\":\"Directify API Authentication with Sanctum Tokens\",\"name\":\"Directify API Authentication with Sanctum Tokens\",\"description\":\"Authenticate requests to the Directify REST API using Laravel Sanctum personal access tokens — generate, scope, rotate, and revoke from your account.\",\"url\":\"https://docs.directify.app/api-integration/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://docs.directify.app/api-integration/authentication#webpage\"},\"dateModified\":\"2026-05-18T16:00:27.767Z\",\"publisher\":{\"@id\":\"https://docs.directify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.directify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Directify\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Directify","nav":{"global":{"anchors":[{"anchor":"Roadmap","href":"https://directify.productlift.dev/","icon":"book-open-cover"},{"anchor":"Community","href":"https://discord.gg/B9hTD4kAJY","icon":"discord"},{"anchor":"Blog","href":"https://directify.app/blog/","icon":"newspaper"}]},"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Get Started","pages":[{"title":"Welcome to Directify Documentation","sidebarTitle":"Introduction","href":"/introduction"}]},{"group":"Directories","pages":[{"title":"Create your first no-code directory website with Directify","sidebarTitle":"Create Directory","icon":"folder-plus","href":"/directories/create-directory"},{"title":"Subdomain","sidebarTitle":"Subdomain","icon":"globe","href":"/directories/subdomain"},{"title":"Connect a Custom Domain to Your Directory","sidebarTitle":"Custom domain","icon":"globe","href":"/directories/custom-domain"},{"title":"Getting Your First 100 Visitors","sidebarTitle":"First 100 visitors","icon":"users","href":"/directories/first-100-visitors"},{"title":"Customize Your Directory: Logo, Themes, Templates","sidebarTitle":"Design","icon":"palette","href":"/directories/customize-your-directory"},{"title":"Multilingual Directories","sidebarTitle":"Languages","icon":"language","href":"/directories/languages"},{"title":"Multilingual SEO","sidebarTitle":"Multilingual SEO","icon":"magnifying-glass","href":"/directories/multi-language-seo"},{"title":"Social Links","sidebarTitle":"Social Links","icon":"share-nodes","href":"/directories/social-links"},{"title":"Listings Route","sidebarTitle":"Listings Route","icon":"list-ul","href":"/directories/listings-route"},{"title":"Team","sidebarTitle":"Team","icon":"users","href":"/directories/team"}]},{"group":"Listings","pages":[{"title":"Add listings to your online directory","sidebarTitle":"Add Listing","icon":"folder-plus","href":"/listings/add-listing"},{"title":"Import and Export Directory Listings via CSV","sidebarTitle":"Import and Export","icon":"arrow-down","href":"/listings/import-export"},{"title":"Import Listings from Google Maps","sidebarTitle":"Google Maps Import","icon":"map-location-dot","href":"/listings/google-maps-import"},{"title":"Add Custom Fields to Your Directory Listings","sidebarTitle":"Custom Fields","icon":"file-pen","href":"/listings/custom-fields"},{"title":"Related Articles for Directory Listings","sidebarTitle":"Related Articles","icon":"link","href":"/listings/related-articles"},{"title":"Manage tags for your directory listings","sidebarTitle":"Tags","icon":"hashtag","href":"/listings/tags"}]},{"group":"Categories","pages":[{"title":"Add categories to your directory website","sidebarTitle":"Add Category","icon":"folder-plus","href":"/categories/add-category"},{"title":"Import and Export Directory Categories","sidebarTitle":"Import and Export","icon":"arrow-down","href":"/categories/import-export"}]},{"group":"Integrations","pages":[{"title":"ScreenshotOne Integration","sidebarTitle":"ScreenshotOne","icon":"camera","href":"/integrations/screenshotone"},{"title":"ConvertHub Integration","sidebarTitle":"ConvertHub","icon":"image","href":"/integrations/converthub"},{"title":"OpenAI Integration","sidebarTitle":"OpenAI","icon":"sparkles","href":"/integrations/openai"},{"title":"Claude Integration","sidebarTitle":"Claude (Anthropic)","icon":"sparkles","href":"/integrations/claude"},{"title":"Google Sheets Integration","sidebarTitle":"Google Sheets","icon":"table","href":"/integrations/google-sheets"},{"title":"Webhooks","sidebarTitle":"Webhooks","icon":"webhook","href":"/integrations/webhooks"},{"title":"Google Chrome Extension","sidebarTitle":"Google Chrome Extension","icon":"chrome","href":"/integrations/google-chrome-extension"},{"title":"SEO Bot AI Integration – Automated Directory Blog","sidebarTitle":"SEO Bot AI","icon":"seo-bot-ai","href":"/integrations/seobotai"},{"title":"BlogBuster","sidebarTitle":"BlogBuster","icon":"blogbuster","href":"/integrations/blogbuster"}]},{"group":"Ads","pages":[{"title":"Monetize your directory with strategic ad placements","sidebarTitle":"Manage Ads","icon":"rectangle-ad","href":"/ads/manage-ads"}]},{"group":"Forms","pages":[{"title":"Create custom forms for lead generation","sidebarTitle":"Create Forms","icon":"table-cells","href":"/forms/create-forms"}]},{"group":"Settings","pages":[{"title":"Custom URL Routes for Your Directify Directory","sidebarTitle":"Routes","icon":"route","href":"/settings/routes"},{"title":"Connect Analytics to Your Directory","sidebarTitle":"Analytics","icon":"chart-bar","href":"/settings/analytics"}]},{"group":"Paid Submissions","pages":[{"title":"Stripe Integration for Paid Submissions","sidebarTitle":"Stripe","icon":"stripe","href":"/paid-submissions/stripe"},{"title":"Lemon Squeezy Integration for Paid Submissions","sidebarTitle":"Lemon Squeezy","icon":"lemon","href":"/paid-submissions/lemonsqueezy"},{"title":"Custom Payment Links – PayPal, Razorpay, Stripe","sidebarTitle":"Custom Payment","icon":"credit-card","href":"/paid-submissions/custom-payment"}]},{"group":"Membership","pages":[{"title":"Membership Access – Put Your Directory Behind a Paywall","sidebarTitle":"Membership Access","icon":"lock","href":"/monetization/membership"}]},{"group":"Blog","pages":[{"title":"Add Article to your directory ","sidebarTitle":"Add Article","icon":"file-plus","href":"/blog/add-article"},{"title":"Import and Export Blog Articles","sidebarTitle":"Import and Export","icon":"arrow-down","href":"/blog/import-export"}]},{"group":"Content","pages":[{"title":"Enhanced Markdown Content Syntax","sidebarTitle":"Markdown Content","icon":"markdown","href":"/content/markdown-syntax"}]},{"group":"Custom Pages/Links","pages":[{"title":"Create Custom Pages for Your Directory Website","sidebarTitle":"Pages","icon":"file","href":"/custom-pages/pages"},{"title":"Create Custom Links for Your Directory Website","sidebarTitle":"Links","icon":"link","href":"/custom-pages/links"}]},{"group":"AI \u0026 Automation","pages":[{"title":"Manage Directify with AI \u0026 Automation","icon":"robot","href":"/ai-tools/overview"},{"title":"Connect the MCP Server to Claude, Cursor \u0026 More","icon":"plug","href":"/ai-tools/mcp-server"},{"title":"Directify CLI — Manage Your Directory from the Terminal","icon":"terminal","href":"/ai-tools/cli"},{"title":"Autonomous Directify Agent","icon":"robot","description":"Run a self-managing AI agent that maintains your Directify directory on a schedule — built on OpenClaw and the Directify API.","href":"/ai-tools/agent"}]},{"group":"API","pages":[{"title":"Directify API Authentication with Sanctum Tokens","icon":"key","href":"/api-integration/authentication"},{"title":"Directories","icon":"folder","description":"Manage directories through the Directify API - retrieve all directories owned by the authenticated user.","href":"/api-integration/directories"},{"title":"Languages \u0026 Translations","icon":"language","href":"/api-integration/languages"},{"title":"Listings","icon":"list","href":"/api-integration/projects"},{"title":"Categories","icon":"layer-group","href":"/api-integration/categories"},{"title":"Tags","icon":"tags","href":"/api-integration/tags"},{"title":"Organizers","icon":"building","href":"/api-integration/organizers"},{"title":"Custom Fields API – Directify REST Reference","icon":"sliders","href":"/api-integration/custom-fields"},{"title":"Articles","icon":"newspaper","href":"/api-integration/articles"},{"title":"Custom Pages","icon":"file","href":"/api-integration/pages"},{"title":"Redirects","icon":"arrow-right-arrow-left","href":"/api-integration/redirects"},{"title":"Theme","icon":"palette","href":"/api-integration/theme"},{"title":"API SDK Examples in JavaScript, PHP, and Python","icon":"code","href":"/api-integration/sdk-examples"}]}]}]},"basePath":"","title":"Directify API Authentication with Sanctum Tokens - Directify","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":[],"chunks":[]}