Entity-native shape: typed fields, gates, accumulator state. This
is the destination shape entity.get returns. v1 implementation
may need to translate from the existing instance-shaped readers
in internal/dashboard/server/server.go (which return flat
WorkflowInstance structs without the typed-fields/gates/
accumulated decomposition). The spec commits to the entity-native
shape; implementations are responsible for providing it. A real
entity-read owner may need to land before entity.* methods can
honor this shape, which is why the entity.* methods are
should_have rather than must_have for v1.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Division Swarm","colors":{"primary":"#37e2f0","light":"#5cebf6","dark":"#128795"},"logo":{"light":"https://mintcdn.com/division/HrKH-oRLI_Y6H1CT/logo/light.png?fit=max\u0026auto=format\u0026n=HrKH-oRLI_Y6H1CT\u0026q=85\u0026s=f59f486b7549f643601acf889d0e6d88","dark":"https://mintcdn.com/division/HrKH-oRLI_Y6H1CT/logo/dark.png?fit=max\u0026auto=format\u0026n=HrKH-oRLI_Y6H1CT\u0026q=85\u0026s=ed0564bc65d9e2169f011c831549f92d"},"favicon":"https://mintcdn.com/division/HrKH-oRLI_Y6H1CT/favicon.png?fit=max\u0026auto=format\u0026n=HrKH-oRLI_Y6H1CT\u0026q=85\u0026s=2ac43454c55695c5e27343fc321d9b7f","appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://github.com/division-sh/swarm/discussions","label":"Discussions"},{"href":"https://github.com/division-sh/swarm","label":"GitHub"}],"primary":{"type":"button","label":"Quickstart","href":"/quickstart"}},"footer":{"socials":{"github":"https://github.com/division-sh/swarm"}},"integrations":{"ga4":{"measurementId":"G-JKJEKHZ35V"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/division-sh/swarm"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"division","hasAudioNarration":false,"actualSubdomain":"division","customDomains":["docs.division.sh"],"gitSource":{"type":"github","owner":"division-sh","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ad10f8afd81ca23748d2460","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"API reference","count":46},{"language":"default","tag":"Guides","count":43},{"language":"default","tag":"Reference","count":22},{"language":"default","tag":"Build a flow","count":13},{"language":"default","tag":"Contract reference","count":10},{"language":"default","tag":"Core concepts","count":9},{"language":"default","tag":"Runs","count":9},{"language":"default","tag":"Handlers","count":8},{"language":"default","tag":"Operating Swarm","count":7},{"language":"default","tag":"Language reference","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":"custom-rbac-roles","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/entity/entityget","slug":"/api-reference/entity/entityget","pageMetadata":{"title":"entity.get","description":"Read one entity in full, including fields, gates, and accumulator state.\n\n_Transport: all methods are a single `POST /v1/rpc` with the method name in the JSON-RPC body. The path shown is a per-method convenience._","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/entity.get","href":"/api-reference/entity/entityget","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n em: \"em\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Read one entity in full, including fields, gates, and accumulator state.\"\n }), \"\\n\", _jsx(_components.p, {\n children: _jsxs(_components.em, {\n children: [\"Transport: all methods are a single \", _jsx(_components.code, {\n children: \"POST /v1/rpc\"\n }), \" with the method name in the JSON-RPC body. The path shown is a per-method convenience.\"]\n })\n })]\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":"entity.get","description":"Read one entity in full, including fields, gates, and accumulator state.\n\n_Transport: all methods are a single `POST /v1/rpc` with the method name in the JSON-RPC body. The path shown is a per-method convenience._","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/entity.get","href":"/api-reference/entity/entityget","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"entity_get","summary":"entity.get","description":"Read one entity in full, including fields, gates, and accumulator state.\n\n_Transport: all methods are a single `POST /v1/rpc` with the method name in the JSON-RPC body. The path shown is a per-method convenience._","tags":["entity"],"requestBody":"a2c55645-f502-4228-8e2c-692b3a78c2b3","responses":{"200":"48a3de4d-a6d5-473f-bdb6-f08df65ff786"},"method":"post","type":"path","servers":["a2b5eba8-a858-4322-be0d-a8938cf1c299"],"security":["f2116959-f81c-4f43-bb1f-e0442db549b7"],"path":"/v1/rpc/entity.get","baseUrlOptions":["http://127.0.0.1:8081"],"title":"entity.get","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"const":"2.0","type":"string","isRequired":true,"uniqueKey":"jsonrpc","typeLabel":"string"},"method":{"type":"string","const":"entity.get","isRequired":true,"uniqueKey":"method","typeLabel":"string"},"id":{"oneOf":[{"type":"string","description":"Client-chosen request id, echoed in the response.","uniqueKey":"id.oneOf.0","typeLabel":"string"},{"type":"integer","description":"Client-chosen request id, echoed in the response.","uniqueKey":"id.oneOf.1","typeLabel":"integer"}],"uniqueKey":"id","typeLabel":"string | integer"},"params":{"type":"object","properties":{"entity_id":{"description":"Opaque identifier. Currently UUID-shaped for runtime-assigned IDs; clients MUST NOT assume UUID shape.","maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9_:.-]+$","type":"string","isRequired":true,"uniqueKey":"params.entity_id","typeLabel":"string"},"run_id":{"description":"Disambiguates entities reused across runs.","maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9_:.-]+$","type":"string","uniqueKey":"params.run_id","typeLabel":"string"}},"required":["entity_id"],"uniqueKey":"params","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","method":"entity.get","id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"48a3de4d-a6d5-473f-bdb6-f08df65ff786":{"description":"JSON-RPC response envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"const":"2.0","type":"string","uniqueKey":"jsonrpc","typeLabel":"string"},"id":{"oneOf":[{"type":"string","uniqueKey":"id.oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"id.oneOf.1","typeLabel":"integer"}],"uniqueKey":"id","typeLabel":"string | integer"},"result":{"additionalProperties":false,"description":"Entity-native shape: typed fields, gates, accumulator state. This\nis the destination shape entity.get returns. v1 implementation\nmay need to translate from the existing instance-shaped readers\nin internal/dashboard/server/server.go (which return flat\nWorkflowInstance structs without the typed-fields/gates/\naccumulated decomposition). The spec commits to the entity-native\nshape; implementations are responsible for providing it. A real\nentity-read owner may need to land before entity.* methods can\nhonor this shape, which is why the entity.* methods are\nshould_have rather than must_have for v1.\n","properties":{"accumulated":{"additionalProperties":true,"description":"Accumulator state. Map of accumulator key → JSON value; values may be scalars, objects, or arrays depending on accumulate, data_accumulation, compute, or projection writers.","type":"object","isRequired":true,"uniqueKey":"result.accumulated","typeLabel":"object"},"entity":{"additionalProperties":false,"properties":{"created_at":{"description":"RFC3339 timestamp, UTC. Example: \"2026-05-09T18:31:41.367722Z\".","format":"date-time","type":"string","isRequired":true,"uniqueKey":"result.entity.created_at","typeLabel":"string\u003cdate-time>"},"current_state":{"type":"string","isRequired":true,"uniqueKey":"result.entity.current_state","typeLabel":"string"},"entity_id":{"description":"Opaque identifier. Currently UUID-shaped for runtime-assigned IDs; clients MUST NOT assume UUID shape.","maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9_:.-]+$","type":"string","isRequired":true,"uniqueKey":"result.entity.entity_id","typeLabel":"string"},"entity_type":{"type":"string","isRequired":true,"uniqueKey":"result.entity.entity_type","typeLabel":"string"},"flow_instance":{"type":"string","isRequired":true,"uniqueKey":"result.entity.flow_instance","typeLabel":"string"},"revision":{"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"result.entity.revision","typeLabel":"integer"},"run_id":{"description":"Opaque identifier. Currently UUID-shaped for runtime-assigned IDs; clients MUST NOT assume UUID shape.","maxLength":256,"minLength":1,"pattern":"^[A-Za-z0-9_:.-]+$","type":"string","isRequired":true,"uniqueKey":"result.entity.run_id","typeLabel":"string"},"updated_at":{"description":"RFC3339 timestamp, UTC. Example: \"2026-05-09T18:31:41.367722Z\".","format":"date-time","type":"string","isRequired":true,"uniqueKey":"result.entity.updated_at","typeLabel":"string\u003cdate-time>"},"name":{"type":"string","uniqueKey":"result.entity.name","typeLabel":"string"},"slug":{"type":"string","uniqueKey":"result.entity.slug","typeLabel":"string"}},"required":["entity_id","run_id","flow_instance","entity_type","current_state","revision","created_at","updated_at"],"type":"object","isRequired":true,"uniqueKey":"result.entity","typeLabel":"object"},"fields":{"additionalProperties":true,"description":"Typed entity fields per the entity contract. Shape depends on entity_type.","type":"object","isRequired":true,"uniqueKey":"result.fields","typeLabel":"object"},"gates":{"additionalProperties":{"type":"boolean","uniqueKey":"result.gates.additionalProperties","typeLabel":"boolean"},"description":"Gate state. Map of gate_name → boolean.","type":"object","isRequired":true,"uniqueKey":"result.gates","typeLabel":"object"}},"required":["entity","fields","gates","accumulated"],"type":"object","uniqueKey":"result","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","id":"\u003cstring>","result":{"accumulated":{},"entity":{"created_at":"2023-11-07T05:31:56Z","current_state":"\u003cstring>","entity_id":"\u003cstring>","entity_type":"\u003cstring>","flow_instance":"\u003cstring>","revision":1,"run_id":"\u003cstring>","updated_at":"2023-11-07T05:31:56Z","name":"\u003cstring>","slug":"\u003cstring>"},"fields":{},"gates":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f2116959-f81c-4f43-bb1f-e0442db549b7":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"a2b5eba8-a858-4322-be0d-a8938cf1c299":{"url":"http://127.0.0.1:8081"}},"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":"api-reference/openapi.json"},"subdomain":"division","siteName":"Division Swarm","title":"entity.get - Division Swarm","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-24T00:04:57.827Z","originalFileLocation":"api-reference/entity/entityget.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=\"Read one entity in full, including fields, gates, and accumulator state. Transport: all methods are a single POST /v1/rpc with the method name in the JSON-RPC body. The path shown is a per-method convenience.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Division Swarm\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/division/d2K2oDQN67si7toU/_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/division/d2K2oDQN67si7toU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/division/d2K2oDQN67si7toU/_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/division/d2K2oDQN67si7toU/_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/division/d2K2oDQN67si7toU/_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/division/d2K2oDQN67si7toU/_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/division/d2K2oDQN67si7toU/_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/division/d2K2oDQN67si7toU/_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/division/d2K2oDQN67si7toU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"entity.get - Division Swarm\">\u003cmeta data-mint-head property=\"og:description\" content=\"Read one entity in full, including fields, gates, and accumulator state. Transport: all methods are a single POST /v1/rpc with the method name in the JSON-RPC body. The path shown is a per-method convenience.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Division Swarm\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.division.sh/api-reference/entity/entityget\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://division.mintlify.site/_mintlify/api/og/v2?division=Entities\u0026amp;title=entity.get\u0026amp;description=Read+one+entity+in+full%2C+including+fields%2C+gates%2C+and+accumulator+state.%0A%0A_Transport%3A+all+methods+are+a+single+%60POST+%2Fv1%2Frpc%60+with+the+method+name+in+the+JSON-R\u0026amp;theme=d30408466f541a16b36a801a\u0026amp;signature=cf5c729bf6d8431dad75f407ec0f3f84021589eeb5fcca3540d6a7a4a8c6a8cb\">\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=\"entity.get - Division Swarm\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Read one entity in full, including fields, gates, and accumulator state. Transport: all methods are a single POST /v1/rpc with the method name in the JSON-RPC body. The path shown is a per-method convenience.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://division.mintlify.site/_mintlify/api/og/v2?division=Entities\u0026amp;title=entity.get\u0026amp;description=Read+one+entity+in+full%2C+including+fields%2C+gates%2C+and+accumulator+state.%0A%0A_Transport%3A+all+methods+are+a+single+%60POST+%2Fv1%2Frpc%60+with+the+method+name+in+the+JSON-R\u0026amp;theme=d30408466f541a16b36a801a\u0026amp;signature=cf5c729bf6d8431dad75f407ec0f3f84021589eeb5fcca3540d6a7a4a8c6a8cb\">\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/division/d2K2oDQN67si7toU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Division Swarm\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#37e2f0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.division.sh/api-reference/entity/entityget\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/entity/entityget.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.division.sh/#organization\",\"name\":\"Division Swarm\",\"url\":\"https://docs.division.sh\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/division/HrKH-oRLI_Y6H1CT/logo/light.png?fit=max\u0026auto=format\u0026n=HrKH-oRLI_Y6H1CT\u0026q=85\u0026s=f59f486b7549f643601acf889d0e6d88\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.division.sh#website\",\"name\":\"Division Swarm\",\"url\":\"https://docs.division.sh\",\"publisher\":{\"@id\":\"https://docs.division.sh/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.division.sh/api-reference/entity/entityget#webpage\",\"url\":\"https://docs.division.sh/api-reference/entity/entityget\",\"name\":\"entity.get\",\"description\":\"Read one entity in full, including fields, gates, and accumulator state. Transport: all methods are a single POST /v1/rpc with the method name in the JSON-RPC body. The path shown is a per-method convenience.\",\"dateModified\":\"2026-05-24T00:04:57.827Z\",\"isPartOf\":{\"@id\":\"https://docs.division.sh#website\"},\"breadcrumb\":{\"@id\":\"https://docs.division.sh/api-reference/entity/entityget#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.division.sh/api-reference/entity/entityget#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Entities\",\"item\":\"https://docs.division.sh/api-reference/entity/entityaggregate\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"entity.get\",\"item\":\"https://docs.division.sh/api-reference/entity/entityget\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.division.sh/api-reference/entity/entityget#apireference\",\"headline\":\"entity.get\",\"name\":\"entity.get\",\"description\":\"Read one entity in full, including fields, gates, and accumulator state. Transport: all methods are a single POST /v1/rpc with the method name in the JSON-RPC body. The path shown is a per-method convenience.\",\"url\":\"https://docs.division.sh/api-reference/entity/entityget\",\"mainEntityOfPage\":{\"@id\":\"https://docs.division.sh/api-reference/entity/entityget#webpage\"},\"dateModified\":\"2026-05-24T00:04:57.827Z\",\"publisher\":{\"@id\":\"https://docs.division.sh/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.division.sh#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Division Swarm\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Division Swarm\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/entity/entityget.md","siteName":"Division Swarm","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/division-sh/swarm"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/reference/contracts/overview"}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API overview","icon":"code","href":"/api-reference/introduction"},{"title":"Transport, auth, and envelope","icon":"key","href":"/api-reference/transport-and-auth"},{"title":"Subscriptions","icon":"satellite-dish","href":"/api-reference/subscriptions"}]},{"group":"Health","pages":[{"title":"health.check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/health.check","href":"/api-reference/health/healthcheck"},{"title":"health.ping","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/health.ping","href":"/api-reference/health/healthping"},{"title":"health.subscribe","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/health.subscribe","href":"/api-reference/health/healthsubscribe"}]},{"group":"Runs","pages":[{"title":"run.continue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/run.continue","href":"/api-reference/run/runcontinue"},{"title":"run.diagnose","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/run.diagnose","href":"/api-reference/run/rundiagnose"},{"title":"run.get","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/run.get","href":"/api-reference/run/runget"},{"title":"run.list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/run.list","href":"/api-reference/run/runlist"},{"title":"run.pause","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/run.pause","href":"/api-reference/run/runpause"},{"title":"run.start","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/run.start","href":"/api-reference/run/runstart"},{"title":"run.stop","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/run.stop","href":"/api-reference/run/runstop"},{"title":"run.subscribe_trace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/run.subscribe_trace","href":"/api-reference/run/runsubscribe_trace"},{"title":"run.trace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/run.trace","href":"/api-reference/run/runtrace"}]},{"group":"Events","pages":[{"title":"event.get","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/event.get","href":"/api-reference/event/eventget"},{"title":"event.list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/event.list","href":"/api-reference/event/eventlist"},{"title":"event.publish","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/event.publish","href":"/api-reference/event/eventpublish"},{"title":"event.replay","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/event.replay","href":"/api-reference/event/eventreplay"},{"title":"event.subscribe","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/event.subscribe","href":"/api-reference/event/eventsubscribe"}]},{"group":"Entities","pages":[{"title":"entity.aggregate","description":"Aggregate entity counts grouped by a field.\n\n_Transport: all methods are a single `POST /v1/rpc` with the method name in the JSON-RPC body. The path shown is a per-method convenience._","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/entity.aggregate","href":"/api-reference/entity/entityaggregate"},{"title":"entity.get","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/entity.get","href":"/api-reference/entity/entityget"},{"title":"entity.list","description":"List entities with optional filters. Consolidates legacy \"instance\" and \"entity\" reads.\n\n_Transport: all methods are a single `POST /v1/rpc` with the method name in the JSON-RPC body. The path shown is a per-method convenience._","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/entity.list","href":"/api-reference/entity/entitylist"}]},{"group":"Mailbox","pages":[{"title":"mailbox.approve","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/mailbox.approve","href":"/api-reference/mailbox/mailboxapprove"},{"title":"mailbox.defer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/mailbox.defer","href":"/api-reference/mailbox/mailboxdefer"},{"title":"mailbox.get","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/mailbox.get","href":"/api-reference/mailbox/mailboxget"},{"title":"mailbox.list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/mailbox.list","href":"/api-reference/mailbox/mailboxlist"},{"title":"mailbox.reject","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/mailbox.reject","href":"/api-reference/mailbox/mailboxreject"}]},{"group":"Agents","pages":[{"title":"agent.diagnose","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/agent.diagnose","href":"/api-reference/agent/agentdiagnose"},{"title":"agent.get","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/agent.get","href":"/api-reference/agent/agentget"},{"title":"agent.list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/agent.list","href":"/api-reference/agent/agentlist"},{"title":"agent.replay","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/agent.replay","href":"/api-reference/agent/agentreplay"},{"title":"agent.replay_backlog","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/agent.replay_backlog","href":"/api-reference/agent/agentreplay_backlog"},{"title":"agent.restart","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/agent.restart","href":"/api-reference/agent/agentrestart"},{"title":"agent.send_directive","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/agent.send_directive","href":"/api-reference/agent/agentsend_directive"}]},{"group":"Conversations","pages":[{"title":"conversation.current_for_agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/conversation.current_for_agent","href":"/api-reference/conversation/conversationcurrent_for_agent"},{"title":"conversation.get","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/conversation.get","href":"/api-reference/conversation/conversationget"},{"title":"conversation.get_turn","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/conversation.get_turn","href":"/api-reference/conversation/conversationget_turn"},{"title":"conversation.list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/conversation.list","href":"/api-reference/conversation/conversationlist"}]},{"group":"Runtime","pages":[{"title":"runtime.incidents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/runtime.incidents","href":"/api-reference/runtime/runtimeincidents"},{"title":"runtime.logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/runtime.logs","href":"/api-reference/runtime/runtimelogs"},{"title":"runtime.nuke","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/runtime.nuke","href":"/api-reference/runtime/runtimenuke"},{"title":"runtime.pause","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/runtime.pause","href":"/api-reference/runtime/runtimepause"},{"title":"runtime.resume","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/runtime.resume","href":"/api-reference/runtime/runtimeresume"},{"title":"runtime.subscribe_logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/runtime.subscribe_logs","href":"/api-reference/runtime/runtimesubscribe_logs"}]},{"group":"Protocol","pages":[{"title":"rpc.unsubscribe","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/rpc/rpc.unsubscribe","href":"/api-reference/rpc/rpcunsubscribe"}]}]}]},"basePath":"","title":"entity.get - Division Swarm","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}