Returns the full task including assignments. PERSONAL tasks are only
returned for their creator; RING tasks are visible to any tenant member.
Returns 404 when the task doesn’t exist or isn’t visible to the caller.
GET
/
v1
/
tasks
/
{task_id}
Fetch a single task by id.
curl --request GET \ --url https://production-api.joinrings.com/v1/tasks/{task_id} \ --header 'x-api-key: <api-key>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Rings AI","description":"Relationship intelligence for businesses that win on their networks. Build on Rings with the REST API or connect AI agents via MCP.","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/Group5.svg?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=bbbf7303b09ab9978ffaee9e90f250ec","dark":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/Group5.svg?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=bbbf7303b09ab9978ffaee9e90f250ec"},"favicon":{"light":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/icon-original.png?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=968ab65ef5c4793a38135dd4d6868876","dark":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/icon-original.png?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=968ab65ef5c4793a38135dd4d6868876"},"api":{"openapi":"https://production-api.joinrings.com/openapi.json"},"appearance":{"default":"dark"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://www.rings.ai","label":"Website"}],"primary":{"type":"button","label":"Get Started","href":"https://joinrings.com"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"markdown":{"schema":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"rings-ai","hasAudioNarration":false,"actualSubdomain":"rings-ai","customDomains":["docs.rings.ai"],"gitSource":{"type":"github","owner":"rings-ai","repo":"rcp-data-pipeline","deployBranch":"main","contentDirectory":"mintlify_docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"f2baa2ef-5f3c-4fb9-b645-454aa43e6c38","liveDeploymentHistoryId":"6ae3521290bdcff7cbc3b51f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae3521290bdcff7cbc3b51f"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae3521290bdcff7cbc3b51f","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":77},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Opportunity","count":11},{"language":"default","tag":"MCP Guide","count":11},{"language":"default","tag":"Add the connector","count":10},{"language":"default","tag":"Note","count":9},{"language":"default","tag":"Person","count":9},{"language":"default","tag":"Activity","count":8},{"language":"default","tag":"Company","count":7},{"language":"default","tag":"Task","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/task/get-task","slug":"/api-reference/task/get-task","pageMetadata":{"title":"Get a task","openapi":"GET /v1/tasks/{task_id}","description":"\nReturns the full task including assignments. PERSONAL tasks are only\nreturned for their creator; RING tasks are visible to any tenant member.\nReturns 404 when the task doesn't exist or isn't visible to the caller.","href":"/api-reference/task/get-task"},"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: \"Returns the full task including assignments. PERSONAL tasks are only\\nreturned for their creator; RING tasks are visible to any tenant member.\\nReturns 404 when the task doesn’t exist or isn’t visible to the caller.\"\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":"Get a task","openapi":"GET /v1/tasks/{task_id}","description":"\nReturns the full task including assignments. PERSONAL tasks are only\nreturned for their creator; RING tasks are visible to any tenant member.\nReturns 404 when the task doesn't exist or isn't visible to the caller.","href":"/api-reference/task/get-task"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"\nReturns the full task including assignments. PERSONAL tasks are only\nreturned for their creator; RING tasks are visible to any tenant member.\nReturns 404 when the task doesn't exist or isn't visible to the caller.","operationId":"get_get_task_endpoint","parameters":["41b27aa9-9d0b-4c06-9dc8-34d61a2ae4de"],"responses":{"200":"ad3d1c89-a8ae-45b0-aa19-77c0f219ef6e"},"summary":"Fetch a single task by id.","tags":["Task"],"method":"get","type":"path","servers":["ac0c72ea-24cd-42c5-bf7e-af9869eeb624"],"security":["d3e1b4d8-8e73-42d2-8242-48f05e417bca"],"path":"/v1/tasks/{task_id}","baseUrlOptions":["https://production-api.joinrings.com"],"title":"Fetch a single task by id.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"41b27aa9-9d0b-4c06-9dc8-34d61a2ae4de":{"in":"path","name":"task_id","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"ad3d1c89-a8ae-45b0-aa19-77c0f219ef6e":{"content":{"application/json":{"schema":{"properties":{"id":{"title":"Id","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"assignments":{"items":{"properties":{"id":{"title":"Id","type":"string","isRequired":true,"uniqueKey":"assignments.items.[INDEX].id","typeLabel":"string"},"assigned_by_uuid":{"oneOf":[{"type":"string","title":"Assigned By Uuid","uniqueKey":"assignments.items.[INDEX].assigned_by_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Assigned By Uuid","uniqueKey":"assignments.items.[INDEX].assigned_by_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"assignments.items.[INDEX].assigned_by_uuid","typeLabel":"string | null"},"assigned_to_uuid":{"oneOf":[{"type":"string","title":"Assigned To Uuid","uniqueKey":"assignments.items.[INDEX].assigned_to_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Assigned To Uuid","uniqueKey":"assignments.items.[INDEX].assigned_to_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"assignments.items.[INDEX].assigned_to_uuid","typeLabel":"string | null"},"created_at":{"oneOf":[{"type":"string","title":"Created At","uniqueKey":"assignments.items.[INDEX].created_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Created At","uniqueKey":"assignments.items.[INDEX].created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"assignments.items.[INDEX].created_at","typeLabel":"string | null"}},"required":["id"],"title":"TaskAssignmentResponse","type":"object","uniqueKey":"assignments.items.[INDEX]","typeLabel":"TaskAssignmentResponse · object"},"title":"Assignments","type":"array","uniqueKey":"assignments","typeLabel":"TaskAssignmentResponse · object[]"},"content":{"oneOf":[{"type":"object","title":"Content","additionalProperties":true,"uniqueKey":"content.oneOf.0","typeLabel":"Content · object"},{"type":"null","title":"Content","uniqueKey":"content.oneOf.1","typeLabel":"null"}],"uniqueKey":"content","typeLabel":"Content · object | null"},"created_at":{"oneOf":[{"type":"string","title":"Created At","uniqueKey":"created_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Created At","uniqueKey":"created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_at","typeLabel":"string | null"},"created_by_uuid":{"oneOf":[{"type":"string","title":"Created By Uuid","uniqueKey":"created_by_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Created By Uuid","uniqueKey":"created_by_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_by_uuid","typeLabel":"string | null"},"due_date":{"oneOf":[{"type":"string","title":"Due Date","uniqueKey":"due_date.oneOf.0","typeLabel":"string"},{"type":"null","title":"Due Date","uniqueKey":"due_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"due_date","typeLabel":"string | null"},"priority":{"oneOf":[{"type":"string","title":"Priority","uniqueKey":"priority.oneOf.0","typeLabel":"string"},{"type":"null","title":"Priority","uniqueKey":"priority.oneOf.1","typeLabel":"null"}],"uniqueKey":"priority","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","title":"Status","uniqueKey":"status.oneOf.0","typeLabel":"string"},{"type":"null","title":"Status","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","title":"Title","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"updated_at":{"oneOf":[{"type":"string","title":"Updated At","uniqueKey":"updated_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Updated At","uniqueKey":"updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"updated_at","typeLabel":"string | null"},"updated_by_uuid":{"oneOf":[{"type":"string","title":"Updated By Uuid","uniqueKey":"updated_by_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Updated By Uuid","uniqueKey":"updated_by_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"updated_by_uuid","typeLabel":"string | null"},"visibility":{"oneOf":[{"type":"string","title":"Visibility","uniqueKey":"visibility.oneOf.0","typeLabel":"string"},{"type":"null","title":"Visibility","uniqueKey":"visibility.oneOf.1","typeLabel":"null"}],"uniqueKey":"visibility","typeLabel":"string | null"}},"required":["id"],"title":"TaskResponse","type":"object","uniqueKey":"","typeLabel":"TaskResponse · object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","assignments":[{"id":"\u003cstring>","assigned_by_uuid":"\u003cstring>","assigned_to_uuid":"\u003cstring>","created_at":"\u003cstring>"}],"content":{},"created_at":"\u003cstring>","created_by_uuid":"\u003cstring>","due_date":"\u003cstring>","priority":"\u003cstring>","status":"\u003cstring>","title":"\u003cstring>","updated_at":"\u003cstring>","updated_by_uuid":"\u003cstring>","visibility":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Task read response (detail + list items share this shape).","exampleType":"generated"}},"security":{"d3e1b4d8-8e73-42d2-8242-48f05e417bca":{"ApiKeyAuth":{"in":"header","name":"x-api-key","type":"apiKey","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"ac0c72ea-24cd-42c5-bf7e-af9869eeb624":{"description":"API server","url":"https://production-api.joinrings.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"in":"header","name":"x-api-key","type":"apiKey","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://production-api.joinrings.com/openapi.json"},"subdomain":"rings-ai","siteName":"Rings AI","title":"Get a task - Rings AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-17T10:17:51.877Z","originalFileLocation":"api-reference/task/get-task.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=\"dark\"}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=\"Returns the full task including assignments. PERSONAL tasks are only returned for their creator; RING tasks are visible to any tenant member. Returns 404 when the task doesn\u0026#x27;t exist or isn\u0026#x27;t visible to the caller.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Rings AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a task - Rings AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the full task including assignments. PERSONAL tasks are only returned for their creator; RING tasks are visible to any tenant member. Returns 404 when the task doesn\u0026#x27;t exist or isn\u0026#x27;t visible to the caller.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Rings AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.rings.ai/api-reference/task/get-task\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://rings-ai.mintlify.app/_mintlify/api/og/v2?division=Task\u0026amp;title=Get+a+task\u0026amp;description=%0AReturns+the+full+task+including+assignments.+PERSONAL+tasks+are+only%0Areturned+for+their+creator%3B+RING+tasks+are+visible+to+any+tenant+member.%0AReturns+404+when+\u0026amp;theme=2e1657476a2935937e03de5f\u0026amp;signature=7da8f3a94eed16c6fdc13d82bc60ce145daf3a40cbb323ad6915d1ab7faf4d5e\">\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=\"Get a task - Rings AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the full task including assignments. PERSONAL tasks are only returned for their creator; RING tasks are visible to any tenant member. Returns 404 when the task doesn\u0026#x27;t exist or isn\u0026#x27;t visible to the caller.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rings-ai.mintlify.app/_mintlify/api/og/v2?division=Task\u0026amp;title=Get+a+task\u0026amp;description=%0AReturns+the+full+task+including+assignments.+PERSONAL+tasks+are+only%0Areturned+for+their+creator%3B+RING+tasks+are+visible+to+any+tenant+member.%0AReturns+404+when+\u0026amp;theme=2e1657476a2935937e03de5f\u0026amp;signature=7da8f3a94eed16c6fdc13d82bc60ce145daf3a40cbb323ad6915d1ab7faf4d5e\">\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/rings-ai/_zk5vOoQ8ix_XOCm/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Rings AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.rings.ai/api-reference/task/get-task\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/task/get-task.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.rings.ai/#organization\",\"name\":\"Rings AI\",\"url\":\"https://docs.rings.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/Group5.svg?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=bbbf7303b09ab9978ffaee9e90f250ec\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.rings.ai#website\",\"name\":\"Rings AI\",\"url\":\"https://docs.rings.ai\",\"publisher\":{\"@id\":\"https://docs.rings.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.rings.ai/api-reference/task/get-task#webpage\",\"url\":\"https://docs.rings.ai/api-reference/task/get-task\",\"name\":\"Get a task\",\"description\":\"Returns the full task including assignments. PERSONAL tasks are only returned for their creator; RING tasks are visible to any tenant member. Returns 404 when the task doesn't exist or isn't visible to the caller.\",\"dateModified\":\"2026-07-17T10:17:51.877Z\",\"isPartOf\":{\"@id\":\"https://docs.rings.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rings.ai/api-reference/task/get-task#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rings.ai/api-reference/task/get-task#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Task\",\"item\":\"https://docs.rings.ai/api-reference/task/list-tasks\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a task\",\"item\":\"https://docs.rings.ai/api-reference/task/get-task\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.rings.ai/api-reference/task/get-task#apireference\",\"headline\":\"Get a task\",\"name\":\"Get a task\",\"description\":\"Returns the full task including assignments. PERSONAL tasks are only returned for their creator; RING tasks are visible to any tenant member. Returns 404 when the task doesn't exist or isn't visible to the caller.\",\"url\":\"https://docs.rings.ai/api-reference/task/get-task\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rings.ai/api-reference/task/get-task#webpage\"},\"dateModified\":\"2026-07-17T10:17:51.877Z\",\"publisher\":{\"@id\":\"https://docs.rings.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.rings.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Rings AI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Rings AI","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Introduction","pages":[{"title":"Overview","href":"/api-reference/introduction"}]},{"group":"Person","pages":[{"title":"List persons","openapi":"GET /v1/persons","href":"/api-reference/person/list-persons"},{"title":"List person custom fields","openapi":"GET /v1/persons/custom-fields","href":"/api-reference/person/list-custom-fields"},{"title":"Create a person","openapi":"POST /v1/persons","href":"/api-reference/person/create-person"},{"title":"Batch create persons","openapi":"POST /v1/persons/batch","href":"/api-reference/person/batch-create"},{"title":"Lookup a person","openapi":"GET /v1/persons/lookup","href":"/api-reference/person/lookup"},{"title":"Batch lookup persons","openapi":"POST /v1/persons/lookup/batch","href":"/api-reference/person/lookup-batch"},{"title":"Get a person","openapi":"GET /v1/persons/{person_uuid}","href":"/api-reference/person/get-person"},{"title":"Update a person","openapi":"PUT /v1/persons/{person_uuid}","href":"/api-reference/person/update-person"},{"title":"Merge persons","openapi":"POST /v1/persons/{person_uuid}/merge","href":"/api-reference/person/merge-person"}]},{"group":"Company","pages":[{"title":"List companies","openapi":"GET /v1/companies","href":"/api-reference/company/list-companies"},{"title":"Create a company","openapi":"POST /v1/companies","href":"/api-reference/company/create-company"},{"title":"Lookup a company","openapi":"GET /v1/companies/lookup","href":"/api-reference/company/lookup"},{"title":"Get a company","openapi":"GET /v1/companies/{company_uuid}","href":"/api-reference/company/get-company"},{"title":"List company employees","openapi":"GET /v1/companies/{company_uuid}/employees","href":"/api-reference/company/list-employees"},{"title":"Update a company","openapi":"PUT /v1/companies/{company_uuid}","href":"/api-reference/company/update-company"},{"title":"Batch lookup companies","openapi":"POST /v1/companies/lookup/batch","href":"/api-reference/company/lookup-batch"}]},{"group":"Opportunity","pages":[{"title":"List opportunities","openapi":"GET /v1/opportunities","href":"/api-reference/opportunity/list-opportunities"},{"title":"Create an opportunity","openapi":"POST /v1/opportunities","href":"/api-reference/opportunity/create-opportunity"},{"title":"Get an opportunity","openapi":"GET /v1/opportunities/{opportunity_uuid}","href":"/api-reference/opportunity/get-opportunity"},{"title":"Update an opportunity","openapi":"PUT /v1/opportunities/{opportunity_uuid}","href":"/api-reference/opportunity/update-opportunity"},{"title":"Delete opportunities","openapi":"DELETE /v1/opportunities","href":"/api-reference/opportunity/delete-opportunities"},{"title":"Add opportunity association","openapi":"POST /v1/opportunities/{opportunity_uuid}/associations","href":"/api-reference/opportunity/add-association"},{"title":"Delete opportunity association","openapi":"DELETE /v1/opportunities/{opportunity_uuid}/associations/{association_uuid}","href":"/api-reference/opportunity/delete-association"},{"title":"List opportunity types","openapi":"GET /v1/opportunity-types","href":"/api-reference/opportunity/list-types"},{"title":"List opportunity stages","openapi":"GET /v1/opportunity-types/{type_uuid}/stages","href":"/api-reference/opportunity/list-stages"},{"title":"List opportunities for a company","openapi":"GET /v1/companies/{company_uuid}/opportunities","href":"/api-reference/opportunity/list-by-company"},{"title":"List opportunities for a person","openapi":"GET /v1/persons/{person_uuid}/opportunities","href":"/api-reference/opportunity/list-by-person"}]},{"group":"Activity","pages":[{"title":"Get activity body","openapi":"GET /v1/activities/{activity_object_id}/body","href":"/api-reference/activity/get-body"},{"title":"Get activity thread","openapi":"GET /v1/activities/{activity_object_id}/thread","href":"/api-reference/activity/get-thread"},{"title":"Company activities","openapi":"GET /v1/companies/{company_uuid}/activities","href":"/api-reference/activity/company-activities"},{"title":"Company activity stats","openapi":"GET /v1/companies/{company_uuid}/activity-stats","href":"/api-reference/activity/company-activity-stats"},{"title":"Bulk company activity stats","openapi":"POST /v1/companies/activity-stats/batch","href":"/api-reference/activity/company-activity-stats-batch"},{"title":"Person activities","openapi":"GET /v1/persons/{person_uuid}/activities","href":"/api-reference/activity/person-activities"},{"title":"Person activity stats","openapi":"GET /v1/persons/{person_uuid}/activity-stats","href":"/api-reference/activity/person-activity-stats"},{"title":"Bulk person activity stats","openapi":"POST /v1/persons/activity-stats/batch","href":"/api-reference/activity/person-activity-stats-batch"}]},{"group":"Meetings","pages":[{"title":"List meetings","openapi":"GET /v1/meetings","href":"/api-reference/meetings/list-meetings"},{"title":"Get a meeting","openapi":"GET /v1/meetings/{activity_id}","href":"/api-reference/meetings/get-meeting"}]},{"group":"Note","pages":[{"title":"List notes","openapi":"GET /v1/notes","href":"/api-reference/note/list-notes"},{"title":"Create a note","openapi":"POST /v1/notes","href":"/api-reference/note/create-note"},{"title":"Batch create notes","openapi":"POST /v1/notes/batch","href":"/api-reference/note/batch-create"},{"title":"Search notes","openapi":"POST /v1/notes/search","href":"/api-reference/note/search"},{"title":"Get a note","openapi":"GET /v1/notes/{note_uuid}","href":"/api-reference/note/get-note"},{"title":"Update a note","openapi":"PUT /v1/notes/{note_uuid}","href":"/api-reference/note/update-note"},{"title":"Delete a note","openapi":"DELETE /v1/notes/{note_uuid}","href":"/api-reference/note/delete-note"},{"title":"Add note association","openapi":"POST /v1/notes/{note_uuid}/associations","href":"/api-reference/note/add-association"},{"title":"Delete note association","openapi":"DELETE /v1/notes/{note_uuid}/associations/{association_uuid}","href":"/api-reference/note/delete-association"}]},{"group":"Task","pages":[{"title":"List tasks","openapi":"GET /v1/tasks","href":"/api-reference/task/list-tasks"},{"title":"Create a task","openapi":"POST /v1/tasks","description":"\nCreates a task and optionally assigns it to users and associates it with\nentities (persons, companies, opportunities, etc.) in a single atomic\noperation. Returns the new task id on success.\n\nEnum values (case-sensitive, uppercase):\n- status: DRAFT | ACTIVE | COMPLETED | ARCHIVED (default: ACTIVE)\n- priority: LOW | MEDIUM | HIGH\n- visibility: RING (all tenant members) | PERSONAL (creator only, default: RING)\n- reminder_type: MINUTES | HOURS | DAYS | WEEKS (requires reminder_value)","href":"/api-reference/task/create-task"},{"title":"Get a task","openapi":"GET /v1/tasks/{task_id}","href":"/api-reference/task/get-task"},{"title":"Update a task","openapi":"PUT /v1/tasks/{task_id}","description":"\nOmitted fields are left unchanged on the existing record. To mark a task\nas done, set status=\"COMPLETED\". To remove a due date, pass clear_due_date=true\ninstead of setting due_date to null. To remove a reminder, pass clear_reminder=true.\n\nEnum values (case-sensitive, uppercase):\n- status: DRAFT | ACTIVE | COMPLETED | ARCHIVED\n- priority: LOW | MEDIUM | HIGH\n- visibility: RING | PERSONAL\n- reminder_type: MINUTES | HOURS | DAYS | WEEKS","href":"/api-reference/task/update-task"},{"title":"Delete a task","openapi":"DELETE /v1/tasks/{task_id}","href":"/api-reference/task/delete-task"},{"title":"Add task association","openapi":"POST /v1/tasks/{task_id}/associations","href":"/api-reference/task/add-association"},{"title":"Delete task association","openapi":"DELETE /v1/tasks/{task_id}/associations/{association_uuid}","href":"/api-reference/task/delete-association"}]},{"group":"Recommended Paths","pages":[{"title":"Recommended paths to a person","openapi":"GET /v1/persons/{person_uuid}/recommended-paths","href":"/api-reference/recommended-paths/person"},{"title":"Recommended paths to a company","openapi":"GET /v1/companies/{company_uuid}/recommended-paths","href":"/api-reference/recommended-paths/company"},{"title":"Bulk recommended paths (persons)","openapi":"POST /v1/persons/recommended-paths/batch","href":"/api-reference/recommended-paths/person-batch"},{"title":"Bulk recommended paths (companies)","openapi":"POST /v1/companies/recommended-paths/batch","href":"/api-reference/recommended-paths/company-batch"}]},{"group":"PathPower","pages":[{"title":"Bulk PathPower scores","openapi":"GET /v1/pathpower/scores","href":"/api-reference/pathpower/bulk-scores"},{"title":"PathPower for a person","openapi":"GET /v1/persons/{person_uuid}/pathpower","href":"/api-reference/pathpower/person"},{"title":"PathPower for a company","openapi":"GET /v1/companies/{company_uuid}/pathpower","href":"/api-reference/pathpower/company"}]},{"group":"Relationships","pages":[{"title":"List ring relationships","openapi":"GET /v1/relationships","href":"/api-reference/relationships/ring"},{"title":"My relationships","openapi":"GET /v1/relationships/mine","href":"/api-reference/relationships/mine"}]},{"group":"Intro","pages":[{"title":"List intros","openapi":"GET /v1/intros","href":"/api-reference/intro/list-intros"},{"title":"Log intro","openapi":"POST /v1/intros","href":"/api-reference/intro/log-intro"},{"title":"Update intro","openapi":"PUT /v1/intros/{intro_uuid}","href":"/api-reference/intro/update-intro"},{"title":"Delete intro","openapi":"DELETE /v1/intros/{intro_uuid}","href":"/api-reference/intro/delete-intro"},{"title":"List intro options","openapi":"GET /v1/intros/options","href":"/api-reference/intro/list-options"},{"title":"Get intro insights","openapi":"GET /v1/intros/insights","href":"/api-reference/intro/insights"}]},{"group":"AI Summary","pages":[{"title":"AI summary for a person","openapi":"GET /v1/persons/{person_uuid}/ai-summary","href":"/api-reference/ai-summary/person"},{"title":"AI summary for a company","openapi":"GET /v1/companies/{company_uuid}/ai-summary","href":"/api-reference/ai-summary/company"}]},{"group":"Entity Lists","pages":[{"title":"List entity lists","openapi":"GET /v1/lists","href":"/api-reference/lists/list-lists"},{"title":"List entity list members","openapi":"GET /v1/lists/{list_uuid}/entities","href":"/api-reference/lists/list-entities"},{"title":"Create an entity list","openapi":"POST /v1/lists","href":"/api-reference/lists/create-list"},{"title":"Update an entity list","openapi":"PUT /v1/lists/{list_uuid}","href":"/api-reference/lists/update-list"}]},{"group":"Users","pages":[{"title":"Get current user","openapi":"GET /v1/me","href":"/api-reference/users/me"},{"title":"List users","openapi":"GET /v1/users","href":"/api-reference/users/list-users"}]}]}]},"title":"Get a task - Rings AI","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}