Creates a relationship between a specified card (card_id) and another card using a
defined link type (blocks, blocked_by, related, or duplicates).
This relationship helps visualize dependencies or connections between cards.
A 200 response includes details of the linked card.
{
"error": {
"id": "err5f744ab",
"code": 403,
"sec": "SEC:000-00014",
"message": "You do not have access to this resource",
"date": 1608742037016
}
}
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Superthread help center","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/superthread/8Pe5qUtfxBYjsAW7/logo/light.svg?fit=max\u0026auto=format\u0026n=8Pe5qUtfxBYjsAW7\u0026q=85\u0026s=3ec799023892643fb9a9173e31d2cbc2","dark":"https://mintcdn.com/superthread/8Pe5qUtfxBYjsAW7/logo/dark.svg?fit=max\u0026auto=format\u0026n=8Pe5qUtfxBYjsAW7\u0026q=85\u0026s=625cf090d83eb1dec08a314f090bd129","href":"https://superthread.com"},"favicon":"https://mintcdn.com/superthread/8Pe5qUtfxBYjsAW7/favicon.svg?fit=max\u0026auto=format\u0026n=8Pe5qUtfxBYjsAW7\u0026q=85\u0026s=fa1ffa91a2c500722dd37a97c85c7cd5","navbar":{"links":[{"href":"mailto:support@superthread.com","label":"Support"}],"primary":{"type":"button","label":"Try Superthread","href":"https://superthread.com"}},"footer":{"socials":{"x":"https://x.com/superthread_","github":"https://github.com/superthread","linkedin":"https://www.linkedin.com/company/superthread"}},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"superthread","hasAudioNarration":false,"actualSubdomain":"superthread","customDomains":["superthread.com"],"gitSource":{"type":"github","owner":"superthread-com","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4b20ec2eaceb0e3453ecd","collectionId":"c94ba425-32c1-4085-8be9-fa6e54af31f2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4b20ec2eaceb0e3453ecd"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4b20ec2eaceb0e3453ecd","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API docs","count":123},{"language":"default","tag":"Help","count":45},{"language":"default","tag":"Time tracking","count":34},{"language":"default","tag":"Cards","count":14},{"language":"default","tag":"Platform \u0026 integrations","count":12},{"language":"default","tag":"Notes","count":10},{"language":"default","tag":"Pages","count":10},{"language":"default","tag":"Projects","count":10},{"language":"default","tag":"Task management","count":10},{"language":"default","tag":"Comments","count":9}]},"assistantConfig":{"enableAskAiButton":true,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-docs/cards/add-related-card","slug":"/api-docs/cards/add-related-card","pageMetadata":{"title":"Add related card","openapi":"POST /{team_id}/cards/{card_id}/linked_cards","description":"Creates a relationship between a specified card (`card_id`) and another card using a\ndefined link type (`blocks`, `blocked_by`, `related`, or `duplicates`).\nThis relationship helps visualize dependencies or connections between cards.\nA 200 response includes details of the linked card.\n","href":"/api-docs/cards/add-related-card"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Creates a relationship between a specified card (\", _jsx(_components.code, {\n children: \"card_id\"\n }), \") and another card using a\\ndefined link type (\", _jsx(_components.code, {\n children: \"blocks\"\n }), \", \", _jsx(_components.code, {\n children: \"blocked_by\"\n }), \", \", _jsx(_components.code, {\n children: \"related\"\n }), \", or \", _jsx(_components.code, {\n children: \"duplicates\"\n }), \").\\nThis relationship helps visualize dependencies or connections between cards.\\nA 200 response includes details of the linked card.\"]\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":"Add related card","openapi":"POST /{team_id}/cards/{card_id}/linked_cards","description":"Creates a relationship between a specified card (`card_id`) and another card using a\ndefined link type (`blocks`, `blocked_by`, `related`, or `duplicates`).\nThis relationship helps visualize dependencies or connections between cards.\nA 200 response includes details of the linked card.\n","href":"/api-docs/cards/add-related-card"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Link a card with another","description":"Creates a relationship between a specified card (`card_id`) and another card using a\ndefined link type (`blocks`, `blocked_by`, `related`, or `duplicates`).\nThis relationship helps visualize dependencies or connections between cards.\nA 200 response includes details of the linked card.\n","operationId":"addLinkedCard","x-ai-agent":true,"x-excluded":true,"tags":["Boards","Cards"],"requestBody":"eec336d1-7a8b-445c-828a-4ea99cced0d7","responses":{"200":"ac7c7833-9100-423e-b38f-8c2779cb4c1d","default":"c7f3350f-9458-47aa-9cdc-b8347233928f"},"method":"post","type":"path","servers":["c37be052-6148-4ecf-b35d-32848cca42a7"],"security":["54f21800-c560-43ca-86a6-b1396b396cc5"],"path":"/{team_id}/cards/{card_id}/linked_cards","baseUrlOptions":["https://api.superthread.com/v1"],"title":"Link a card with another","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b2e52e78-dfc5-47c9-b55c-799f99e37fe5":{"in":"path","name":"team_id","description":"Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a \"Workspace\".","required":true,"schema":{"type":"string","isRequired":true,"description":"Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a \"Workspace\".","uniqueKey":"","typeLabel":"string"}},"fa4dfe88-3443-4d91-8b6e-b8e7350399a7":{"in":"path","name":"card_id","description":"Card ID is a numerical string that identifies a card.","required":true,"schema":{"type":"string","isRequired":true,"description":"Card ID is a numerical string that identifies a card.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["card_id","linked_card_type"],"properties":{"card_id":{"type":"string","example":"41","description":"ID of the card which was linked with current card","isRequired":true,"uniqueKey":"card_id","typeLabel":"string"},"linked_card_type":{"type":"string","enum":["blocks","blocked_by","related","duplicates"],"example":"blocks","isRequired":true,"uniqueKey":"linked_card_type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"card_id":"41","linked_card_type":"blocks"}}},"exampleType":"generated"}},"description":"Create linked card request details","required":true,"exampleType":"generated"},"responses":{"ac7c7833-9100-423e-b38f-8c2779cb4c1d":{"description":"Linked card successfully created","content":{"application/json":{"schema":{"type":"object","properties":{"linked_card":{"type":"object","properties":{"title":{"type":"string","example":"Create illustration for upcoming holidays","uniqueKey":"linked_card.title","typeLabel":"string"},"card_id":{"type":"string","example":"42","x-go-custom-tag":"diff:\"card_id,identifier\"","uniqueKey":"linked_card.card_id","typeLabel":"string"},"user_id":{"type":"string","example":"42","uniqueKey":"linked_card.user_id","typeLabel":"string"},"project_id":{"type":"string","example":"3","uniqueKey":"linked_card.project_id","typeLabel":"string"},"board_id":{"type":"string","example":"15","uniqueKey":"linked_card.board_id","typeLabel":"string"},"board_title":{"type":"string","example":"Ideas","uniqueKey":"linked_card.board_title","typeLabel":"string"},"list_id":{"type":"string","example":"list 1","uniqueKey":"linked_card.list_id","typeLabel":"string"},"list_title":{"type":"string","example":"list 1","uniqueKey":"linked_card.list_title","typeLabel":"string"},"status":{"type":"string","enum":["committed","started","completed","cancelled"],"example":"started","uniqueKey":"linked_card.status","typeLabel":"enum\u003cstring>"},"archived":{"type":"object","properties":{"user_id":{"type":"string","example":"uDsu0j19","uniqueKey":"linked_card.archived.user_id","typeLabel":"string"},"time_archived":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"linked_card.archived.time_archived","typeLabel":"integer\u003cint64>"}},"uniqueKey":"linked_card.archived","typeLabel":"object"},"linked_card_type":{"type":"string","enum":["blocks","blocked_by","related","duplicates"],"example":"blocks","uniqueKey":"linked_card.linked_card_type","typeLabel":"enum\u003cstring>"},"icon":{"type":"object","required":["type","src"],"properties":{"type":{"type":"string","enum":["image","icon","emoji"],"nullable":false,"isRequired":true,"uniqueKey":"linked_card.icon.type","typeLabel":"enum\u003cstring>"},"src":{"type":"string","example":"data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==","description":"Depending on the type this can be a URL, base64 image data, emoji unicode or an icon name","nullable":false,"isRequired":true,"uniqueKey":"linked_card.icon.src","typeLabel":"string"},"id":{"type":"string","description":"Unique identifier for the image (optional).","uniqueKey":"linked_card.icon.id","typeLabel":"string"},"blurhash":{"type":"string","example":"LEHV6nWB2yk8pyoJadR*.7kCMdnj","x-go-custom-tag":"dynamodbav:\",omitempty\"","uniqueKey":"linked_card.icon.blurhash","typeLabel":"string"},"color":{"type":"string","example":"black","x-go-custom-tag":"dynamodbav:\",omitempty\"","uniqueKey":"linked_card.icon.color","typeLabel":"string"},"emoji":{"type":"string","example":"thumbsup","description":"Emoji string ID","x-go-custom-tag":"dynamodbav:\",omitempty\"","uniqueKey":"linked_card.icon.emoji","typeLabel":"string"}},"uniqueKey":"linked_card.icon","typeLabel":"object"}},"uniqueKey":"linked_card","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"linked_card":{"title":"Create illustration for upcoming holidays","card_id":"42","user_id":"42","project_id":"3","board_id":"15","board_title":"Ideas","list_id":"list 1","list_title":"list 1","status":"started","archived":{"user_id":"uDsu0j19","time_archived":1608742037016},"linked_card_type":"blocks","icon":{"type":"image","src":"data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==","id":"\u003cstring>","blurhash":"LEHV6nWB2yk8pyoJadR*.7kCMdnj","color":"black","emoji":"thumbsup"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"c7f3350f-9458-47aa-9cdc-b8347233928f":{"description":"client error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"id":{"type":"string","example":"err5f744ab","uniqueKey":"error.id","typeLabel":"string"},"code":{"type":"integer","format":"int32","example":403,"uniqueKey":"error.code","typeLabel":"integer\u003cint32>"},"sec":{"type":"string","description":"Superthread Error Code (`SEC`): A structured error code.\nFormat: `SEC:{ServiceID}-{InternalErrorCode}`.\n\n\n - `SEC`: Prefix for all structured error codes.\n - `ServiceID`: First 3 characters identify the service, '000' is reserved for generic errors.\n - `InternalErrorCode`: the next (last) 5 characters define the specific error.\n","pattern":"^SEC:\\d{3}-\\d{5}$","example":"SEC:000-00014","uniqueKey":"error.sec","typeLabel":"string"},"message":{"type":"string","example":"You do not have access to this resource","description":"A user-friendly error message","uniqueKey":"error.message","typeLabel":"string"},"date":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"error.date","typeLabel":"integer\u003cint64>"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"id":"err5f744ab","code":403,"sec":"SEC:000-00014","message":"You do not have access to this resource","date":1608742037016}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"54f21800-c560-43ca-86a6-b1396b396cc5":{"BearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"c37be052-6148-4ecf-b35d-32848cca42a7":{"url":"https://api.superthread.com/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"superthread.yaml"},"subdomain":"superthread","siteName":"Superthread help center","title":"Add related card - Superthread help center","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-26T11:26:00.280Z","originalFileLocation":"api-docs/cards/add-related-card.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 relationship between a specified card (card_id) and another card using a defined link type (blocks, blocked_by, related, or duplicates). This relationship helps visualize dependencies or connections between cards. A 200 response includes details of the linked card.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Superthread help center\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_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=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add related card - Superthread help center\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a relationship between a specified card (card_id) and another card using a defined link type (blocks, blocked_by, related, or duplicates). This relationship helps visualize dependencies or connections between cards. A 200 response includes details of the linked card.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Superthread help center\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://superthread.com/docs/api-docs/cards/add-related-card\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://superthread.mintlify.app/_mintlify/api/og/v2?division=Cards\u0026amp;title=Add+related+card\u0026amp;description=Creates+a+relationship+between+a+specified+card+%28%60card_id%60%29+and+another+card+using+a%0Adefined+link+type+%28%60blocks%60%2C+%60blocked_by%60%2C+%60related%60%2C+or+%60duplicates%60%29.%0AThi\u0026amp;theme=12ef36890fcbcd2fc595f246\u0026amp;signature=c76dbe29a070091ce676c89f32b32d7855106b503327228a41070a68da38876d\">\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=\"Add related card - Superthread help center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a relationship between a specified card (card_id) and another card using a defined link type (blocks, blocked_by, related, or duplicates). This relationship helps visualize dependencies or connections between cards. A 200 response includes details of the linked card.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://superthread.mintlify.app/_mintlify/api/og/v2?division=Cards\u0026amp;title=Add+related+card\u0026amp;description=Creates+a+relationship+between+a+specified+card+%28%60card_id%60%29+and+another+card+using+a%0Adefined+link+type+%28%60blocks%60%2C+%60blocked_by%60%2C+%60related%60%2C+or+%60duplicates%60%29.%0AThi\u0026amp;theme=12ef36890fcbcd2fc595f246\u0026amp;signature=c76dbe29a070091ce676c89f32b32d7855106b503327228a41070a68da38876d\">\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=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Superthread help center\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://superthread.com/docs/api-docs/cards/add-related-card\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-docs/cards/add-related-card.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://superthread.com/#organization\",\"name\":\"Superthread help center\",\"url\":\"https://superthread.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/superthread/8Pe5qUtfxBYjsAW7/logo/light.svg?fit=max\u0026auto=format\u0026n=8Pe5qUtfxBYjsAW7\u0026q=85\u0026s=3ec799023892643fb9a9173e31d2cbc2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://superthread.com/docs#website\",\"name\":\"Superthread help center\",\"url\":\"https://superthread.com/docs\",\"publisher\":{\"@id\":\"https://superthread.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://superthread.com/docs/api-docs/cards/add-related-card#webpage\",\"url\":\"https://superthread.com/docs/api-docs/cards/add-related-card\",\"name\":\"Add related card\",\"description\":\"Creates a relationship between a specified card (card_id) and another card using a defined link type (blocks, blocked_by, related, or duplicates). This relationship helps visualize dependencies or connections between cards. A 200 response includes details of the linked card.\",\"dateModified\":\"2026-01-26T11:26:00.280Z\",\"isPartOf\":{\"@id\":\"https://superthread.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://superthread.com/docs/api-docs/cards/add-related-card#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://superthread.com/docs/api-docs/cards/add-related-card#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cards\",\"item\":\"https://superthread.com/docs/api-docs/cards/create-a-card\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add related card\",\"item\":\"https://superthread.com/docs/api-docs/cards/add-related-card\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://superthread.com/docs/api-docs/cards/add-related-card#apireference\",\"headline\":\"Add related card\",\"name\":\"Add related card\",\"description\":\"Creates a relationship between a specified card (card_id) and another card using a defined link type (blocks, blocked_by, related, or duplicates). This relationship helps visualize dependencies or connections between cards. A 200 response includes details of the linked card.\",\"url\":\"https://superthread.com/docs/api-docs/cards/add-related-card\",\"mainEntityOfPage\":{\"@id\":\"https://superthread.com/docs/api-docs/cards/add-related-card#webpage\"},\"dateModified\":\"2026-01-26T11:26:00.280Z\",\"publisher\":{\"@id\":\"https://superthread.com/#organization\"},\"isPartOf\":{\"@id\":\"https://superthread.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Superthread help center\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Superthread help center","nav":{"global":{},"tabs":[{"tab":"Help","pages":[{"title":"Help","href":""}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"API docs","groups":[{"group":"Get started","pages":[{"title":"Authentication","href":"/api-docs/auth"},{"title":"API terminology","href":"/api-docs/api-terminology"}]},{"group":"Users","pages":[{"title":"Get my account","openapi":"GET /users/{user_id}","href":"/api-docs/users/get-my-account"},{"title":"Update my account","openapi":"PATCH /users/{user_id}","href":"/api-docs/users/update-my-account"},{"title":"Get team members","openapi":"GET /teams/{team_id}/members","href":"/api-docs/users/get-team-members"},{"title":"Update a team member","openapi":"PATCH /teams/{team_id}/members/{user_id}","href":"/api-docs/users/update-a-team-member"},{"title":"Delete a team member","openapi":"DELETE /teams/{team_id}/members/{user_id}","href":"/api-docs/users/delete-a-team-member"}]},{"group":"Cards","pages":[{"title":"Create a card","openapi":"POST /{team_id}/cards","href":"/api-docs/cards/create-a-card"},{"title":"Update a card property","openapi":"PATCH /{team_id}/cards/{card_id}","href":"/api-docs/cards/update-a-card"},{"title":"Replace a card description","openapi":"PUT /{team_id}/cards/{card_id}/content","href":"/api-docs/cards/replace-a-card-description"},{"title":"Get tags","openapi":"GET /{team_id}/tags","href":"/api-docs/cards/get-tags"},{"title":"Add tags to a card","openapi":"POST /{team_id}/cards/{card_id}/tags","href":"/api-docs/cards/add-tags"},{"title":"Remove a tag from a card","openapi":"DELETE /{team_id}/cards/{card_id}/tags/{tag_id}","href":"/api-docs/cards/remove-a-tag"},{"title":"Get a card","openapi":"GET /{team_id}/cards/{card_id}","href":"/api-docs/cards/get-a-card"},{"title":"Get card activity","openapi":"GET /{team_id}/activity","href":"/api-docs/cards/get-card-activity"},{"title":"Duplicate a card","openapi":"POST /{team_id}/cards/{card_id}/copy","href":"/api-docs/cards/duplicate-a-card"},{"title":"Get cards assigned to a user","openapi":"POST /{team_id}/views/preview","description":"This endpoint provides a preview of results based on specified filters for boards, cards,\nor pages. The request includes a type parameter (board, card, or page) and supports\nadvanced filtering criteria, such as time ranges, specific project or member associations,\nand sorting preferences.\nPagination is supported via cursor and count parameters.\n","href":"/api-docs/cards/get-cards"},{"title":"Add related card","openapi":"POST /{team_id}/cards/{card_id}/linked_cards","href":"/api-docs/cards/add-related-card"},{"title":"Remove related card","openapi":"DELETE /{team_id}/cards/{card_id}/linked_cards/{linked_card_id}","description":"Deletes an existing link between the specified card (`card_id`) and a linked card (`linked_card_id`).\nThis operation is used to remove relationships between cards.\nA 204 response indicates the link was successfully removed.\n","href":"/api-docs/cards/remove-related-card"},{"title":"Archive a card","openapi":"PATCH /{team_id}/cards/{card_id}","href":"/api-docs/cards/archive-a-card"},{"title":"Delete a card","openapi":"DELETE /{team_id}/cards/{card_id}","href":"/api-docs/cards/delete-a-card"}]},{"group":"Projects","pages":[{"title":"Create a project","openapi":"POST /{team_id}/epics","href":"/api-docs/projects/create-a-project"},{"title":"Update a project","openapi":"PATCH /{team_id}/epics/{epic_id}","href":"/api-docs/projects/update-a-project"},{"title":"Replace a project description","openapi":"PUT /{team_id}/epics/{epic_id}/content","href":"/api-docs/projects/replace-a-project-description"},{"title":"Get a project","openapi":"GET /{team_id}/epics/{epic_id}","href":"/api-docs/projects/get-a-project"},{"title":"Get project activity","openapi":"GET /{team_id}/activity","href":"/api-docs/projects/get-project-activity"},{"title":"Get projects","openapi":"GET /{team_id}/epics","href":"/api-docs/projects/get-projects"},{"title":"Add related project","openapi":"POST /{team_id}/cards/{card_id}/linked_cards","href":"/api-docs/projects/add-related-project"},{"title":"Remove related project","openapi":"DELETE /{team_id}/cards/{card_id}/linked_cards/{linked_card_id}","href":"/api-docs/projects/remove-related-project"},{"title":"Archive a project","openapi":"PATCH /{team_id}/epics/{epic_id}","href":"/api-docs/projects/archive-a-project"},{"title":"Delete a project","openapi":"DELETE /{team_id}/epics/{epic_id}","href":"/api-docs/projects/delete-a-project"}]},{"group":"Notes","pages":[{"title":"Create a note","openapi":"POST /{team_id}/notes","href":"/api-docs/notes/create-a-note"},{"title":"Get a note","openapi":"GET /{team_id}/notes/{note_id}","href":"/api-docs/notes/get-a-note"},{"title":"Get notes","openapi":"GET /{team_id}/notes","href":"/api-docs/notes/get-notes"},{"title":"Delete a note","openapi":"DELETE /{team_id}/notes/{note_id}","href":"/api-docs/notes/delete-a-note"},{"title":"Enhance or revise a note","openapi":"POST /{team_id}/notes/{note_id}/enhancement","href":"/api-docs/notes/enhance-a-note"},{"title":"Observe a note enhancement","openapi":"GET /{team_id}/notes/{note_id}/enhancement","href":"/api-docs/notes/get-note-enhancement"},{"title":"Update an enhanced note","openapi":"PATCH /{team_id}/notes/{note_id}/enhanced/{enhanced_note_id}","href":"/api-docs/notes/update-enhanced-note"},{"title":"List note templates","openapi":"GET /{team_id}/notes/templates","href":"/api-docs/notes/get-note-templates"},{"title":"Get a note template","openapi":"GET /{team_id}/notes/templates/{template_id}","href":"/api-docs/notes/get-note-template"},{"title":"Update a note template","openapi":"PATCH /{team_id}/notes/templates/{template_id}","href":"/api-docs/notes/update-note-template"}]},{"group":"Pages","pages":[{"title":"Create a page","openapi":"POST /{team_id}/pages","href":"/api-docs/pages/create-a-page"},{"title":"Update a page property","openapi":"PATCH /{team_id}/pages/{page_id}","href":"/api-docs/pages/update-a-page"},{"title":"Replace a page's content","openapi":"PUT /{team_id}/pages/{page_id}/content","href":"/api-docs/pages/replace-a-page-content"},{"title":"Get a page","openapi":"GET /{team_id}/pages/{page_id}","href":"/api-docs/pages/get-a-page"},{"title":"Duplicate a page","openapi":"POST /{team_id}/pages/{page_id}/copy","href":"/api-docs/pages/duplicate-a-page"},{"title":"Get pages","openapi":"GET /{team_id}/pages","href":"/api-docs/pages/get-pages"},{"title":"Archive a page","openapi":"PUT /{team_id}/pages/{page_id}/archive","href":"/api-docs/pages/archive-a-page"},{"title":"Delete a page","openapi":"DELETE /{team_id}/pages/{page_id}","href":"/api-docs/pages/delete-a-page"},{"title":"Delete a page icon","openapi":"DELETE /{team_id}/pages/{page_id}/icon","href":"/api-docs/pages/delete-page-icon"},{"title":"Delete a page cover image","openapi":"DELETE /{team_id}/pages/{page_id}/cover","href":"/api-docs/pages/delete-page-cover-image"}]},{"group":"Comments","pages":[{"title":"Create a comment","openapi":"POST /{team_id}/comments","href":"/api-docs/comments/create-a-comment"},{"title":"Edit a comment","openapi":"PATCH /{team_id}/comments/{comment_id}","href":"/api-docs/comments/edit-a-comment"},{"title":"Get a comment","openapi":"GET /{team_id}/comments/{comment_id}","href":"/api-docs/comments/get-a-comment"},{"title":"Get comments for a resource","openapi":"GET /{team_id}/comments","href":"/api-docs/comments/get-comments"},{"title":"Get replies to a comment","openapi":"GET /{team_id}/comments/{comment_id}/children","href":"/api-docs/comments/get-replies"},{"title":"Reply to a comment","openapi":"POST /{team_id}/comments/{comment_id}/children","href":"/api-docs/comments/reply-to-a-comment"},{"title":"Edit a reply","openapi":"PATCH /{team_id}/comments/{comment_id}/children/{child_comment_id}","href":"/api-docs/comments/edit-a-reply"},{"title":"Delete a reply","openapi":"DELETE /{team_id}/comments/{comment_id}/children/{child_comment_id}","href":"/api-docs/comments/delete-a-reply"},{"title":"Delete a comment","openapi":"DELETE /{team_id}/comments/{comment_id}","href":"/api-docs/comments/delete-a-comment"}]},{"group":"Boards","pages":[{"title":"Create a board","openapi":"POST /{team_id}/boards","href":"/api-docs/boards/create-a-board"},{"title":"Update a board","openapi":"PATCH /{team_id}/boards/{board_id}","href":"/api-docs/boards/update-a-board"},{"title":"Create a list","openapi":"POST /{team_id}/lists","href":"/api-docs/boards/create-a-list"},{"title":"Update a list","openapi":"PATCH /{team_id}/lists/{list_id}","href":"/api-docs/boards/update-a-list"},{"title":"Duplicate a board","openapi":"POST /{team_id}/boards/{board_id}/copy","href":"/api-docs/boards/duplicate-a-board"},{"title":"Get a board","openapi":"GET /{team_id}/boards/{board_id}","href":"/api-docs/boards/get-a-board"},{"title":"Get boards","openapi":"GET /{team_id}/boards","href":"/api-docs/boards/get-boards"},{"title":"Delete a board","openapi":"DELETE /{team_id}/boards/{board_id}","href":"/api-docs/boards/delete-a-board"}]},{"group":"Sprints","pages":[{"title":"Create a sprint","openapi":"POST /{team_id}/sprints","href":"/api-docs/sprints/create-a-sprint"},{"title":"Update a sprint","openapi":"PATCH /{team_id}/sprints/{sprint_id}","href":"/api-docs/sprints/update-a-sprint"},{"title":"Get a sprint","openapi":"GET /{team_id}/sprints/{sprint_id}","href":"/api-docs/sprints/get-a-sprint"},{"title":"Get sprints","openapi":"GET /{team_id}/sprints","href":"/api-docs/sprints/get-sprints"},{"title":"Get sprint settings","openapi":"GET /{team_id}/sprints/settings","href":"/api-docs/sprints/get-sprint-settings"},{"title":"Update sprint settings","openapi":"PUT /{team_id}/sprints/settings","href":"/api-docs/sprints/update-sprint-settings"}]},{"group":"Spaces","pages":[{"title":"Create a space","openapi":"POST /{team_id}/projects","href":"/api-docs/spaces/create-a-space"},{"title":"Update a space","openapi":"PATCH /{team_id}/projects/{project_id}","href":"/api-docs/spaces/update-a-space"},{"title":"Get a space","openapi":"GET /{team_id}/projects/{project_id}","href":"/api-docs/spaces/get-a-space"},{"title":"Get spaces","openapi":"GET /{team_id}/projects","href":"/api-docs/spaces/get-spaces"},{"title":"Add a member to a space","openapi":"POST /{team_id}/projects/{project_id}/members","href":"/api-docs/spaces/add-member-to-a-space"},{"title":"Remove a member from a space","openapi":"DELETE /{team_id}/projects/{project_id}/members/{user_id}","href":"/api-docs/spaces/remove-member-from-a-space"},{"title":"Delete a space","openapi":"DELETE /{team_id}/projects/{project_id}","href":"/api-docs/spaces/delete-a-space"}]},{"group":"Saved filters","pages":[{"title":"Create a saved filter","openapi":"POST /{team_id}/views","href":"/api-docs/saved-filters/create-a-saved-filter"},{"title":"Update a saved filter","openapi":"PATCH /{team_id}/views/{view_id}","href":"/api-docs/saved-filters/update-a-saved-filter"},{"title":"Get a saved filter","openapi":"GET /{team_id}/views/{view_id}","href":"/api-docs/saved-filters/get-a-saved-filter"},{"title":"Get saved filters","openapi":"GET /{team_id}/views","href":"/api-docs/saved-filters/get-saved-filters"},{"title":"Get saved filter results","openapi":"GET /{team_id}/views/{view_id}/results","href":"/api-docs/saved-filters/get-saved-filter-results"},{"title":"Find cards, pages or boards","openapi":"POST /{team_id}/views/preview","href":"/api-docs/saved-filters/find-cards-pages-or-boards"},{"title":"Delete a saved filter","openapi":"DELETE /{team_id}/views/{view_id}","href":"/api-docs/saved-filters/delete-a-saved-filter"}]},{"group":"Time tracking","pages":[{"title":"Query time reports","openapi":"GET /{team_id}/time/reports","href":"/api-docs/time-tracking/query-time-reports"},{"title":"Export time reports","openapi":"GET /{team_id}/time/reports/export","href":"/api-docs/time-tracking/export-time-reports"},{"title":"List time estimates","openapi":"GET /{team_id}/time/estimates","href":"/api-docs/time-tracking/list-time-estimates"},{"title":"Save a time estimate","openapi":"PATCH /{team_id}/time/estimates/{card_id}","href":"/api-docs/time-tracking/save-a-time-estimate"},{"title":"Get card time summary","openapi":"GET /{team_id}/time/cards/{card_id}","href":"/api-docs/time-tracking/get-card-time-summary"},{"title":"List space time tracking configs","openapi":"GET /{team_id}/time/tracking/spaces","href":"/api-docs/time-tracking/list-space-time-tracking-configs"},{"title":"Get time entry lock","openapi":"GET /{team_id}/time/tracking/lock","href":"/api-docs/time-tracking/get-time-entry-lock"},{"title":"List or aggregate time entries","openapi":"GET /{team_id}/time/entries","href":"/api-docs/time-tracking/list-or-aggregate-time-entries"},{"title":"Create a time entry","openapi":"POST /{team_id}/time/entries","href":"/api-docs/time-tracking/create-a-time-entry"},{"title":"Get a time entry","openapi":"GET /{team_id}/time/entries/{time_entry_id}","href":"/api-docs/time-tracking/get-a-time-entry"},{"title":"Update a time entry","openapi":"PATCH /{team_id}/time/entries/{time_entry_id}","href":"/api-docs/time-tracking/update-a-time-entry"},{"title":"Delete a time entry","openapi":"DELETE /{team_id}/time/entries/{time_entry_id}","href":"/api-docs/time-tracking/delete-a-time-entry"},{"title":"Get active timer","openapi":"GET /{team_id}/time/timer","href":"/api-docs/time-tracking/get-active-timer"},{"title":"Start a timer","openapi":"POST /{team_id}/time/timer","href":"/api-docs/time-tracking/start-a-timer"},{"title":"Stop a timer","openapi":"DELETE /{team_id}/time/timer","href":"/api-docs/time-tracking/stop-a-timer"},{"title":"List time categories","openapi":"GET /{team_id}/time/categories","href":"/api-docs/time-tracking/list-time-categories"},{"title":"Create a time category","openapi":"POST /{team_id}/time/categories","href":"/api-docs/time-tracking/create-a-time-category"},{"title":"Update a time category","openapi":"PATCH /{team_id}/time/categories/{time_category_id}","href":"/api-docs/time-tracking/update-a-time-category"},{"title":"Archive a time category","openapi":"DELETE /{team_id}/time/categories/{time_category_id}","href":"/api-docs/time-tracking/archive-a-time-category"},{"title":"Get workspace rate config","openapi":"GET /{team_id}/time/tracking/config","href":"/api-docs/time-tracking/get-workspace-rate-config"},{"title":"Update workspace rate config","openapi":"PATCH /{team_id}/time/tracking/config","href":"/api-docs/time-tracking/update-workspace-rate-config"},{"title":"Get space time tracking config","openapi":"GET /{team_id}/time/tracking/spaces/{project_id}/config","href":"/api-docs/time-tracking/get-space-time-tracking-config"},{"title":"Update space time tracking config","openapi":"PATCH /{team_id}/time/tracking/spaces/{project_id}/config","href":"/api-docs/time-tracking/update-space-time-tracking-config"},{"title":"List per-user rate overrides","openapi":"GET /{team_id}/time/tracking/overrides","href":"/api-docs/time-tracking/list-user-rate-overrides"},{"title":"Set a per-user rate override","openapi":"PUT /{team_id}/time/tracking/overrides","href":"/api-docs/time-tracking/set-user-rate-override"},{"title":"Clear a per-user rate override","openapi":"DELETE /{team_id}/time/tracking/overrides","href":"/api-docs/time-tracking/clear-user-rate-override"},{"title":"Lock time entries","openapi":"POST /{team_id}/time/tracking/lock","href":"/api-docs/time-tracking/lock-time-entries"},{"title":"Unlock time entries","openapi":"DELETE /{team_id}/time/tracking/lock","href":"/api-docs/time-tracking/unlock-time-entries"},{"title":"Query the time tracking audit log","openapi":"GET /{team_id}/time/tracking/audit","href":"/api-docs/time-tracking/query-time-tracking-audit-log"},{"title":"Time report by user","openapi":"GET /{team_id}/time/reports/user","href":"/api-docs/time-tracking/time-report-by-user"},{"title":"Time report by week","openapi":"GET /{team_id}/time/reports/week","href":"/api-docs/time-tracking/time-report-by-week"},{"title":"Time report by project","openapi":"GET /{team_id}/time/reports/project","href":"/api-docs/time-tracking/time-report-by-project"},{"title":"Time report by category","openapi":"GET /{team_id}/time/reports/category","href":"/api-docs/time-tracking/time-report-by-category"},{"title":"Time report by billable status","openapi":"GET /{team_id}/time/reports/billable","href":"/api-docs/time-tracking/time-report-by-billable"}]},{"group":"Search","pages":[{"title":"Get search results","openapi":"GET /{team_id}/search","href":"/api-docs/search/get-search-results"}]}]},{"tab":"CLI reference","pages":[{"title":"CLI reference","href":"/cli"}]}]},"basePath":"","title":"Add related card - Superthread help center","buildId":"dpl_4RHMRqtvdHvKgaEfTTjFqjzja3B6","deploymentId":"dpl_4RHMRqtvdHvKgaEfTTjFqjzja3B6","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-D_4Sesi0.js","utils-DRHeK26p.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C6d-DUc2.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dex7slho.js","snippetPresets-BcCEBp0Z.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BoJxk0m8.js","ApiExamples-CufowNTX.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-A4lJSCIe.js","shallow-DqoHP7zn.js","getApiPlaygroundDisplay-Cku8AmtL.js","CodeSnippet-CtHQbNqc.js","CodeSnippets-CGo5Cslf.js","getPastedJson-M-bKdue4.js","icon-DEqCU4st.js","MethodPill-DnfSSXiJ.js","DuplicateIcon-BHu2PE8M.js","createIcon-BPsE5X7c.js","DynamicMarkdown-Dnt6YhtR.js","SectionHeading-6CtFWqMQ.js","axios-vUo_bRtp.js","Markdown-BoKe_1fI.js","clsx-DM5-sUNJ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CkIdkovK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-B3e6Nh_r.js"]}