Creates a new key pair with the enclave, shards the private key, and securely stores the encrypted key shards. organisation and package are optional; key_environment defaults to HOT if omitted.
Optional list of context fields to bind into the enclave signature. When present, the enclave signs a JCS-canonical (RFC 8785) JSON payload built from these fields plus the public_key (always included), returned as signed_payload, so a verified signature attests to the business context the key was issued for — not just the key bytes. Do not list public_key here; it is included implicitly.
Signature of the key in base64 format, produced by the generating enclave. Verify against CoinCover's published JWKS before relying on the key. When sign_with is supplied the signature is computed over signed_payload; otherwise it covers the public key.
JCS-canonical (RFC 8785) JSON string that was signed — object keys sorted, always including public_key alongside the requested context fields. Returned only when sign_with was supplied. Verify the signature over these exact bytes rather than a re-serialised copy.
The sign_with field names that were included, in the order requested (public_key is not listed). Confirm this contains every field you expected before trusting the binding.
Optional metadata describing the associated organisation and package
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Coincover Developer Docs","colors":{"primary":"#3939EF","light":"#B59BFD","dark":"#B59BFD"},"logo":{"light":"https://mintcdn.com/coincover/YulmKC25AtRiJdum/images/CC-Logo-Black.svg?fit=max\u0026auto=format\u0026n=YulmKC25AtRiJdum\u0026q=85\u0026s=d81d260390cff9797e850679aeec6841","dark":"https://mintcdn.com/coincover/YulmKC25AtRiJdum/images/CC-Logo-White.svg?fit=max\u0026auto=format\u0026n=YulmKC25AtRiJdum\u0026q=85\u0026s=e4baa96369293d28a43a8fee6c4db806","href":"https://www.coincover.com/"},"favicon":"https://mintcdn.com/coincover/YulmKC25AtRiJdum/images/Favicon32px.svg?fit=max\u0026auto=format\u0026n=YulmKC25AtRiJdum\u0026q=85\u0026s=a1f83bee4378390aeb0dd8059e55456b","appearance":{"strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#0E171B"}},"navbar":{"links":[],"primary":{"type":"button","label":"Talk to us","href":"https://www.coincover.com/contact"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/coincoverglobal","x":"https://x.com/Coincoverglobal","website":"https://www.coincover.com"}},"fonts":{"family":"Inter","weight":400},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","claude","cursor"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"coincover","hasAudioNarration":false,"actualSubdomain":"coincover","customDomains":["developer.coincover.com"],"gitSource":{"type":"github","owner":"coincover","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6aeda83b61234cac2656d83a","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":30},{"language":"default","tag":"Products","count":13},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Using CoinCover Control","count":9},{"language":"default","tag":"Partners","count":8},{"language":"default","tag":"Backups","count":7},{"language":"default","tag":"Recover for Institutions","count":6},{"language":"default","tag":"Retail API","count":6},{"language":"default","tag":"Keys","count":5},{"language":"default","tag":"Institutional API","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":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":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@keyframes cc-marquee{from{transform:translateX(0)}to{transform:translateX(-50%)}}.cc-marquee{animation:cc-marquee var(--cc-duration, 10s) linear infinite}.cc-marquee-fade{pointer-events:none;position:absolute;top:0;bottom:0;z-index:10;width:5rem}.cc-marquee-fade-left{left:0;background:linear-gradient(to right, #ffffff, transparent)}.cc-marquee-fade-right{right:0;background:linear-gradient(to left, #ffffff, transparent)}html.dark .cc-marquee-fade-left{background:linear-gradient(to right, #0e171b, transparent)}html.dark .cc-marquee-fade-right{background:linear-gradient(to left, #0e171b, transparent)}html{overflow-x:hidden}.cc-hero{max-width:90rem}.cc-hero-bg{pointer-events:none;position:absolute;top:-12rem;right:-12rem;z-index:0;width:44rem}@media (max-width: 1023px){.cc-hero-bg{display:none}}.cc-hero-bg img{display:block;width:100%;height:auto;opacity:0.4;mix-blend-mode:screen}html.dark .cc-hero-bg img{opacity:0.55}.cc-hero-content{position:relative;z-index:1}.cc-cta{background-color:transparent}html.dark .cc-partner-logo{filter:invert(1) hue-rotate(180deg)}"}],"page":{"pagePath":"api-reference/keys/assign-a-new-key","slug":"/api-reference/keys/assign-a-new-key","pageMetadata":{"title":"Assign a new key","description":"Creates a new key pair with the enclave, shards the private key, and securely stores the encrypted key shards. organisation and package are optional; key_environment defaults to HOT if omitted.","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json post /v1/keys","href":"/api-reference/keys/assign-a-new-key","autogeneratedByOpenApi":true},"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: \"Creates a new key pair with the enclave, shards the private key, and securely stores the encrypted key shards. organisation and package are optional; key_environment defaults to HOT if omitted.\"\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":{"title":"Assign a new key","description":"Creates a new key pair with the enclave, shards the private key, and securely stores the encrypted key shards. organisation and package are optional; key_environment defaults to HOT if omitted.","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json post /v1/keys","href":"/api-reference/keys/assign-a-new-key","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Assign a new key","description":"Creates a new key pair with the enclave, shards the private key, and securely stores the encrypted key shards. organisation and package are optional; key_environment defaults to HOT if omitted.","operationId":"assignKey","tags":["Keys"],"parameters":["b9017c59-5e3f-4746-8f8c-63a38fdf7f61"],"requestBody":"35d2d604-55eb-465e-9c2d-5b70b4f7f063","responses":{"200":"1280ae42-138d-4421-aa66-6d1aa46cab94","400":"43754692-133f-4b3f-9d9b-c5dec2af3b7f","500":"cf786376-096d-4187-9d9b-c3a2703843a4"},"method":"post","type":"path","servers":["8b7e8c54-5675-4883-a48b-6f7fef9488b5","af033e22-8ab7-4ee5-93c8-3cb420b0dec5"],"security":["e5ee00f7-f62c-4f44-82f8-3f3168e410dc"],"path":"/v1/keys","baseUrlOptions":["https://service.uat-keys.coincover.com","https://service.keys.coincover.com"],"title":"Assign a new key","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b9017c59-5e3f-4746-8f8c-63a38fdf7f61":{"name":"Authorization","in":"header","description":"Bearer token for authentication. Can be either a JWT token or API key.","required":true,"schema":{"type":"string","isRequired":true,"description":"Bearer token for authentication. Can be either a JWT token or API key.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"description":"Key assignment details","required":true,"content":{"application/json":{"schema":{"type":"object","required":["user_identifier","key_type"],"properties":{"user_identifier":{"type":"string","description":"Unique identifier of the user","isRequired":true,"uniqueKey":"user_identifier","typeLabel":"string"},"key_type":{"type":"string","enum":["rsa4096","secp256k1","ed25519"],"description":"Type of cryptographic key to generate. rsa4096 for encrypting recovery material; secp256k1 or ed25519 for a blockchain backup signer.","isRequired":true,"uniqueKey":"key_type","typeLabel":"enum\u003cstring>"},"key_environment":{"type":"string","enum":["HOT","COLD"],"default":"HOT","description":"Key environment specification - HOT (online generation) or COLD (offline generation)","uniqueKey":"key_environment","typeLabel":"enum\u003cstring>"},"organisation":{"type":"object","description":"Optional organisation metadata","properties":{"customer_id":{"type":"string","description":"Unique identifier for the organisation","uniqueKey":"organisation.customer_id","typeLabel":"string"},"customer_name":{"type":"string","description":"Name of the organisation customer","uniqueKey":"organisation.customer_name","typeLabel":"string"}},"uniqueKey":"organisation","typeLabel":"object"},"package":{"type":"object","description":"Optional package metadata","properties":{"package_id":{"type":"string","description":"External package ID assigned to the key","uniqueKey":"package.package_id","typeLabel":"string"},"package_name":{"type":"string","description":"Name of the package","uniqueKey":"package.package_name","typeLabel":"string"}},"uniqueKey":"package","typeLabel":"object"},"sign_with":{"type":"array","description":"Optional list of context fields to bind into the enclave signature. When present, the enclave signs a JCS-canonical (RFC 8785) JSON payload built from these fields plus the public_key (always included), returned as signed_payload, so a verified signature attests to the business context the key was issued for — not just the key bytes. Do not list public_key here; it is included implicitly.","items":{"type":"string","enum":["external_customer_id","external_package_id","pulled_by_id","pulled_by_type","user_id","key_id","key_fingerprint"],"uniqueKey":"sign_with.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"sign_with","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"user_identifier":"\u003cstring>","key_environment":"HOT","organisation":{"customer_id":"\u003cstring>","customer_name":"\u003cstring>"},"package":{"package_id":"\u003cstring>","package_name":"\u003cstring>"},"sign_with":[]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1280ae42-138d-4421-aa66-6d1aa46cab94":{"description":"Key successfully assigned","content":{"application/json":{"schema":{"type":"object","properties":{"key_id":{"type":"string","format":"uuid","description":"Unique identifier for the key","uniqueKey":"key_id","typeLabel":"string\u003cuuid>"},"public_key":{"type":"string","description":"Public key in hex format. For rsa4096 this is the encryption public key; for secp256k1 or ed25519 this is the compressed public key.","uniqueKey":"public_key","typeLabel":"string"},"signature":{"type":"string","description":"Signature of the key in base64 format, produced by the generating enclave. Verify against CoinCover's published JWKS before relying on the key. When sign_with is supplied the signature is computed over signed_payload; otherwise it covers the public key.","uniqueKey":"signature","typeLabel":"string"},"signed_payload":{"type":"string","description":"JCS-canonical (RFC 8785) JSON string that was signed — object keys sorted, always including public_key alongside the requested context fields. Returned only when sign_with was supplied. Verify the signature over these exact bytes rather than a re-serialised copy.","uniqueKey":"signed_payload","typeLabel":"string"},"signed_fields":{"type":"array","description":"The sign_with field names that were included, in the order requested (public_key is not listed). Confirm this contains every field you expected before trusting the binding.","items":{"type":"string","uniqueKey":"signed_fields.items.[INDEX]","typeLabel":"string"},"uniqueKey":"signed_fields","typeLabel":"string[]"},"customer_id":{"oneOf":[{"type":"string","description":"External customer identifier (e.g. organisation customer ID)","uniqueKey":"customer_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"External customer identifier (e.g. organisation customer ID)","uniqueKey":"customer_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_id","typeLabel":"string | null"},"package_id":{"oneOf":[{"type":"string","description":"External package identifier (e.g. workspace/package ID)","uniqueKey":"package_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"External package identifier (e.g. workspace/package ID)","uniqueKey":"package_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"package_id","typeLabel":"string | null"},"metadata":{"type":"object","description":"Optional metadata describing the associated organisation and package","properties":{"customer_name":{"oneOf":[{"type":"string","description":"Human-readable name of the customer or organisation","uniqueKey":"metadata.customer_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable name of the customer or organisation","uniqueKey":"metadata.customer_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata.customer_name","typeLabel":"string | null"},"package_name":{"oneOf":[{"type":"string","description":"Human-readable name of the associated package or workspace","uniqueKey":"metadata.package_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable name of the associated package or workspace","uniqueKey":"metadata.package_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata.package_name","typeLabel":"string | null"}},"uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"key_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","public_key":"\u003cstring>","signature":"\u003cstring>","signed_payload":"\u003cstring>","signed_fields":["\u003cstring>"],"customer_id":"\u003cstring>","package_id":"\u003cstring>","metadata":{"customer_name":"\u003cstring>","package_name":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"43754692-133f-4b3f-9d9b-c5dec2af3b7f":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Error message","uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","description":"Error type","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"cf786376-096d-4187-9d9b-c3a2703843a4":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Error message","uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","description":"Error type","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e5ee00f7-f62c-4f44-82f8-3f3168e410dc":{"bearerAuth":{"description":"Bearer token authentication. Can be either a JWT token or API key.","type":"http","scheme":"bearer","scopes":[]}}},"servers":{"8b7e8c54-5675-4883-a48b-6f7fef9488b5":{"url":"https://service.uat-keys.coincover.com","description":"Sandbox (UAT)"},"af033e22-8ab7-4ee5-93c8-3cb420b0dec5":{"url":"https://service.keys.coincover.com","description":"Production — confirm host with your account manager"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Bearer token authentication. Can be either a JWT token or API key.","type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token authentication. Can be either a JWT token or API key.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"specs/institutional.openapi.json"},"subdomain":"coincover","siteName":"Coincover Developer Docs","title":"Assign a new key - Coincover Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-17T12:13:32.798Z","originalFileLocation":"api-reference/keys/assign-a-new-key.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=\"Creates a new key pair with the enclave, shards the private key, and securely stores the encrypted key shards. organisation and package are optional; key_environment defaults to HOT if omitted.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Coincover Developer 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/coincover/Wnz4s2jyTI4-WRLe/_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/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/coincover/Wnz4s2jyTI4-WRLe/_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/coincover/Wnz4s2jyTI4-WRLe/_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/coincover/Wnz4s2jyTI4-WRLe/_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/coincover/Wnz4s2jyTI4-WRLe/_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/coincover/Wnz4s2jyTI4-WRLe/_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/coincover/Wnz4s2jyTI4-WRLe/_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/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Assign a new key - Coincover Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new key pair with the enclave, shards the private key, and securely stores the encrypted key shards. organisation and package are optional; key_environment defaults to HOT if omitted.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Coincover Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.coincover.com/api-reference/keys/assign-a-new-key\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://coincover.mintlify.site/_mintlify/api/og/v2?division=Keys\u0026amp;title=Assign+a+new+key\u0026amp;description=Creates+a+new+key+pair+with+the+enclave%2C+shards+the+private+key%2C+and+securely+stores+the+encrypted+key+shards.+organisation+and+package+are+optional%3B+key_enviro\u0026amp;theme=e889e042c90bb80030a3389c\u0026amp;signature=c2b025ca4002fbdc951d45ac447da960c638ec48e54071fd93b7a3fc9368a22f\">\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=\"Assign a new key - Coincover Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new key pair with the enclave, shards the private key, and securely stores the encrypted key shards. organisation and package are optional; key_environment defaults to HOT if omitted.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://coincover.mintlify.site/_mintlify/api/og/v2?division=Keys\u0026amp;title=Assign+a+new+key\u0026amp;description=Creates+a+new+key+pair+with+the+enclave%2C+shards+the+private+key%2C+and+securely+stores+the+encrypted+key+shards.+organisation+and+package+are+optional%3B+key_enviro\u0026amp;theme=e889e042c90bb80030a3389c\u0026amp;signature=c2b025ca4002fbdc951d45ac447da960c638ec48e54071fd93b7a3fc9368a22f\">\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/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Coincover Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3939EF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.coincover.com/api-reference/keys/assign-a-new-key\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/keys/assign-a-new-key.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.coincover.com/#organization\",\"name\":\"Coincover Developer Docs\",\"url\":\"https://developer.coincover.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/coincover/YulmKC25AtRiJdum/images/CC-Logo-Black.svg?fit=max\u0026auto=format\u0026n=YulmKC25AtRiJdum\u0026q=85\u0026s=d81d260390cff9797e850679aeec6841\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.coincover.com#website\",\"name\":\"Coincover Developer Docs\",\"url\":\"https://developer.coincover.com\",\"publisher\":{\"@id\":\"https://developer.coincover.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.coincover.com/api-reference/keys/assign-a-new-key#webpage\",\"url\":\"https://developer.coincover.com/api-reference/keys/assign-a-new-key\",\"name\":\"Assign a new key\",\"description\":\"Creates a new key pair with the enclave, shards the private key, and securely stores the encrypted key shards. organisation and package are optional; key_environment defaults to HOT if omitted.\",\"dateModified\":\"2026-09-17T12:13:32.798Z\",\"isPartOf\":{\"@id\":\"https://developer.coincover.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.coincover.com/api-reference/keys/assign-a-new-key#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.coincover.com/api-reference/keys/assign-a-new-key#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://developer.coincover.com/api-reference/keys/partner--assign-a-new-key-with-environment-specification\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Assign a new key\",\"item\":\"https://developer.coincover.com/api-reference/keys/assign-a-new-key\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.coincover.com/api-reference/keys/assign-a-new-key#apireference\",\"headline\":\"Assign a new key\",\"name\":\"Assign a new key\",\"description\":\"Creates a new key pair with the enclave, shards the private key, and securely stores the encrypted key shards. organisation and package are optional; key_environment defaults to HOT if omitted.\",\"url\":\"https://developer.coincover.com/api-reference/keys/assign-a-new-key\",\"mainEntityOfPage\":{\"@id\":\"https://developer.coincover.com/api-reference/keys/assign-a-new-key#webpage\"},\"dateModified\":\"2026-09-17T12:13:32.798Z\",\"publisher\":{\"@id\":\"https://developer.coincover.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.coincover.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Coincover Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Coincover Developer Docs","nav":{"global":null,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":""}]},{"tab":"Products","pages":[{"title":"Products","href":"/wallet-provider-recovery/overview"}]},{"tab":"Partners","pages":[{"title":"Partners","href":"/partner-guides/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/validating-key-signatures"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"group":"Wallet Provider API","pages":[{"group":"Keys","pages":[{"title":"Partner - Assign a new key with environment specification","deprecated":null,"version":null,"openapi":"/specs/wallet-provider.openapi.json post /v1/partner/keys","href":"/api-reference/keys/partner--assign-a-new-key-with-environment-specification"}]},{"group":"Backups","pages":[{"title":"Partner - Store secure encrypted data","deprecated":null,"version":null,"openapi":"/specs/wallet-provider.openapi.json post /v1/partner/secure/data","href":"/api-reference/backups/partner--store-secure-encrypted-data"},{"title":"Partner - Store secure encrypted files","description":"Stores encrypted files securely. The key environment is determined from the provided key. The file must already be encrypted on the partner side; CoinCover applies no additional server-side encryption. Maximum payload 10MB. Partner-only endpoint.","deprecated":null,"version":null,"openapi":"/specs/wallet-provider.openapi.json post /v1/partner/secure/file","href":"/api-reference/backups/partner--store-secure-encrypted-files"}]}]},{"group":"Institutional API","pages":[{"group":"Keys","pages":[{"title":"Assign a new key","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json post /v1/keys","href":"/api-reference/keys/assign-a-new-key"},{"title":"Verify a key's integrity","description":"Verifies that a key's shards can be reconstructed and that the key pair is valid.","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json get /v1/keys/{keyId}/verify","href":"/api-reference/keys/verify-a-keys-integrity"}]},{"group":"Backups","pages":[{"title":"Store secure encrypted data","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json post /v1/secure/data","href":"/api-reference/backups/store-secure-encrypted-data"},{"title":"Store secure encrypted files","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json post /v1/secure/file","href":"/api-reference/backups/store-secure-encrypted-files"},{"title":"Verify a backup's integrity","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json get /v1/backups/{backupId}/verify","href":"/api-reference/backups/verify-a-backups-integrity"}]}]},{"group":"Retail API","pages":[{"group":"Verification","pages":[{"title":"Start identity verification","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/verification/start","href":"/api-reference/verification/start-identity-verification"},{"title":"Get verification status","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json get /v1/verification/{verification_id}/status","href":"/api-reference/verification/get-verification-status"},{"title":"Simulate biometric verification events","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/verification/simulate","href":"/api-reference/verification/simulate-biometric-verification-events"}]},{"group":"Keys","pages":[{"title":"Generate a cryptographic key","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/key/generate","href":"/api-reference/keys/generate-a-cryptographic-key"}]},{"group":"Backups","pages":[{"title":"Store encrypted backup data","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/backup/store","href":"/api-reference/backups/store-encrypted-backup-data"},{"title":"Recover encrypted backup data","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/backup/recover","href":"/api-reference/backups/recover-encrypted-backup-data"}]}]},{"group":"Updates","pages":[{"title":"Changelog","mode":"wide","href":"/changelog/changelog"}]}]}]}]},"basePath":"","title":"Assign a new key - Coincover Developer Docs","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}