{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Uploading and retrieving proof","description":"Hyperproof developer resources for custom integrations.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"uploading-and-retrieving-proof","__idx":0},"children":["Uploading and retrieving proof"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This article explains how to upload, list, and download proof files using the Hyperproof API. It provides a plain-language overview of the official API documentation and includes practical, original examples to help you implement each step."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":1},"children":["Authentication"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include a Bearer access token in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," header for every request"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tokens are obtained via Hyperproof OAuth"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example header"]}," - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer <ACCESS_TOKEN>"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"uploading-a-proof-file-organization-scope","__idx":2},"children":["Uploading a proof file (organization scope)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Method and URL"]}," - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST https://api.hyperproof.app/v1/proof"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request"]}," (multipart/form-data)"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["proof"]}," (file, required) - The file to upload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hp-proof-owned-by"]}," (string, optional) - The user ID designating the proof owner."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Behavior"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upon success, returns JSON metadata about the uploaded proof, including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filename"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["version"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["size"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdBy/On"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedBy/On"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sample"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n  --url https://api.hyperproof.app/v1/proof \\\n  --header \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  --form proof=@\"./policies/AcceptableUse.pdf\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["With explicit owner"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n  --url https://api.hyperproof.app/v1/proof \\\n  --header \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  --form proof=@\"./policies/AcceptableUse.pdf\" \\\n  --form hp-proof-owned-by=\"$USER_ID\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Uploading Testable CSV proof"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When sending CSV files, you need to explicitly declare the type as text/csv. This tells Hyperproof to treat the uploaded blob as tabular data. This allows the CSV proof to be usable in automated tests."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n  --url https://api.hyperproof.app/v1/proof \\\n  --header \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  --form proof=@\"./policies/AcceptableUse.csv:type=text/csv\" \\\n  --form hp-proof-owned-by=\"$USER_ID\"\n  --form contentType=\"text/csv\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Updating Testable CSV proof"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After uploading a CSV file intended for automated testing, a PATCH request should be made to create the schema to be tested."," ","The body of the request will define the CSV fields and types for the automated testing feature. Available types include text , number , boolean , and date."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request PATCH 'https://api.hyperproof.app/v1/proof/:proofid' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: ••••••' \\\n--data '{\n    \"isPrivate\": false,\n    \"schema\": {\n        \"class\": \"CsvFileSchema\",\n        \"fields\": [{\n            \"name\": \"Name\",\n            \"type\": \"text\"\n        }, {\n            \"name\": \"Email\",\n            \"type\": \"text\"\n        }]\n    }\n}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"uploading-a-new-version-of-existing-proof","__idx":3},"children":["Uploading a new version of existing proof"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Method and URL"]}," - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST https://api.hyperproof.app/v1/proof/{proofId}/versions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request"]}," (multipart/form-data)"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["proof"]}," (file, required) - The new file contents."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Behavior"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creates a new version for the referenced proof item."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["version"]}," value increases by 1 from the highest existing version."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sample"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n  --url \"https://api.hyperproof.app/v1/proof/$PROOF_ID/versions\" \\\n  --header \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  --form proof=@\"./policies/AcceptableUse_v7.pdf\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"uploading-and-immediately-linking-proof-to-an-object","__idx":4},"children":["Uploading and immediately linking proof to an object"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can upload a proof file and directly link it to an object such as a control, label, or task."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL pattern"]}," - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST https://api.hyperproof.app/v1/{objectType}s/{objectId}/proof"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["objectType"]}," can be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["control"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["task"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use multi-part/form-data with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["proof"]}," file field."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sample (control)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"CONTROL_ID=12345678-90ab-cdef-1234-567890abcdef\ncurl --request POST \\\n  --url \"https://api.hyperproof.app/v1/controls/$CONTROL_ID/proof\" \\\n  --header \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  --form proof=@\"./evidence/PrivacyPolicy.pdf\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"uploading-proof-using-the-api-with-a-service-account","__idx":5},"children":["Uploading proof using the API with a Service Account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To successfully upload a proof via the API using a service account, you must explicitly assign the proof's ownership to one of the Hyperproof users. When making your API call to upload the proof, include the following header or metadata field:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use multi-part/form-data with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["proof"]}," file field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hp-proof-owned-by"]}," - UUID of the user who should own the proof (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developer.hyperproof.app/hyperproof-api/users/users.openapi/other/get-org-users"},"children":["Retrieve a list of users UUIDs."]},")"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sample"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n  --url https://api.hyperproof.app/v1/proof \\\n  --header \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  --form proof=@\"./policies/AcceptableUse.pdf\" \\\n  --form hp-proof-owned-by=\"$USER_ID\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"listing-proof-metadata-organization","__idx":6},"children":["Listing proof metadata (organization)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Method and URL"]}," - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET https://api.hyperproof.app/v1/proof"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pagination"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}," (integer, optional) - This is the page size. The default is 25."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If more items exist than the page size, the response includes an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offsetToken"]}," you can pass as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," to fetch the next page."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sorting"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sortBy"]}," - One of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdBy"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdOn"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filename"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uploadedOn"]},". The default is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uploadedOn"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sortDirection"]}," - Choose either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["asc"]}," (ascending) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["desc"]}," (descending). The default is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["desc"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uploadedOn"]}," - Updates when you add a new version; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdOn"]}," remains fixed."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Filtering"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ownedByMe=true"]}," - Returns proof owned by the currently authorized user."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search=<value>"]}," - Filters by filename matches."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sample"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --silent \\\n  --header \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  \"https://api.hyperproof.app/v1/proof?limit=100&sortBy=filename&sortDirection=asc&ownedByMe=true\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Follow-up page using offset token"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --silent \\\n  --header \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  \"https://api.hyperproof.app/v1/proof?offset=$OFFSET_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"listing-proof-metadata-linked-to-a-specific-object","__idx":7},"children":["Listing proof metadata linked to a specific object"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the same endpoint with object filters."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Method and URL"]}," - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET https://api.hyperproof.app/v1/proof?objectType=<control|label|task>&objectId=<ID>"]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sample (first page for a control)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --silent \\\n  --header \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  \"https://api.hyperproof.app/v1/proof?objectType=control&objectId=$CONTROL_ID&limit=100\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"downloading-proof-file-contents","__idx":8},"children":["Downloading proof file contents"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Method and URL"]}," - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET https://api.hyperproof.app/v1/proof/{proofId}/contents"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Behavior"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Returns the raw file in the response body."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The original file name is provided by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["content-disposition"]}," response header."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To fetch a particular version, add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?version=<n>"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sample (latest version)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -O --remote-header-name \\\n  -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  \"https://api.hyperproof.app/v1/proof/$PROOF_ID/contents\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sample (specific version)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -O --remote-header-name \\\n  -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  \"https://api.hyperproof.app/v1/proof/$PROOF_ID/contents?version=3\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-fields-common","__idx":9},"children":["Response fields (common)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While the exact shape can evolve, responses commonly include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," (UUID)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filename"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["version"]}," (integer)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["size"]}," (bytes)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdBy"]}," (user ID)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdOn"]}," (ISO-8601 timestamp)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedBy"]}," (user ID)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uploadedOn"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedOn"]}," (ISO-8601 timestamp)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"notes-and-tips","__idx":10},"children":["Notes and tips"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep your access tokens secure. Regenerate or rotate them according to your organization’s policies."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When paginating, always check for an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offsetToken"]}," and pass it back via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," query parameter until no token is returned."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Prefer ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uploadedOn"]}," to sort by \"Most recently changed\" since it advances when new versions are added."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hp-proof-owned-by"]}," if you need to attribute a proof item to a particular user at upload time."]}]}]},"headings":[{"value":"Uploading and retrieving proof","id":"uploading-and-retrieving-proof","depth":1},{"value":"Authentication","id":"authentication","depth":2},{"value":"Uploading a proof file (organization scope)","id":"uploading-a-proof-file-organization-scope","depth":2},{"value":"Uploading a new version of existing proof","id":"uploading-a-new-version-of-existing-proof","depth":2},{"value":"Uploading and immediately linking proof to an object","id":"uploading-and-immediately-linking-proof-to-an-object","depth":2},{"value":"Uploading proof using the API with a Service Account","id":"uploading-proof-using-the-api-with-a-service-account","depth":2},{"value":"Listing proof metadata (organization)","id":"listing-proof-metadata-organization","depth":2},{"value":"Listing proof metadata linked to a specific object","id":"listing-proof-metadata-linked-to-a-specific-object","depth":2},{"value":"Downloading proof file contents","id":"downloading-proof-file-contents","depth":2},{"value":"Response fields (common)","id":"response-fields-common","depth":2},{"value":"Notes and tips","id":"notes-and-tips","depth":2}],"frontmatter":{"seo":{"title":"Uploading and retrieving proof"}},"lastModified":"2026-03-09T16:07:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/hyperproof-api/api-003-uploading-and-retrieving-proof","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}