Generates a new signing secret for a webhook endpoint. The old secret stops working immediately. The new secret is returned once — store it securely.
Rotating the secret invalidates the previous secret immediately. Update your webhook verification code with the new secret before processing further events.
Responses
After rotating, update your webhook verification code with the new secret immediately. Any deliveries signed with the old secret will fail verification.
Authorizations
X-API-Key
string
header
required
API key for machine-to-machine authentication
Path Parameters
id
string
required
Webhook endpoint ID
Body
application/json
reason
string
Optional reason or note for this action
Response
Secret rotated
id
string
secret
string
rotated_at
string
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Truthlocks Documentation","colors":{"primary":"#0891B2","light":"#22D3EE","dark":"#0E7490"},"logo":{"light":"https://mintcdn.com/truthlocksinc/PkJzkzSsGZQZDYPt/logo/logo-color-1.png?fit=max\u0026auto=format\u0026n=PkJzkzSsGZQZDYPt\u0026q=85\u0026s=d3040942d78ed2600e1c04a9b652759c","dark":"https://mintcdn.com/truthlocksinc/PkJzkzSsGZQZDYPt/logo/logo-white-1.png?fit=max\u0026auto=format\u0026n=PkJzkzSsGZQZDYPt\u0026q=85\u0026s=f8ceb87cd5f113c6175c18d70bedd2b2"},"favicon":"https://mintcdn.com/truthlocksinc/PkJzkzSsGZQZDYPt/favicon/favicon.ico?fit=max\u0026auto=format\u0026n=PkJzkzSsGZQZDYPt\u0026q=85\u0026s=cc2965c5ff1a69a563d4a90352b4150c","api":{"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["bash","javascript","python","go"],"prefill":false}},"navbar":{"links":[{"href":"https://console.truthlocks.com/auth/sign-in","label":"Sign In"},{"href":"https://console.truthlocks.com/auth/sign-up","label":"Sign Up"},{"href":"https://verify.truthlocks.com","label":"Verify"}],"primary":{"type":"button","label":"Console","href":"https://console.truthlocks.com"}},"seo":{},"contextual":{"options":["copy","view","claude","chatgpt","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":"introduction"},{"language":"es","href":"es/introduction"},{"language":"fr","href":"fr/introduction"},{"language":"pt","href":"pt/introduction"},{"language":"de","href":"de/introduction"},{"language":"ar","href":"ar/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"truthlocksinc","hasAudioNarration":false,"actualSubdomain":"truthlocksinc","customDomains":["docs.truthlocks.com"],"gitSource":{"type":"github","owner":"truthlocks","repo":"truthlock","deployBranch":"main","contentDirectory":"docs-mintlify","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af8f40a5400fbb020670995","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"API Reference","count":211},{"language":"ar","tag":"مرجع API","count":211},{"language":"de","tag":"API-Referenz","count":211},{"language":"es","tag":"Referencia de la API","count":211},{"language":"fr","tag":"Référence API","count":211},{"language":"pt","tag":"Referência da API","count":211},{"language":"en","tag":"Documentation","count":82},{"language":"ar","tag":"الوثائق","count":82},{"language":"de","tag":"Dokumentation","count":82},{"language":"es","tag":"Documentación","count":82},{"language":"fr","tag":"Documentation","count":82},{"language":"pt","tag":"Documentação","count":82},{"language":"en","tag":"Guides","count":26},{"language":"ar","tag":"الأدلة الإرشادية","count":26},{"language":"de","tag":"Anleitungen","count":26},{"language":"es","tag":"Guías","count":26},{"language":"fr","tag":"Guides","count":26},{"language":"pt","tag":"Guias","count":26},{"language":"en","tag":"Consumer (B2C)","count":20},{"language":"ar","tag":"المستهلك (B2C)","count":20},{"language":"de","tag":"Verbraucher (B2C)","count":20},{"language":"es","tag":"Consumidor (B2C)","count":20},{"language":"fr","tag":"Consommateur (B2C)","count":20},{"language":"pt","tag":"Consumidor (B2C)","count":20},{"language":"en","tag":"Billing","count":17},{"language":"ar","tag":"الفوترة","count":17},{"language":"de","tag":"Abrechnung","count":17},{"language":"es","tag":"Facturación","count":17},{"language":"fr","tag":"Facturation","count":17},{"language":"pt","tag":"Faturamento","count":17},{"language":"en","tag":"Receipts","count":13},{"language":"ar","tag":"الإيصالات","count":13},{"language":"de","tag":"Belege","count":13},{"language":"es","tag":"Recibos","count":13},{"language":"fr","tag":"Reçus","count":13},{"language":"pt","tag":"Recibos","count":13},{"language":"en","tag":"Audit \u0026 Logs","count":11},{"language":"ar","tag":"التدقيق والسجلات","count":11},{"language":"de","tag":"Audit \u0026 Protokolle","count":11},{"language":"es","tag":"Auditoría y Registros","count":11},{"language":"fr","tag":"Audit et journaux","count":11},{"language":"pt","tag":"Auditoria e Registros","count":11},{"language":"en","tag":"Attestations","count":10},{"language":"en","tag":"Risk operations","count":10},{"language":"en","tag":"Security","count":10},{"language":"ar","tag":"الإشهادات","count":10},{"language":"ar","tag":"عمليات المخاطر","count":10},{"language":"ar","tag":"الأمان","count":10},{"language":"de","tag":"Bestätigungen","count":10},{"language":"de","tag":"Risikobetrieb","count":10},{"language":"de","tag":"Sicherheit","count":10},{"language":"es","tag":"Atestaciones","count":10},{"language":"es","tag":"Operaciones de riesgo","count":10},{"language":"es","tag":"Seguridad","count":10},{"language":"fr","tag":"Attestations","count":10},{"language":"fr","tag":"Opérations de risque","count":10},{"language":"fr","tag":"Sécurité","count":10},{"language":"pt","tag":"Atestados","count":10},{"language":"pt","tag":"Operações de risco","count":10},{"language":"pt","tag":"Segurança","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"language-layout.css","content":"html[lang=\"ar\"] .prose,html[lang=\"ar\"] #content-area{direction:rtl;text-align:start}html[lang=\"ar\"] pre,html[lang=\"ar\"] code,html[lang=\"ar\"] input[type=\"url\"],html[lang=\"ar\"] input[type=\"email\"]{direction:ltr;unicode-bidi:isolate;text-align:left}"}]}
{"page":{"pagePath":"api-reference/webhooks/rotate-secret","slug":"/api-reference/webhooks/rotate-secret","pageMetadata":{"title":"Rotate endpoint secret","openapi":"mint-openapi.yaml POST /v1/webhooks/endpoints/{id}/rotate","description":"Generates a new signing secret for the webhook endpoint. The old secret is immediately invalidated.","href":"/api-reference/webhooks/rotate-secret"},"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: \"Generates a new signing secret for the webhook endpoint. The old secret is immediately invalidated.\"\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={p:`p`,..._provideComponents(),...props.components},{Heading,Tip,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Generates a new signing secret for a webhook endpoint. The old secret stops working immediately. The new secret is returned once — store it securely.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Rotating the secret invalidates the previous secret immediately. Update your webhook verification code with the new secret before processing further events.`})}),`\n`,_jsx(Heading,{level:`3`,id:`responses`,children:`Responses`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`After rotating, update your webhook verification code with the new secret immediately. Any deliveries signed with the old secret will fail verification.`})})]})}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":"Rotate endpoint secret","openapi":"mint-openapi.yaml POST /v1/webhooks/endpoints/{id}/rotate","description":"Generates a new signing secret for the webhook endpoint. The old secret is immediately invalidated.","href":"/api-reference/webhooks/rotate-secret"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Responses","slug":"responses","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"webhooks.endpoints.rotateSecret","summary":"Rotate webhook secret","description":"Generates a new signing secret for the webhook endpoint. The old secret is immediately invalidated.","tags":["Webhooks"],"security":["6250752b-3f00-4d59-b45e-5ec35e44ba1c"],"parameters":["d6fa9f66-421e-4653-83be-dec72de197b5"],"responses":{"200":"69acd4ce-cb85-4068-ba00-e5bce98ebf53","401":"f025fad4-4eca-484f-b907-7aa0cdea1e35"},"requestBody":"eb4926b5-f25f-4bfe-8a75-12522aecedb5","method":"post","type":"path","servers":["c49d0098-98ca-4287-aa5a-a86c1f160926","ae808410-00e5-4fa4-901a-52c4656b847d"],"path":"/v1/webhooks/endpoints/{id}/rotate","baseUrlOptions":["https://api.truthlocks.com","https://sandbox-api.truthlocks.com"],"title":"Rotate webhook secret","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d6fa9f66-421e-4653-83be-dec72de197b5":{"name":"id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"Webhook endpoint ID","uniqueKey":"","typeLabel":"string"},"description":"Webhook endpoint ID"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"Optional reason or note for this action","uniqueKey":"reason","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"reason":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"69acd4ce-cb85-4068-ba00-e5bce98ebf53":{"description":"Secret rotated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"id","typeLabel":"string"},"secret":{"type":"string","uniqueKey":"secret","typeLabel":"string"},"rotated_at":{"type":"string","uniqueKey":"rotated_at","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","secret":"\u003cstring>","rotated_at":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"f025fad4-4eca-484f-b907-7aa0cdea1e35":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["code","message","http_status"],"properties":{"code":{"type":"string","description":"Machine-readable error code","enum":["AUTH_REQUIRED","AUTH_INVALID","PERMISSION_DENIED","TENANT_IDENTITY_UNVERIFIED","NOT_FOUND","VALIDATION_ERROR","CONFLICT","PAYLOAD_TOO_LARGE","RATE_LIMIT_EXCEEDED","QUOTA_EXCEEDED","SERVICE_UNAVAILABLE","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"http_status":{"type":"integer","description":"HTTP status code","isRequired":true,"uniqueKey":"http_status","typeLabel":"integer"},"retry_after_ms":{"type":"integer","description":"Milliseconds to wait before retrying (for rate limits)","uniqueKey":"retry_after_ms","typeLabel":"integer"},"details":{"type":"object","description":"Additional error context","uniqueKey":"details","typeLabel":"object"}},"example":{"code":"AUTH_REQUIRED","message":"Authentication required","http_status":401},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"AUTH_REQUIRED","message":"Authentication required","http_status":401}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"6250752b-3f00-4d59-b45e-5ec35e44ba1c":{"APIKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for machine-to-machine authentication","scopes":[],"schemeName":"APIKey"}}},"servers":{"c49d0098-98ca-4287-aa5a-a86c1f160926":{"url":"https://api.truthlocks.com","description":"Production API"},"ae808410-00e5-4fa4-901a-52c4656b847d":{"url":"https://sandbox-api.truthlocks.com","description":"Sandbox Environment"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for machine-to-machine authentication","scopes":[],"schemeName":"APIKey"},"schema":{"title":"X-API-Key","type":"string","description":"API key for machine-to-machine authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKey","name":"X-API-Key"}],"title":"APIKey"}]},"originalFileLocation":"mint-openapi.yaml"},"subdomain":"truthlocksinc","siteName":"Truthlocks Documentation","title":"Rotate endpoint secret - Truthlocks Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/webhooks/rotate-secret","matchLevel":0},"es":{"href":"/es/api-reference/webhooks/rotate-secret","matchLevel":1},"fr":{"href":"/fr/api-reference/webhooks/rotate-secret","matchLevel":1},"pt":{"href":"/pt/api-reference/webhooks/rotate-secret","matchLevel":1},"de":{"href":"/de/api-reference/webhooks/rotate-secret","matchLevel":1},"ar":{"href":"/ar/api-reference/webhooks/rotate-secret","matchLevel":1}}},"lastModified":"2026-10-08T22:28:01.237Z","originalFileLocation":"api-reference/webhooks/rotate-secret.mdx","locale":"en"},"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=\"Generates a new signing secret for the webhook endpoint. The old secret is immediately invalidated.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Truthlocks Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/truthlocksinc/dNvuhXtiqGjMato4/_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/truthlocksinc/dNvuhXtiqGjMato4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/truthlocksinc/dNvuhXtiqGjMato4/_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/truthlocksinc/dNvuhXtiqGjMato4/_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/truthlocksinc/dNvuhXtiqGjMato4/_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/truthlocksinc/dNvuhXtiqGjMato4/_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/truthlocksinc/dNvuhXtiqGjMato4/_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/truthlocksinc/dNvuhXtiqGjMato4/_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/truthlocksinc/dNvuhXtiqGjMato4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Rotate endpoint secret - Truthlocks Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generates a new signing secret for the webhook endpoint. The old secret is immediately invalidated.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Truthlocks Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://truthlocksinc.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Rotate+endpoint+secret\u0026amp;description=Generates+a+new+signing+secret+for+the+webhook+endpoint.+The+old+secret+is+immediately+invalidated.\u0026amp;theme=1b6a6b03c74bcbd5bff803f5\u0026amp;signature=2e1bb8fe26fccb059db63087699ff6c1367e4d1f45b3187316e8a5267d002390\">\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=\"Rotate endpoint secret - Truthlocks Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generates a new signing secret for the webhook endpoint. The old secret is immediately invalidated.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://truthlocksinc.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Rotate+endpoint+secret\u0026amp;description=Generates+a+new+signing+secret+for+the+webhook+endpoint.+The+old+secret+is+immediately+invalidated.\u0026amp;theme=1b6a6b03c74bcbd5bff803f5\u0026amp;signature=2e1bb8fe26fccb059db63087699ff6c1367e4d1f45b3187316e8a5267d002390\">\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/truthlocksinc/dNvuhXtiqGjMato4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Truthlocks Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0891B2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/webhooks/rotate-secret.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.truthlocks.com/es/api-reference/webhooks/rotate-secret\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.truthlocks.com/fr/api-reference/webhooks/rotate-secret\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt\" href=\"https://docs.truthlocks.com/pt/api-reference/webhooks/rotate-secret\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.truthlocks.com/de/api-reference/webhooks/rotate-secret\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.truthlocks.com/ar/api-reference/webhooks/rotate-secret\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.truthlocks.com/#organization\",\"name\":\"Truthlocks Documentation\",\"url\":\"https://docs.truthlocks.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/truthlocksinc/PkJzkzSsGZQZDYPt/logo/logo-color-1.png?fit=max\u0026auto=format\u0026n=PkJzkzSsGZQZDYPt\u0026q=85\u0026s=d3040942d78ed2600e1c04a9b652759c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.truthlocks.com#website\",\"name\":\"Truthlocks Documentation\",\"url\":\"https://docs.truthlocks.com\",\"publisher\":{\"@id\":\"https://docs.truthlocks.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret#webpage\",\"url\":\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret\",\"name\":\"Rotate endpoint secret\",\"description\":\"Generates a new signing secret for the webhook endpoint. The old secret is immediately invalidated.\",\"dateModified\":\"2026-10-08T22:28:01.237Z\",\"isPartOf\":{\"@id\":\"https://docs.truthlocks.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Webhooks\",\"item\":\"https://docs.truthlocks.com/api-reference/webhooks/create-endpoint\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rotate endpoint secret\",\"item\":\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret#apireference\",\"headline\":\"Rotate endpoint secret\",\"name\":\"Rotate endpoint secret\",\"description\":\"Generates a new signing secret for the webhook endpoint. The old secret is immediately invalidated.\",\"url\":\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret\",\"mainEntityOfPage\":{\"@id\":\"https://docs.truthlocks.com/api-reference/webhooks/rotate-secret#webpage\"},\"dateModified\":\"2026-10-08T22:28:01.237Z\",\"publisher\":{\"@id\":\"https://docs.truthlocks.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.truthlocks.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Truthlocks Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Truthlocks Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/webhooks/rotate-secret.md","siteName":"Truthlocks Documentation","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Attestations","pages":[{"title":"Mint Attestation","openapi":"mint-openapi.yaml POST /v1/attestations/mint","href":"/api-reference/attestations/mint"},{"title":"List Attestations","openapi":"mint-openapi.yaml GET /v1/attestations","href":"/api-reference/attestations/list"},{"title":"Get Attestation","openapi":"mint-openapi.yaml GET /v1/attestations/{id}","href":"/api-reference/attestations/get"},{"title":"Revoke Attestation","openapi":"mint-openapi.yaml POST /v1/attestations/{id}/revoke","href":"/api-reference/attestations/revoke"},{"title":"Supersede Attestation","openapi":"mint-openapi.yaml POST /v1/attestations/{id}/supersede","href":"/api-reference/attestations/supersede"},{"title":"Get Proof Bundle","openapi":"mint-openapi.yaml GET /v1/attestations/{id}/proof-bundle","href":"/api-reference/attestations/proof-bundle"},{"title":"Get QR Code","openapi":"mint-openapi.yaml GET /v1/attestations/{id}/qr","href":"/api-reference/attestations/qr-code"},{"title":"Get Barcode","openapi":"mint-openapi.yaml GET /v1/attestations/{id}/barcode","href":"/api-reference/attestations/barcode"},{"title":"Batch Generate Codes","openapi":"mint-openapi.yaml POST /v1/attestations/codes/batch","href":"/api-reference/attestations/batch-codes"},{"title":"Mint through the collection route","openapi":"mint-openapi.yaml POST /v1/attestations","href":"/api-reference/attestations/mint-alias"}]},{"group":"Receipts","pages":[{"title":"Mint Receipt","openapi":"mint-openapi.yaml POST /v1/receipts","href":"/api-reference/receipts/mint"},{"title":"List Receipts","openapi":"mint-openapi.yaml GET /v1/receipts","href":"/api-reference/receipts/list"},{"title":"Get Receipt","openapi":"mint-openapi.yaml GET /v1/receipts/{id}","href":"/api-reference/receipts/get"},{"title":"Revoke Receipt","openapi":"mint-openapi.yaml POST /v1/receipts/{id}/revoke","href":"/api-reference/receipts/revoke"},{"title":"List receipt types","openapi":"mint-openapi.yaml GET /v1/receipt-types","href":"/api-reference/receipts/list-types"},{"title":"Get receipt type","openapi":"mint-openapi.yaml GET /v1/receipt-types/{name}","href":"/api-reference/receipts/get-type"},{"title":"Create Receipt Type","openapi":"mint-openapi.yaml POST /v1/receipt-types","href":"/api-reference/receipts/create-type"},{"title":"Set Signing Policy","openapi":"mint-openapi.yaml POST /v1/receipt-types/{name}/signing-policy","href":"/api-reference/receipts/signing-policy"},{"title":"Receipt Proof Bundle","openapi":"mint-openapi.yaml GET /v1/receipts/{id}/proof-bundle","href":"/api-reference/receipts/proof-bundle"},{"title":"Verify Receipt","openapi":"mint-openapi.yaml POST /v1/receipts/verify","href":"/api-reference/receipts/verify"},{"title":"Search Receipts","openapi":"mint-openapi.yaml POST /v1/receipts/search","href":"/api-reference/receipts/search"},{"title":"Export Receipts","openapi":"mint-openapi.yaml POST /v1/receipts/export","href":"/api-reference/receipts/export"},{"title":"Redact Receipt","openapi":"mint-openapi.yaml POST /v1/receipts/{id}/redact","href":"/api-reference/receipts/redact"}]},{"group":"Risk Evaluation","pages":[{"title":"Risk Evaluate","openapi":"mint-openapi.yaml POST /v1/risk/evaluate","href":"/api-reference/risk/evaluate"}]},{"group":"Risk Signals","pages":[{"title":"Ingest Risk Signal","openapi":"mint-openapi.yaml POST /v1/risk/signals","href":"/api-reference/risk/ingest-signal"},{"title":"List risk signals","openapi":"mint-openapi.yaml GET /v1/risk/signals","href":"/api-reference/risk-signals/list"},{"title":"Get risk signal","openapi":"mint-openapi.yaml GET /v1/risk/signals/{id}","href":"/api-reference/risk-signals/get"},{"title":"Normalize Identity Event","openapi":"mint-openapi.yaml POST /v1/risk/events","href":"/api-reference/risk/normalize-event"},{"title":"Deepfake \u0026 impersonation scan","openapi":"mint-openapi.yaml POST /v1/risk/deepfake/scan","href":"/api-reference/risk/deepfake-scan"},{"title":"Get deepfake scan results","openapi":"mint-openapi.yaml GET /v1/risk/deepfake/results/{subject_ref}","href":"/api-reference/risk/deepfake-results"}]},{"group":"Account Takeover","pages":[{"title":"Evaluate ATO risk","openapi":"mint-openapi.yaml POST /v1/risk/ato/evaluate","href":"/api-reference/risk/ato-evaluate"},{"title":"Get ATO profile","openapi":"mint-openapi.yaml GET /v1/risk/ato/profile/{subject_id}","href":"/api-reference/risk/ato-profile"},{"title":"List ATO alerts","openapi":"mint-openapi.yaml GET /v1/risk/ato/alerts","href":"/api-reference/risk/ato-alerts"}]},{"group":"Velocity Scoring","pages":[{"title":"Record velocity action","openapi":"mint-openapi.yaml POST /v1/risk/velocity/record","href":"/api-reference/risk/velocity-record"},{"title":"Get velocity windows","openapi":"mint-openapi.yaml GET /v1/risk/velocity/{subject_id}","href":"/api-reference/risk/velocity-windows"},{"title":"List velocity anomalies","openapi":"mint-openapi.yaml GET /v1/risk/velocity","href":"/api-reference/risk/velocity-anomalies"}]},{"group":"Verification","pages":[{"title":"Verify Attestation","openapi":"mint-openapi.yaml POST /v1/verify","href":"/api-reference/verify"}]},{"group":"Verification Packs","pages":[{"title":"List Verification Packs","openapi":"mint-openapi.yaml GET /v1/attestation-packs","href":"/api-reference/verification-packs/list"},{"title":"Get Verification Pack","openapi":"mint-openapi.yaml GET /v1/attestation-packs/{id}","href":"/api-reference/verification-packs/get"},{"title":"Create Verification Pack","openapi":"mint-openapi.yaml POST /v1/attestation-packs","href":"/api-reference/verification-packs/create"},{"title":"Update Verification Pack","openapi":"mint-openapi.yaml PUT /v1/attestation-packs/{id}","href":"/api-reference/verification-packs/update"},{"title":"Update Pack Status","openapi":"mint-openapi.yaml PUT /v1/attestation-packs/{id}/status","href":"/api-reference/verification-packs/update-status"}]},{"group":"Issuers","pages":[{"title":"Create Issuer","openapi":"mint-openapi.yaml POST /v1/issuers","href":"/api-reference/issuers/create"},{"title":"List Issuers","openapi":"mint-openapi.yaml GET /v1/issuers","href":"/api-reference/issuers/list"},{"title":"Get Issuer","openapi":"mint-openapi.yaml GET /v1/issuers/{id}","href":"/api-reference/issuers/get"},{"title":"Create or Register an Issuer Key","openapi":"mint-openapi.yaml POST /v1/issuers/{id}/keys","href":"/api-reference/issuers/keys"},{"title":"List Issuer Events","openapi":"mint-openapi.yaml GET /v1/issuers/{id}/events","href":"/api-reference/issuers/events"},{"title":"Rotate Key","openapi":"mint-openapi.yaml POST /v1/issuers/keys/{kid}/rotate","href":"/api-reference/issuers/keys-rotate"},{"title":"Report Key Compromise","openapi":"mint-openapi.yaml POST /v1/issuers/keys/{kid}/compromise","href":"/api-reference/issuers/keys-compromise"},{"title":"List issuer signing keys","openapi":"mint-openapi.yaml GET /v1/issuers/{id}/keys","href":"/api-reference/issuers/list-keys"}]},{"group":"API Keys","pages":[{"title":"List API Keys","openapi":"mint-openapi.yaml GET /v1/api-keys","href":"/api-reference/api-keys/list"},{"title":"Create API Key","openapi":"mint-openapi.yaml POST /v1/api-keys","href":"/api-reference/api-keys/create"},{"title":"Revoke API Key","openapi":"mint-openapi.yaml POST /v1/api-keys/{id}/revoke","href":"/api-reference/api-keys/revoke"},{"title":"Revoke an API key","openapi":"mint-openapi.yaml DELETE /v1/api-keys/{id}","href":"/api-reference/api-keys/delete"}]},{"group":"Policies","pages":[{"title":"Create policy","openapi":"mint-openapi.yaml POST /v1/policies","href":"/api-reference/policies/create"},{"title":"List policies","openapi":"mint-openapi.yaml GET /v1/policies","href":"/api-reference/policies/list"},{"title":"Evaluate policy","openapi":"mint-openapi.yaml POST /v1/policies/evaluate","href":"/api-reference/policies/evaluate"},{"title":"Delete policy","openapi":"mint-openapi.yaml DELETE /v1/policies/{id}","href":"/api-reference/policies/delete"}]},{"group":"Issuer Applications","pages":[{"title":"Create application","openapi":"mint-openapi.yaml POST /v1/issuer-applications","href":"/api-reference/issuer-applications/create"},{"title":"List applications","openapi":"mint-openapi.yaml GET /v1/issuer-applications","href":"/api-reference/issuer-applications/list"},{"title":"Get application","openapi":"mint-openapi.yaml GET /v1/issuer-applications/{id}","href":"/api-reference/issuer-applications/get"},{"title":"Submit application","openapi":"mint-openapi.yaml POST /v1/issuer-applications/{id}/submit","href":"/api-reference/issuer-applications/submit"}]},{"group":"Identity \u0026 Access","pages":[{"title":"Invite User","openapi":"mint-openapi.yaml POST /v1/users","href":"/api-reference/users/invite"},{"title":"List Organizations","openapi":"mint-openapi.yaml GET /v1/orgs","href":"/api-reference/identity/orgs"},{"title":"Get Organization","openapi":"mint-openapi.yaml GET /v1/orgs/{id}","href":"/api-reference/identity/orgs/get"},{"title":"Manage Roles","openapi":"mint-openapi.yaml GET /v1/roles","href":"/api-reference/identity/roles"},{"title":"Create custom role","openapi":"mint-openapi.yaml POST /v1/roles","href":"/api-reference/identity/create-role"},{"title":"Assign role","openapi":"mint-openapi.yaml POST /v1/role-bindings","href":"/api-reference/identity/assign-role"},{"title":"List workspace users","openapi":"mint-openapi.yaml GET /v1/users","href":"/api-reference/users/list"}]},{"group":"Webhooks","pages":[{"title":"Create webhook endpoint","openapi":"mint-openapi.yaml POST /v1/webhooks/endpoints","href":"/api-reference/webhooks/create-endpoint"},{"title":"List webhook endpoints","openapi":"mint-openapi.yaml GET /v1/webhooks/endpoints","description":"Returns all configured webhook endpoints for the authenticated tenant.","href":"/api-reference/webhooks/list-endpoints"},{"title":"Rotate endpoint secret","openapi":"mint-openapi.yaml POST /v1/webhooks/endpoints/{id}/rotate","href":"/api-reference/webhooks/rotate-secret"},{"title":"List deliveries","openapi":"mint-openapi.yaml GET /v1/webhooks/endpoints/{id}/deliveries","description":"Returns delivery history for a webhook endpoint.","href":"/api-reference/webhooks/list-deliveries"},{"title":"Send test delivery","openapi":"mint-openapi.yaml POST /v1/webhooks/test-delivery","href":"/api-reference/webhooks/test-delivery"}]},{"group":"Audit \u0026 Logs","pages":[{"title":"Query Audit Events","openapi":"mint-openapi.yaml GET /v1/audit","href":"/api-reference/audit/query"},{"title":"Request audit export","openapi":"mint-openapi.yaml POST /v1/audit/exports","href":"/api-reference/audit/export"},{"title":"Get retention policy","openapi":"mint-openapi.yaml GET /v1/audit/retention","href":"/api-reference/audit/retention-get"},{"title":"Update retention policy","openapi":"mint-openapi.yaml PUT /v1/audit/retention","href":"/api-reference/audit/retention-update"},{"title":"Create SIEM destination","openapi":"mint-openapi.yaml POST /v1/audit/siem","href":"/api-reference/audit/siem/create"},{"title":"List SIEM destination","openapi":"mint-openapi.yaml GET /v1/audit/siem","href":"/api-reference/audit/siem/list"},{"title":"Update SIEM destination","openapi":"mint-openapi.yaml PUT /v1/audit/siem/{id}","href":"/api-reference/audit/siem/update"},{"title":"Delete SIEM destination","openapi":"mint-openapi.yaml DELETE /v1/audit/siem/{id}","href":"/api-reference/audit/siem/delete"},{"title":"Create risk-event export","openapi":"mint-openapi.yaml POST /v1/risk/siem/export","href":"/api-reference/risk/exports/create"},{"title":"Read risk-event export","openapi":"mint-openapi.yaml GET /v1/risk/siem/export/{id}","href":"/api-reference/risk/exports/get"},{"title":"Delete risk-event export","openapi":"mint-openapi.yaml DELETE /v1/risk/siem/export/{id}","href":"/api-reference/risk/exports/delete"}]},{"group":"Consumer (B2C)","pages":[{"title":"Consumer Signup","openapi":"mint-openapi.yaml POST /v1/consumer/signup","href":"/api-reference/consumer/signup"},{"title":"Consumer Login","openapi":"mint-openapi.yaml POST /v1/consumer/login","href":"/api-reference/consumer/login"},{"title":"Consumer Inbox","openapi":"mint-openapi.yaml GET /v1/consumer/inbox","href":"/api-reference/consumer/inbox"},{"title":"Deliver to Consumer Inbox","openapi":"mint-openapi.yaml POST /v1/consumer/inbox/deliver","href":"/api-reference/consumer/deliver"},{"title":"Protect Content (Consumer Mint)","openapi":"mint-openapi.yaml POST /v1/consumer/mint","href":"/api-reference/consumer/mint"},{"title":"List Protections","openapi":"mint-openapi.yaml GET /v1/consumer/protections","href":"/api-reference/consumer/protections"},{"title":"Update protection visibility","openapi":"mint-openapi.yaml PUT /v1/consumer/protections/{id}/visibility","href":"/api-reference/consumer/update-visibility"},{"title":"Content similarity check","openapi":"mint-openapi.yaml GET /v1/consumer/similarity","href":"/api-reference/consumer/similarity"},{"title":"Get Proof Page Metadata","openapi":"mint-openapi.yaml GET /v1/public/proof/{attestation_id}","href":"/api-reference/consumer/proof-metadata"},{"title":"Public Portfolio","openapi":"mint-openapi.yaml GET /v1/consumer/portfolio/{username}","href":"/api-reference/consumer/portfolio"},{"title":"Get consumer profile","openapi":"mint-openapi.yaml GET /v1/consumer/me","href":"/api-reference/consumer/profile"},{"title":"Claim a portfolio username","openapi":"mint-openapi.yaml PUT /v1/consumer/me/username","href":"/api-reference/consumer/username"},{"title":"Update consumer profile","openapi":"mint-openapi.yaml PUT /v1/consumer/me","href":"/api-reference/consumer/profile-update"},{"title":"Consumer Stats","openapi":"mint-openapi.yaml GET /v1/consumer/stats","href":"/api-reference/consumer/stats"},{"title":"List consumer API keys","openapi":"mint-openapi.yaml GET /v1/consumer/api-keys","href":"/api-reference/consumer/api-keys/list"},{"title":"Create consumer API key","openapi":"mint-openapi.yaml POST /v1/consumer/api-keys","href":"/api-reference/consumer/api-keys/create"},{"title":"Revoke consumer API key","openapi":"mint-openapi.yaml POST /v1/consumer/api-keys/{id}/revoke","href":"/api-reference/consumer/api-keys/revoke"},{"title":"Request data export","openapi":"mint-openapi.yaml POST /v1/consumer/privacy/export","href":"/api-reference/consumer/privacy/export"},{"title":"Request account deletion","openapi":"mint-openapi.yaml POST /v1/consumer/privacy/delete-account","href":"/api-reference/consumer/privacy/delete-account"},{"title":"List privacy jobs","openapi":"mint-openapi.yaml GET /v1/consumer/privacy/jobs","href":"/api-reference/consumer/privacy/jobs"}]},{"group":"Billing","pages":[{"title":"Get billing configuration","openapi":"mint-openapi.yaml GET /v1/billing/config","href":"/api-reference/billing/config"},{"title":"Get billing status","openapi":"mint-openapi.yaml GET /v1/billing/status","href":"/api-reference/billing/status"},{"title":"Get entitlements","openapi":"mint-openapi.yaml GET /v1/billing/entitlements","href":"/api-reference/billing/entitlements"},{"title":"Get usage","openapi":"mint-openapi.yaml GET /v1/billing/usage","href":"/api-reference/billing/usage"},{"title":"Accepted usage and monthly invoices","openapi":"mint-openapi.yaml GET /v1/billing/usage-settlements","href":"/api-reference/billing/usage-settlements"},{"title":"List plans","openapi":"mint-openapi.yaml GET /v1/billing/plans","href":"/api-reference/billing/plans"},{"title":"Get rates","openapi":"mint-openapi.yaml GET /v1/billing/rates","href":"/api-reference/billing/rates"},{"title":"Estimate plan cost","openapi":"mint-openapi.yaml POST /v1/billing/estimate","href":"/api-reference/billing/estimate"},{"title":"Projected invoice","openapi":"mint-openapi.yaml POST /v1/billing/projected-invoice","href":"/api-reference/billing/projected-invoice"},{"title":"Create checkout session","openapi":"mint-openapi.yaml POST /v1/billing/checkout","href":"/api-reference/billing/checkout"},{"title":"Get subscription","openapi":"mint-openapi.yaml GET /v1/billing/subscription","href":"/api-reference/billing/subscription"},{"title":"Cancel subscription","openapi":"mint-openapi.yaml POST /v1/billing/cancel","href":"/api-reference/billing/cancel"},{"title":"Open payment-method portal","openapi":"mint-openapi.yaml POST /v1/billing/portal","href":"/api-reference/billing/portal"},{"title":"Attach an add-on","openapi":"mint-openapi.yaml POST /v1/billing/addons/attach","href":"/api-reference/billing/addons"},{"title":"Detach an add-on","openapi":"mint-openapi.yaml POST /v1/billing/addons/detach","href":"/api-reference/billing/addons-detach"},{"title":"List invoices","openapi":"mint-openapi.yaml GET /v1/billing/invoices","href":"/api-reference/billing/invoices"},{"title":"Export accounting records","openapi":"mint-openapi.yaml GET /v1/billing/exports/accounting","href":"/api-reference/billing/accounting-export"}]},{"group":"Machine Agents","pages":[{"title":"Register Agent","openapi":"mint-openapi.yaml POST /v1/agents","href":"/api-reference/machine-identity/agents/register"},{"title":"List Agents","openapi":"mint-openapi.yaml GET /v1/agents","href":"/api-reference/machine-identity/agents/list"},{"title":"Get Agent","openapi":"mint-openapi.yaml GET /v1/agents/{agentId}","href":"/api-reference/machine-identity/agents/get"},{"title":"Update Agent","openapi":"mint-openapi.yaml PATCH /v1/agents/{agentId}","href":"/api-reference/machine-identity/agents/update"},{"title":"Suspend Agent","openapi":"mint-openapi.yaml POST /v1/agents/{agentId}/suspend","href":"/api-reference/machine-identity/agents/suspend"},{"title":"Revoke Agent","openapi":"mint-openapi.yaml POST /v1/agents/{agentId}/revoke","href":"/api-reference/machine-identity/agents/revoke"},{"title":"Kill Switch","openapi":"mint-openapi.yaml POST /v1/agents/{agentId}/kill","href":"/api-reference/machine-identity/killswitch/kill"}]},{"group":"Agent Sessions \u0026 Tools","pages":[{"title":"List Scopes","openapi":"mint-openapi.yaml GET /v1/scopes","href":"/api-reference/machine-identity/scopes/list"},{"title":"Create Scope","openapi":"mint-openapi.yaml POST /v1/scopes","href":"/api-reference/machine-identity/scopes/create"},{"title":"Create Session","openapi":"mint-openapi.yaml POST /v1/agent-sessions","href":"/api-reference/machine-identity/sessions/create"},{"title":"List Sessions","openapi":"mint-openapi.yaml GET /v1/agent-sessions","href":"/api-reference/machine-identity/sessions/list"},{"title":"Terminate Session","openapi":"mint-openapi.yaml DELETE /v1/agent-sessions/{sessionId}","href":"/api-reference/machine-identity/sessions/terminate"},{"title":"Register Tool","openapi":"mint-openapi.yaml POST /v1/tools","href":"/api-reference/machine-identity/tools/register"},{"title":"Invoke Tool","openapi":"mint-openapi.yaml POST /v1/tools/{toolName}/invoke","href":"/api-reference/machine-identity/tools/invoke"}]},{"group":"Trust \u0026 Witness","pages":[{"title":"Get Trust Score","openapi":"mint-openapi.yaml GET /v1/agents/{agentId}/trust-score","href":"/api-reference/machine-identity/trust-scores/get"},{"title":"Compute Trust Score","openapi":"mint-openapi.yaml POST /v1/trust/compute","href":"/api-reference/machine-identity/trust-scores/compute"},{"title":"Trust Score History","openapi":"mint-openapi.yaml GET /v1/agents/{agentId}/trust-history","href":"/api-reference/machine-identity/trust-scores/history"},{"title":"Create Witness Request","openapi":"mint-openapi.yaml POST /v1/witness/request","href":"/api-reference/machine-identity/witness/create"},{"title":"Submit a Witness Attestation","openapi":"mint-openapi.yaml POST /v1/witness/{witnessRequestID}/attest","href":"/api-reference/machine-identity/witness/attest"},{"title":"Get Witness Consensus","openapi":"mint-openapi.yaml GET /v1/witness/{witnessRequestID}/consensus","href":"/api-reference/machine-identity/witness/consensus"}]},{"group":"Truth Claims \u0026 Documents","pages":[{"title":"Create Truth Claim","openapi":"mint-openapi.yaml POST /v1/truth/claim","href":"/api-reference/machine-identity/truth-claims/create"},{"title":"Record a Verification Verdict","openapi":"mint-openapi.yaml POST /v1/truth/verify","href":"/api-reference/machine-identity/truth-claims/verify"},{"title":"Get Truth Claim","openapi":"mint-openapi.yaml GET /v1/truth/claims/{claimId}/status","href":"/api-reference/machine-identity/truth-claims/status"},{"title":"Document Hash Record (Experimental)","openapi":"mint-openapi.yaml POST /v1/truth/document/verify","href":"/api-reference/machine-identity/documents/verify"},{"title":"Get Document Verification","openapi":"mint-openapi.yaml GET /v1/truth/document/{documentId}","href":"/api-reference/machine-identity/documents/get"}]},{"group":"Compliance \u0026 Anomalies","pages":[{"title":"Create Compliance Check","openapi":"mint-openapi.yaml POST /v1/compliance/check","href":"/api-reference/machine-identity/compliance/create-check"},{"title":"Generate a compliance report","openapi":"mint-openapi.yaml POST /v1/compliance/reports","href":"/api-reference/machine-identity/compliance/reports"},{"title":"Report Anomaly","openapi":"mint-openapi.yaml POST /v1/agents/{agentId}/anomalies","href":"/api-reference/machine-identity/anomalies/report"},{"title":"Resolve an anomaly","openapi":"mint-openapi.yaml POST /v1/agents/{agentId}/anomalies/{anomalyId}/resolve","href":"/api-reference/machine-identity/anomalies/resolve"},{"title":"List machine compliance reports","openapi":"mint-openapi.yaml GET /v1/compliance/reports","href":"/api-reference/compliance/reports"}]},{"group":"Datasets \u0026 Models","pages":[{"title":"Attest Dataset","openapi":"mint-openapi.yaml POST /v1/datasets/attest","href":"/api-reference/machine-identity/datasets/attest"},{"title":"List Dataset Attestations","openapi":"mint-openapi.yaml GET /v1/datasets","href":"/api-reference/machine-identity/datasets/list"},{"title":"Get Dataset Lineage","openapi":"mint-openapi.yaml GET /v1/datasets/lineage/{datasetId}","href":"/api-reference/machine-identity/datasets/lineage"},{"title":"Attest Model","openapi":"mint-openapi.yaml POST /v1/models/attest","href":"/api-reference/machine-identity/models/attest"},{"title":"Get Model Lineage","openapi":"mint-openapi.yaml GET /v1/models/{modelId}/lineage","href":"/api-reference/machine-identity/models/lineage"}]},{"group":"Orchestrations \u0026 Workflows","pages":[{"title":"Create an Orchestration Execution Record","openapi":"mint-openapi.yaml POST /v1/orchestrate/execute","href":"/api-reference/machine-identity/orchestrations/execute"},{"title":"Get Orchestration","openapi":"mint-openapi.yaml GET /v1/orchestrate/executions/{orchestrationId}","href":"/api-reference/machine-identity/orchestrations/get"},{"title":"Record LLM Inference","openapi":"mint-openapi.yaml POST /v1/orchestrate/llm/inference","href":"/api-reference/machine-identity/orchestrations/llm-inference"},{"title":"Create Workflow","openapi":"mint-openapi.yaml POST /v1/orchestrate/workflows","href":"/api-reference/machine-identity/workflows/create"},{"title":"Create a MAIP Workflow Run Record","openapi":"mint-openapi.yaml POST /v1/orchestrate/workflows/{workflowId}/execute","href":"/api-reference/machine-identity/workflows/execute"}]},{"group":"Guardrails \u0026 Delegation","pages":[{"title":"Record a Guardrail Score","openapi":"mint-openapi.yaml POST /v1/guardrails/check","href":"/api-reference/machine-identity/guardrails/check"},{"title":"Offer Cross-Tenant Delegation","openapi":"mint-openapi.yaml POST /v1/delegations/cross-tenant/offer","href":"/api-reference/machine-identity/delegations/offer"},{"title":"Accept Cross-Tenant Delegation","openapi":"mint-openapi.yaml POST /v1/delegations/cross-tenant/accept","href":"/api-reference/machine-identity/delegations/accept"}]},{"group":"MAIP Policies","pages":[{"title":"List MAIP Policies","openapi":"mint-openapi.yaml GET /v1/maip/policies","href":"/api-reference/machine-identity/policies/list"},{"title":"Create MAIP Policy","openapi":"mint-openapi.yaml POST /v1/maip/policies","href":"/api-reference/machine-identity/policies/create"},{"title":"Evaluate MAIP Policy","openapi":"mint-openapi.yaml POST /v1/maip/policies/evaluate","href":"/api-reference/machine-identity/policies/evaluate"}]},{"group":"Observability","pages":[{"title":"Emit Event","openapi":"mint-openapi.yaml POST /v1/events","href":"/api-reference/machine-identity/observability/events"},{"title":"Read MAIP service metadata","openapi":"mint-openapi.yaml GET /v1/metrics","href":"/api-reference/machine-identity/observability/metrics"},{"title":"List machine observability events","openapi":"mint-openapi.yaml GET /v1/events","href":"/api-reference/observability/events"}]},{"group":"Assets","pages":[{"title":"Upload an asset","openapi":"mint-openapi.yaml POST /v1/assets/upload","href":"/api-reference/assets/upload"},{"title":"Retrieve an asset","openapi":"mint-openapi.yaml GET /v1/assets/{id}","href":"/api-reference/assets/get"}]},{"group":"Governance","pages":[{"title":"List Governance Requests","openapi":"mint-openapi.yaml GET /v1/governance/issuer-requests","href":"/api-reference/governance/list-requests"},{"title":"Create governance request","openapi":"mint-openapi.yaml POST /v1/governance/issuer-requests","href":"/api-reference/governance/create-request"},{"title":"Approve Issuer Request","openapi":"mint-openapi.yaml POST /v1/governance/issuer-requests/{requestId}/approve","href":"/api-reference/governance/approve"},{"title":"Execute Governance Request","openapi":"mint-openapi.yaml POST /v1/governance/issuer-requests/{requestId}/execute","href":"/api-reference/governance/execute"},{"title":"Read an issuer governance request","openapi":"mint-openapi.yaml GET /v1/governance/issuer-requests/{requestId}","href":"/api-reference/governance/get-request"}]},{"group":"Announcements","pages":[{"title":"List announcements","openapi":"mint-openapi.yaml GET /v1/messages","href":"/api-reference/announcements/list"},{"title":"Mark announcement as read","openapi":"mint-openapi.yaml POST /v1/messages/{id}/read","href":"/api-reference/announcements/mark-read"}]},{"group":"System","pages":[{"title":"Health Check","openapi":"mint-openapi.yaml GET /healthz","href":"/api-reference/health/check"},{"title":"Readiness Probe","openapi":"mint-openapi.yaml GET /readyz","href":"/api-reference/health/ready"},{"title":"Programmatic status","openapi":"mint-openapi.yaml GET /api/health","href":"/api-reference/health/status"}]},{"group":"Agent receipts (MAIP)","pages":[{"title":"Create agent receipt","openapi":"maip-openapi.yaml POST /v1/agent-receipts","href":"/api-reference/agent-receipts/create"},{"title":"Get agent receipt","openapi":"maip-openapi.yaml GET /v1/agent-receipts/{receiptID}","href":"/api-reference/agent-receipts/get"},{"title":"List agent receipts","openapi":"maip-openapi.yaml GET /v1/agent-receipts/agent/{agentID}","href":"/api-reference/agent-receipts/list"},{"title":"Verify agent receipt","openapi":"maip-openapi.yaml GET /v1/agent-receipts/verify/{receiptID}","href":"/api-reference/agent-receipts/verify"}]},{"group":"Agent approvals (MAIP)","pages":[{"title":"List pending agent approvals","openapi":"maip-openapi.yaml GET /v1/approvals","href":"/api-reference/agent-approvals/list"},{"title":"Request agent approval","openapi":"maip-openapi.yaml POST /v1/approvals","href":"/api-reference/agent-approvals/create"},{"title":"Get agent approval","openapi":"maip-openapi.yaml GET /v1/approvals/{approvalID}","href":"/api-reference/agent-approvals/get"},{"title":"Approve agent approval","openapi":"maip-openapi.yaml POST /v1/approvals/{approvalID}/approve","href":"/api-reference/agent-approvals/approve"},{"title":"Reject agent approval","openapi":"maip-openapi.yaml POST /v1/approvals/{approvalID}/reject","href":"/api-reference/agent-approvals/reject"},{"title":"Cancel agent approval","openapi":"maip-openapi.yaml POST /v1/approvals/{approvalID}/cancel","href":"/api-reference/agent-approvals/cancel"}]},{"group":"Workspace document vault","pages":[{"title":"List workspace documents","openapi":"mint-openapi.yaml GET /v1/vault/documents","href":"/api-reference/vault/list"},{"title":"Get document versions and activity","openapi":"mint-openapi.yaml GET /v1/vault/documents/{id}","href":"/api-reference/vault/get"},{"title":"Upload a private document version","openapi":"mint-openapi.yaml POST /v1/vault/uploads","href":"/api-reference/vault/upload"},{"title":"Download a document version","openapi":"mint-openapi.yaml GET /v1/vault/documents/{id}/versions/{version}/download","href":"/api-reference/vault/download"},{"title":"Change document retention or lifecycle","openapi":"mint-openapi.yaml POST /v1/vault/documents/{id}/actions","href":"/api-reference/vault/lifecycle"}]},{"group":"Workspace administration","pages":[{"title":"Read workspace profile","openapi":"mint-openapi.yaml GET /v1/tenants/me","href":"/api-reference/tenants/get"},{"title":"Update workspace profile","openapi":"mint-openapi.yaml PATCH /v1/tenants/me","href":"/api-reference/tenants/update"},{"title":"Request production activation","openapi":"mint-openapi.yaml POST /v1/tenants/me/activate","href":"/api-reference/tenants/activate"}]},{"group":"Risk operations","pages":[{"title":"Record a block decision","openapi":"mint-openapi.yaml POST /v1/risk/block","href":"/api-reference/risk/block"},{"title":"Record a challenge decision","openapi":"mint-openapi.yaml POST /v1/risk/challenge","href":"/api-reference/risk/challenge"},{"title":"List risk decisions","openapi":"mint-openapi.yaml GET /v1/risk/decisions","href":"/api-reference/risk/decisions"},{"title":"Read subject quarantine","openapi":"mint-openapi.yaml GET /v1/risk/quarantine/{subject_id}","href":"/api-reference/risk/quarantine/get"},{"title":"Release subject quarantine","openapi":"mint-openapi.yaml DELETE /v1/risk/quarantine/{subject_id}","href":"/api-reference/risk/quarantine/release"},{"title":"Read risk settings","openapi":"mint-openapi.yaml GET /v1/risk/config","href":"/api-reference/risk/config/get"},{"title":"Update risk settings","openapi":"mint-openapi.yaml PUT /v1/risk/config","href":"/api-reference/risk/config/update"},{"title":"Read risk overview metrics","openapi":"mint-openapi.yaml GET /v1/risk/dashboard/metrics","href":"/api-reference/risk/dashboard/metrics"},{"title":"Read risk trends","openapi":"mint-openapi.yaml GET /v1/risk/dashboard/trends","href":"/api-reference/risk/dashboard/trends"},{"title":"Read most active risk subjects","openapi":"mint-openapi.yaml GET /v1/risk/dashboard/top-subjects","href":"/api-reference/risk/dashboard/top-subjects"}]}]}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/webhooks/rotate-secret"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/api-reference/webhooks/rotate-secret"}]},{"language":"pt","pages":[{"title":"pt","href":"/pt/api-reference/webhooks/rotate-secret"}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/webhooks/rotate-secret"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/api-reference/webhooks/rotate-secret"}]}]},"basePath":"","title":"Rotate endpoint secret - Truthlocks Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}