For the project and card routes, the key is an API key belonging to an onboarded integrator or
to an active audit provider. The publishing routes accept only an audit provider's credential.
Sending no Authorization header produces 401; sending one that is not recognised produces
403.
Milliseconds since the Unix epoch, of when the audit was conducted. Rejected if earlier than 2008-01-01 or later than the moment the request is handled.
file requires reportFileCid, obtained by uploading through the authorization route.
web requires reportUrl, a link to the provider's own published report.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Trustblock Docs","colors":{"primary":"#751dff","light":"#751dff","dark":"#751dff"},"favicon":"https://mintcdn.com/trustblock-148e7ceb/PQpjaaQtz0mKZVmE/favicon.svg?fit=max\u0026auto=format\u0026n=PQpjaaQtz0mKZVmE\u0026q=85\u0026s=909ec134239c888e6e91137c1ccfa9a6","logo":{"light":"https://mintcdn.com/trustblock-148e7ceb/GDKwuTCVqntzgeMe/logo/light.svg?fit=max\u0026auto=format\u0026n=GDKwuTCVqntzgeMe\u0026q=85\u0026s=20992966dab6c01ec52115cd94674a00","dark":"https://mintcdn.com/trustblock-148e7ceb/GDKwuTCVqntzgeMe/logo/dark.svg?fit=max\u0026auto=format\u0026n=GDKwuTCVqntzgeMe\u0026q=85\u0026s=c0163afa1f65ea09b61d9771bdcb7490"},"api":{"openapi":"https://api.trustblock.run/openapi.yml"},"navbar":{"links":[{"label":"Contact","href":"mailto:contact@trustblock.run"}],"primary":{"type":"button","label":"Create an account","href":"https://app.trustblock.run/sign-up?from=docs"}},"seo":{"metatags":{"og:description":"The open data layer for web3 security. Who audited what, what they found, and what's still open, across security firms. Search it, embed it, or query the API.","og:image":"https://app.trustblock.run/opengraph-image","twitter:card":"summary_large_image","twitter:description":"The open data layer for web3 security. Who audited what, what they found, and what's still open, across security firms. Search it, embed it, or query the API.","twitter:image":"https://app.trustblock.run/opengraph-image"},"indexing":"navigable"},"footer":{"socials":{"x":"https://x.com/trustblockhq","discord":"https://discord.com/invite/NbdkHYXbTx","linkedin":"https://www.linkedin.com/company/trustblockhq","youtube":"https://www.youtube.com/@TrustblockHQ"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"App","href":"https://app.trustblock.run/?from=docs","icon":"arrow-right-to-arc"},{"anchor":"X","href":"https://x.com/trustblockhq","icon":"x-twitter"},{"anchor":"Discord","href":"https://discord.com/invite/NbdkHYXbTx","icon":"discord"},{"anchor":"Blog","href":"https://trustblock.run/blog","icon":"rss"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"trustblock-148e7ceb","hasAudioNarration":false,"actualSubdomain":"trustblock-148e7ceb","customDomains":["docs.trustblock.run"],"gitSource":{"type":"github","owner":"trustblock-inc","repo":"monorepo","deployBranch":"docs","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad9f2223f287dbf34ebdea4","collectionId":"ed7c9ff1-9a55-4077-8b2c-00885c715ab8","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad9f2223f287dbf34ebdea4"},"entitlements":{},"buildId":"6ad9f2223f287dbf34ebdea4","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Technical","count":12},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Concept","count":6},{"language":"default","tag":"Roles","count":4},{"language":"default","tag":"Endpoints","count":4},{"language":"default","tag":"Publish an audit","count":3},{"language":"default","tag":"Explorer cards","count":3},{"language":"default","tag":"Changelog","count":1},{"language":"default","tag":"Methodology","count":1}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"technical/endpoints/create-a-new-audit","slug":"/technical/endpoints/create-a-new-audit","pageMetadata":{"openapi":"post /v1/audit","description":"Trustblock API route to create a new audit","og:image":"https://docs.trustblock.run/images/og/technical-endpoints-create-a-new-audit.png","twitter:image":"https://docs.trustblock.run/images/og/technical-endpoints-create-a-new-audit.png","title":"Publish an audit","href":"/technical/endpoints/create-a-new-audit"},"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: \"Trustblock API route to create a new audit\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /v1/audit","description":"Trustblock API route to create a new audit","og:image":"https://docs.trustblock.run/images/og/technical-endpoints-create-a-new-audit.png","twitter:image":"https://docs.trustblock.run/images/og/technical-endpoints-create-a-new-audit.png","title":"Publish an audit","href":"/technical/endpoints/create-a-new-audit"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Publishing"],"operationId":"createAudit","summary":"Publish an audit","description":"Trustblock API route to create a new audit","security":["cacc7d2f-3df6-40d4-a631-b4f2b0fb8ffb"],"requestBody":"a8accc4b-4364-4339-8feb-09976a7ebc8a","responses":{"201":"f5fb1438-b634-43dc-83d8-3903bcc984ce","400":"e794f3b7-2d94-4968-b087-08eda0fba115","401":"df1ecaea-f4aa-4fb6-89c6-dd265ece3f4a","403":"d643a9b5-04c5-4f3a-a499-604ef93b8ec5","409":"a095113a-3b49-4dd3-971d-4152b305ad5f","413":"af6620e0-7af5-4e9b-93bb-c14f1f2c972b"},"method":"post","type":"path","servers":["75b31ab2-2524-4fc3-bd64-e67acde4ccb7"],"path":"/v1/audit","baseUrlOptions":["https://api.trustblock.run"],"title":"Publish an audit","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","description","conductedAt","reportType","project","contracts","issues"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"description":{"type":"string","isRequired":true,"uniqueKey":"description","typeLabel":"string"},"conductedAt":{"type":"number","description":"Milliseconds since the Unix epoch, of when the audit was conducted. Rejected if earlier than 2008-01-01 or later than the moment the request is handled.","isRequired":true,"uniqueKey":"conductedAt","typeLabel":"number"},"reportType":{"type":"string","enum":["file","web"],"description":"`file` requires `reportFileCid`, obtained by uploading through the authorization route.\n`web` requires `reportUrl`, a link to the provider's own published report.\n","isRequired":true,"uniqueKey":"reportType","typeLabel":"enum\u003cstring>"},"project":{"type":"object","required":["name","links","tags","chains"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"project.name","typeLabel":"string"},"links":{"type":"object","required":["website"],"properties":{"website":{"type":"string","isRequired":true,"uniqueKey":"project.links.website","typeLabel":"string"},"twitter":{"oneOf":[{"type":"string","uniqueKey":"project.links.twitter.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"project.links.twitter.oneOf.1","typeLabel":"null"}],"uniqueKey":"project.links.twitter","typeLabel":"string | null"},"discord":{"oneOf":[{"type":"string","uniqueKey":"project.links.discord.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"project.links.discord.oneOf.1","typeLabel":"null"}],"uniqueKey":"project.links.discord","typeLabel":"string | null"},"telegram":{"oneOf":[{"type":"string","uniqueKey":"project.links.telegram.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"project.links.telegram.oneOf.1","typeLabel":"null"}],"uniqueKey":"project.links.telegram","typeLabel":"string | null"},"github":{"oneOf":[{"type":"string","uniqueKey":"project.links.github.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"project.links.github.oneOf.1","typeLabel":"null"}],"uniqueKey":"project.links.github","typeLabel":"string | null"},"youtube":{"oneOf":[{"type":"string","uniqueKey":"project.links.youtube.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"project.links.youtube.oneOf.1","typeLabel":"null"}],"uniqueKey":"project.links.youtube","typeLabel":"string | null"},"linkedIn":{"oneOf":[{"type":"string","uniqueKey":"project.links.linkedIn.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"project.links.linkedIn.oneOf.1","typeLabel":"null"}],"uniqueKey":"project.links.linkedIn","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"project.links","typeLabel":"object"},"tags":{"type":"array","items":{"type":"string","enum":["analytics","collectibles","finance","gaming","security","social","wallet","infrastructure","privacy","identity","other"],"uniqueKey":"project.tags.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"project.tags","typeLabel":"enum\u003cstring>[]"},"chains":{"type":"array","items":{"type":"string","description":"The chains Trustblock records contracts on.","enum":["ethereum","polygon","avalanche","bnbchain","arbitrum","optimism","fantom","zksync","base","polygonZkEvm","scroll","blast","starknet","solana","stellar","sui","tron","injective","ton","plume","peaq","lukso","mina","astar","vana","fiveire","zircuit","cosmoshub","osmosis","neutron","terra","sei","juno","stargaze","dymension","archway","noble","stride","persistence","xrpl","sonic","linea","monad","mantle","megaeth","gnosis","plasma","berachain","celo","hyperevm","unichain","seievm","robinhood","arc","taiko","fraxtal","abstract","worldchain","apechain","xdc","katana","stable","opbnb","bttc","memecore"],"uniqueKey":"project.chains.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"project.chains","typeLabel":"enum\u003cstring>[]"},"email":{"type":"string","uniqueKey":"project.email","typeLabel":"string"}},"isRequired":true,"uniqueKey":"project","typeLabel":"object"},"contracts":{"type":"array","minItems":1,"items":{"oneOf":[{"type":"object","title":"On-chain contract","required":["type","chain","address"],"properties":{"type":{"type":"string","enum":["onChain"],"isRequired":true,"uniqueKey":"contracts.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"chain":{"type":"string","description":"The chains Trustblock records contracts on.","enum":["ethereum","polygon","avalanche","bnbchain","arbitrum","optimism","fantom","zksync","base","polygonZkEvm","scroll","blast","starknet","solana","stellar","sui","tron","injective","ton","plume","peaq","lukso","mina","astar","vana","fiveire","zircuit","cosmoshub","osmosis","neutron","terra","sei","juno","stargaze","dymension","archway","noble","stride","persistence","xrpl","sonic","linea","monad","mantle","megaeth","gnosis","plasma","berachain","celo","hyperevm","unichain","seievm","robinhood","arc","taiko","fraxtal","abstract","worldchain","apechain","xdc","katana","stable","opbnb","bttc","memecore"],"isRequired":true,"uniqueKey":"contracts.items.[INDEX].oneOf.0.chain","typeLabel":"enum\u003cstring>"},"address":{"type":"string","isRequired":true,"uniqueKey":"contracts.items.[INDEX].oneOf.0.address","typeLabel":"string"}},"uniqueKey":"contracts.items.[INDEX].oneOf.0","typeLabel":"On-chain contract · object"},{"type":"object","title":"Public repository contract","required":["type","repositoryUrl","repositoryCommitHash","repositoryFilePath"],"properties":{"type":{"type":"string","enum":["offChainPublic"],"isRequired":true,"uniqueKey":"contracts.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"repositoryUrl":{"type":"string","isRequired":true,"uniqueKey":"contracts.items.[INDEX].oneOf.1.repositoryUrl","typeLabel":"string"},"repositoryCommitHash":{"type":"string","isRequired":true,"uniqueKey":"contracts.items.[INDEX].oneOf.1.repositoryCommitHash","typeLabel":"string"},"repositoryFilePath":{"type":"string","isRequired":true,"uniqueKey":"contracts.items.[INDEX].oneOf.1.repositoryFilePath","typeLabel":"string"}},"uniqueKey":"contracts.items.[INDEX].oneOf.1","typeLabel":"Public repository contract · object"},{"type":"object","title":"Private repository contract","required":["type","name"],"properties":{"type":{"type":"string","enum":["offChainPrivate"],"isRequired":true,"uniqueKey":"contracts.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"name":{"type":"string","isRequired":true,"uniqueKey":"contracts.items.[INDEX].oneOf.2.name","typeLabel":"string"}},"uniqueKey":"contracts.items.[INDEX].oneOf.2","typeLabel":"Private repository contract · object"}],"uniqueKey":"contracts.items.[INDEX]","typeLabel":"On-chain contract · object | Public repository contract · object | Private repository contract · object"},"isRequired":true,"uniqueKey":"contracts","typeLabel":"(On-chain contract · object | Public repository contract · object | Private repository contract · object)[]"},"issues":{"type":"array","items":{"type":"object","description":"An issue as a provider submits it.","required":["status","severity"],"properties":{"status":{"type":"string","enum":["fixed","not_fixed","acknowledged"],"description":"The status a provider may submit. `acknowledged` means the client read the finding and accepted the risk; it is published as `not_fixed` with `isAcknowledged: true`.","isRequired":true,"uniqueKey":"issues.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"severity":{"type":"string","enum":["low","medium","high","critical"],"isRequired":true,"uniqueKey":"issues.items.[INDEX].severity","typeLabel":"enum\u003cstring>"},"name":{"type":"string","uniqueKey":"issues.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","uniqueKey":"issues.items.[INDEX].description","typeLabel":"string"}},"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"issues","typeLabel":"object[]"},"reportFileCid":{"type":"string","description":"Required when `reportType` is `file`.","uniqueKey":"reportFileCid","typeLabel":"string"},"reportUrl":{"type":"string","description":"Required when `reportType` is `web`.","uniqueKey":"reportUrl","typeLabel":"string"},"aggregationId":{"type":"string","description":"Required for providers whose publishing mode is automatic or aggregated, and rejected for\nproviders publishing manually.\n","uniqueKey":"aggregationId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","description":"\u003cstring>","conductedAt":123,"project":{"name":"\u003cstring>","links":{"website":"\u003cstring>","twitter":"\u003cstring>","discord":"\u003cstring>","telegram":"\u003cstring>","github":"\u003cstring>","youtube":"\u003cstring>","linkedIn":"\u003cstring>"},"tags":[],"chains":[],"email":"\u003cstring>"},"contracts":[{"type":"onChain","address":"\u003cstring>"}],"issues":[{"name":"\u003cstring>","description":"\u003cstring>"}],"reportFileCid":"\u003cstring>","reportUrl":"\u003cstring>","aggregationId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f5fb1438-b634-43dc-83d8-3903bcc984ce":{"description":"The audit was created.","content":{"application/json":{"schema":{"type":"object","required":["id","extra"],"properties":{"id":{"type":"string","description":"The new audit's identifier.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"extra":{"type":"object","description":"Present on every response, including errors.","required":["requestId"],"properties":{"requestId":{"type":"string","description":"Quote this when reporting a problem.","isRequired":true,"uniqueKey":"extra.requestId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"extra","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","extra":{"requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e794f3b7-2d94-4968-b087-08eda0fba115":{"description":"The body failed validation.","content":{"application/json":{"schema":{"type":"object","required":["message","extra"],"properties":{"message":{"type":"string","description":"A short, non-localised description of the failure.","example":"Not found.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"extra":{"type":"object","description":"Present on every response, including errors.","required":["requestId"],"properties":{"requestId":{"type":"string","description":"Quote this when reporting a problem.","isRequired":true,"uniqueKey":"extra.requestId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"extra","typeLabel":"object"},"code":{"type":"string","description":"A stable machine-readable code, where one applies.","uniqueKey":"code","typeLabel":"string"},"diagnoses":{"type":"array","description":"Field-level detail, present on validation failures.","items":{"type":"object","uniqueKey":"diagnoses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"diagnoses","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Not found.","extra":{"requestId":"\u003cstring>"},"code":"\u003cstring>","diagnoses":[{}]}}},"exampleType":"generated"}},"exampleType":"generated"},"df1ecaea-f4aa-4fb6-89c6-dd265ece3f4a":{"description":"No `Authorization` header was sent.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"d643a9b5-04c5-4f3a-a499-604ef93b8ec5":{"description":"The caller is not an active audit provider.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"a095113a-3b49-4dd3-971d-4152b305ad5f":{"description":"The audit already exists.","content":{"application/json":{"schema":{"type":"object","required":["message","extra"],"properties":{"message":{"type":"string","description":"A short, non-localised description of the failure.","example":"Not found.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"extra":{"type":"object","description":"Present on every response, including errors.","required":["requestId"],"properties":{"requestId":{"type":"string","description":"Quote this when reporting a problem.","isRequired":true,"uniqueKey":"extra.requestId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"extra","typeLabel":"object"},"code":{"type":"string","description":"A stable machine-readable code, where one applies.","uniqueKey":"code","typeLabel":"string"},"diagnoses":{"type":"array","description":"Field-level detail, present on validation failures.","items":{"type":"object","uniqueKey":"diagnoses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"diagnoses","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Not found.","extra":{"requestId":"\u003cstring>"},"code":"\u003cstring>","diagnoses":[{}]}}},"exampleType":"generated"}},"exampleType":"generated"},"af6620e0-7af5-4e9b-93bb-c14f1f2c972b":{"description":"The body is too large.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"cacc7d2f-3df6-40d4-a631-b4f2b0fb8ffb":{"BearerAuth":{"type":"http","scheme":"bearer","description":"`Authorization: Bearer \u003ckey>`.\n\nFor the project and card routes, the key is an API key belonging to an onboarded integrator or\nto an active audit provider. The publishing routes accept only an audit provider's credential.\nSending no `Authorization` header produces `401`; sending one that is not recognised produces\n`403`.\n","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"75b31ab2-2524-4fc3-bd64-e67acde4ccb7":{"url":"https://api.trustblock.run","description":"Production. This is the only server."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"`Authorization: Bearer \u003ckey>`.\n\nFor the project and card routes, the key is an API key belonging to an onboarded integrator or\nto an active audit provider. The publishing routes accept only an audit provider's credential.\nSending no `Authorization` header produces `401`; sending one that is not recognised produces\n`403`.\n","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"`Authorization: Bearer \u003ckey>`.\n\nFor the project and card routes, the key is an API key belonging to an onboarded integrator or\nto an active audit provider. The publishing routes accept only an audit provider's credential.\nSending no `Authorization` header produces `401`; sending one that is not recognised produces\n`403`.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://api.trustblock.run/openapi.yml"},"subdomain":"trustblock-148e7ceb","siteName":"Trustblock Docs","title":"Publish an audit - Trustblock Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-01T16:36:50.129Z","originalFileLocation":"technical/endpoints/create-a-new-audit.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=\"Trustblock API route to create a new audit\">\u003cmeta data-mint-head name=\"application-name\" content=\"Trustblock Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/trustblock-148e7ceb/KaVstqo7oNRdvaAS/_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/trustblock-148e7ceb/KaVstqo7oNRdvaAS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/trustblock-148e7ceb/KaVstqo7oNRdvaAS/_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/trustblock-148e7ceb/KaVstqo7oNRdvaAS/_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/trustblock-148e7ceb/KaVstqo7oNRdvaAS/_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/trustblock-148e7ceb/KaVstqo7oNRdvaAS/_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/trustblock-148e7ceb/KaVstqo7oNRdvaAS/_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/trustblock-148e7ceb/KaVstqo7oNRdvaAS/_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/trustblock-148e7ceb/KaVstqo7oNRdvaAS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Publish an audit - Trustblock Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"The open data layer for web3 security. Who audited what, what they found, and what\u0026#x27;s still open, across security firms. Search it, embed it, or query the API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Trustblock Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trustblock.run/technical/endpoints/create-a-new-audit\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.trustblock.run/images/og/technical-endpoints-create-a-new-audit.png\">\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=\"Publish an audit - Trustblock Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The open data layer for web3 security. Who audited what, what they found, and what\u0026#x27;s still open, across security firms. Search it, embed it, or query the API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.trustblock.run/images/og/technical-endpoints-create-a-new-audit.png\">\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/trustblock-148e7ceb/KaVstqo7oNRdvaAS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Trustblock Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#751dff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trustblock.run/technical/endpoints/create-a-new-audit\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/technical/endpoints/create-a-new-audit.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trustblock.run/#organization\",\"name\":\"Trustblock Docs\",\"url\":\"https://docs.trustblock.run\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/trustblock-148e7ceb/GDKwuTCVqntzgeMe/logo/light.svg?fit=max\u0026auto=format\u0026n=GDKwuTCVqntzgeMe\u0026q=85\u0026s=20992966dab6c01ec52115cd94674a00\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trustblock.run#website\",\"name\":\"Trustblock Docs\",\"url\":\"https://docs.trustblock.run\",\"publisher\":{\"@id\":\"https://docs.trustblock.run/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trustblock.run/technical/endpoints/create-a-new-audit#webpage\",\"url\":\"https://docs.trustblock.run/technical/endpoints/create-a-new-audit\",\"name\":\"Publish an audit\",\"description\":\"Trustblock API route to create a new audit\",\"dateModified\":\"2026-10-01T16:36:50.129Z\",\"isPartOf\":{\"@id\":\"https://docs.trustblock.run#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trustblock.run/technical/endpoints/create-a-new-audit#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trustblock.run/technical/endpoints/create-a-new-audit#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.trustblock.run/technical/publish\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Publish an audit\",\"item\":\"https://docs.trustblock.run/technical/publish\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Endpoints\",\"item\":\"https://docs.trustblock.run/technical/endpoints/get-upload-report-authorization\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Publish an audit\",\"item\":\"https://docs.trustblock.run/technical/endpoints/create-a-new-audit\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.trustblock.run/technical/endpoints/create-a-new-audit#apireference\",\"headline\":\"Publish an audit\",\"name\":\"Publish an audit\",\"description\":\"Trustblock API route to create a new audit\",\"url\":\"https://docs.trustblock.run/technical/endpoints/create-a-new-audit\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trustblock.run/technical/endpoints/create-a-new-audit#webpage\"},\"image\":\"https://docs.trustblock.run/images/og/technical-endpoints-create-a-new-audit.png\",\"dateModified\":\"2026-10-01T16:36:50.129Z\",\"publisher\":{\"@id\":\"https://docs.trustblock.run/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trustblock.run#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Trustblock Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Trustblock Docs","nav":{"global":{"anchors":[{"anchor":"App","href":"https://app.trustblock.run/?from=docs","icon":"arrow-right-to-arc"},{"anchor":"X","href":"https://x.com/trustblockhq","icon":"x-twitter"},{"anchor":"Discord","href":"https://discord.com/invite/NbdkHYXbTx","icon":"discord"},{"anchor":"Blog","href":"https://trustblock.run/blog","icon":"rss"}]},"tabs":[{"tab":"Concept","pages":[{"title":"Concept","href":"/introduction"}]},{"tab":"Technical","groups":[{"group":"","pages":[{"title":"Technical Guides","icon":"code","href":"/technical/introduction"},{"title":"Supported Chains","icon":"server","href":"/technical/supported-chains"}]},{"group":"Guides","pages":[{"group":"Publish an audit","icon":"paper-plane-top","pages":[{"title":"Step by step guide","href":"/technical/publish"},{"group":"Endpoints","pages":[{"openapi":"GET /v1/auditor/upload-report-authorization","description":"Trustblock API route to get upload report authorization","title":"Get an authorization to upload a report file","href":"/technical/endpoints/get-upload-report-authorization"},{"openapi":"post /v1/audit","title":"Publish an audit","href":"/technical/endpoints/create-a-new-audit"}]}]},{"title":"Show your record on your site","description":"Show your project's Trustblock security record on your own site: the free label, the API, or a plain link.","icon":"window-maximize","href":"/technical/show-your-record"},{"title":"Security firm widget","icon":"chart-pie-simple","href":"/technical/metrics-widget"},{"title":"Labels Widget","icon":"hexagon-check","href":"/technical/labels-widget"},{"title":"Security Data API","icon":"bolt","openapi":"get /v1/project/security","href":"/technical/security-api"},{"group":"Explorer cards","icon":"id-card","pages":[{"title":"Explorer cards","icon":"id-card","href":"/technical/explorer-cards"},{"group":"Endpoints","pages":[{"openapi":"GET /v1/project/etherscan-card","title":"Get a project's Etherscan card","href":"/technical/endpoints/get-etherscan-card"},{"openapi":"GET /v1/project/blockscout-card","title":"Get a project's Blockscout card","href":"/technical/endpoints/get-blockscout-card"}]}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Publish an audit - Trustblock Docs","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}