Returns one event subscription, without its signing key. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability.
Service accounts can call it with the compute:GetEventSubscription permission.
Send Authorization: Bearer <credential> to https://customer-api.mountthor.com. People use the session that mthr login stores (a token starting mt_session_, valid for up to 12 hours). Automation uses a service-account credential (starting mt_sa_v1_, valid for 90 days) from Create credential. Each operation names the permission it needs. Service accounts hold permissions through custom roles, and some operations refuse them; those operations say so.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Mount Thor","description":"Customer documentation for Mount Thor: Apple hardware at datacenter scale for bare-metal machines and macOS virtual machines.","colors":{"primary":"#2f3ae0","light":"#9fc9de","dark":"#4a53fb"},"logo":{"light":"https://mintcdn.com/mountthor/FI-NP0X3jMU6ANs9/logo/light.svg?fit=max\u0026auto=format\u0026n=FI-NP0X3jMU6ANs9\u0026q=85\u0026s=a075dbc8738ac4ddb608c81b72dc8f3e","dark":"https://mintcdn.com/mountthor/FI-NP0X3jMU6ANs9/logo/dark.svg?fit=max\u0026auto=format\u0026n=FI-NP0X3jMU6ANs9\u0026q=85\u0026s=cce877d86f8ee91a5cb105dd433fbeec","href":"https://docs.mountthor.com"},"favicon":"https://mintcdn.com/mountthor/iB6WtUcnMc-562Sd/favicon.svg?fit=max\u0026auto=format\u0026n=iB6WtUcnMc-562Sd\u0026q=85\u0026s=1e7406d7ab2decc0c014c59cdac3acbf","appearance":{"default":"system","strict":false},"background":{"color":{"light":"#f7f8f9","dark":"#101010"}},"navbar":{"primary":{"type":"button","label":"Request access","href":"https://portal.mountthor.com/request-access"}},"fonts":{"heading":{"family":"Instrument Sans","weight":500},"body":{"family":"Instrument Sans","weight":400}},"thumbnails":{"appearance":"light","fonts":{"family":"Instrument Sans"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mountthor","hasAudioNarration":false,"actualSubdomain":"mountthor","customDomains":["docs.mountthor.com"],"gitSource":{"type":"github","owner":"mount-thor","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af5d9b56aaba2f8a1d57959","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Documentation","count":47},{"language":"default","tag":"API Reference","count":32},{"language":"default","tag":"Compute","count":27},{"language":"default","tag":"Platform","count":9},{"language":"default","tag":"Billing","count":8},{"language":"default","tag":"Event subscriptions","count":7},{"language":"default","tag":"Bare metal","count":4},{"language":"default","tag":"Virtual machines","count":4},{"language":"default","tag":"Account and funds","count":3},{"language":"default","tag":"Usage and costs","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"#footer a[href*=\"mintlify.com\"],footer a[href*=\"mintlify.com\"]{display:none!important}.mermaid,.mermaid svg{max-width:100%;height:auto!important}@media (max-width: 640px){.mermaid+div:has(button){display:none!important}}"},{"filePath":"brand.css","content":"#pagination{border-top:1px solid #d4d5d6;margin-top:2.5rem;padding-top:1.25rem}html.dark #pagination{border-top-color:#4a4a4a}"}],"page":{"pagePath":"api-reference/compute/get-event-subscription","slug":"/api-reference/compute/get-event-subscription","pageMetadata":{"title":"Get event subscription","description":"Returns one event subscription, without its signing key. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability.\n\nService accounts can call it with the `compute:GetEventSubscription` permission.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/eventsubscriptions/{name}","href":"/api-reference/compute/get-event-subscription","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 p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Returns one event subscription, without its signing key. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Service accounts can call it with the \", _jsx(_components.code, {\n children: \"compute:GetEventSubscription\"\n }), \" permission.\"]\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":"Get event subscription","description":"Returns one event subscription, without its signing key. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability.\n\nService accounts can call it with the `compute:GetEventSubscription` permission.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/eventsubscriptions/{name}","href":"/api-reference/compute/get-event-subscription","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Returns one event subscription, without its signing key. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability.\n\nService accounts can call it with the `compute:GetEventSubscription` permission.","operationId":"ComputeService_GetEventSubscription","parameters":["120536cf-f362-4b9e-b462-a0bb2d1e37e9"],"responses":{"200":"36ef6ff4-0dfa-4281-b17c-774fb13284de","400":"63b735a1-b5c5-4bfe-bf0f-b0f0fd1028db","401":"7804617b-38d5-4d0c-b6fa-315c2bb75294","403":"047d43b6-e28c-4fc6-958d-a87cb400c35a","404":"179d8339-af0a-4d4c-88b7-77b12296454a","429":"4d2975c6-c805-4a40-acff-88435df73dc8","501":"c3e42ebd-982a-4cb0-99ff-6f34f0509501","503":"ec4c4e1b-2725-4766-807d-8409e7ecef38"},"summary":"Get event subscription","method":"get","type":"path","servers":["334a1b89-2e0b-434e-b968-4068e166e58f"],"security":["895e082b-7f69-4ea4-b2e8-39a3485dedce"],"path":"/compute/v2/eventsubscriptions/{name}","baseUrlOptions":["https://customer-api.mountthor.com"],"title":"Get event subscription","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"120536cf-f362-4b9e-b462-a0bb2d1e37e9":{"name":"name","in":"path","description":"The subscription's `name`.","required":true,"schema":{"type":"string","isRequired":true,"description":"The subscription's `name`.","uniqueKey":"","typeLabel":"string"}}},"responses":{"36ef6ff4-0dfa-4281-b17c-774fb13284de":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"eventSubscription":{"required":["name","topic","actions","uri"],"type":"object","properties":{"name":{"type":"string","description":"The subscription's name, chosen by you and unique in your account: up to 253 lowercase letters, digits, hyphens and dots, starting and ending with a letter or digit. It cannot change.","isRequired":true,"uniqueKey":"eventSubscription.name","typeLabel":"string"},"topic":{"enum":["EVENT_TOPIC_BARE_METAL_MACHINE","EVENT_TOPIC_VIRTUAL_MACHINE"],"type":"string","description":"The topic to subscribe to. Your Macs' events are under `EVENT_TOPIC_BARE_METAL_MACHINE`.","format":"enum","isRequired":true,"uniqueKey":"eventSubscription.topic","typeLabel":"enum\u003cstring>"},"actions":{"type":"array","items":{"type":"string","uniqueKey":"eventSubscription.actions.items.[INDEX]","typeLabel":"string"},"description":"The actions to send, by name from List event actions for the chosen `topic`, or `[\"*\"]` for every action of the topic, including actions added later. At least one. Order does not matter, and duplicates are ignored.","isRequired":true,"uniqueKey":"eventSubscription.actions","typeLabel":"string[]"},"uri":{"type":"string","description":"The HTTPS URL that receives deliveries. Its host must be a public DNS name that resolves only to public addresses, on port 443, stated or by default. An IP address, a user name or password, or a fragment in the URL is refused. A path and a query are allowed. Redirects are not followed.","isRequired":true,"uniqueKey":"eventSubscription.uri","typeLabel":"string"},"createdAt":{"readOnly":true,"type":"string","description":"When the subscription was created.","format":"date-time","uniqueKey":"eventSubscription.createdAt","typeLabel":"string\u003cdate-time>"}},"description":"The subscription.","uniqueKey":"eventSubscription","typeLabel":"object"}},"description":"An event subscription, without its signing key.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"eventSubscription":{"name":"\u003cstring>","topic":"EVENT_TOPIC_BARE_METAL_MACHINE","actions":["\u003cstring>"],"uri":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"63b735a1-b5c5-4bfe-bf0f-b0f0fd1028db":{"description":"The request is invalid or cannot be carried out now. `error.reason` says why when it can.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","description":"The HTTP status code.","uniqueKey":"error.code","typeLabel":"integer"},"status":{"type":"string","description":"A short category name, for example `NotFound`, `InvalidArgument` or `FailedPrecondition`.","uniqueKey":"error.status","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable reason when one applies, for example `insufficient_funds` when a launch is refused for billing. Branch on this, not on `message`.","uniqueKey":"error.reason","typeLabel":"string"},"message":{"type":"string","description":"A human-readable explanation. Its wording can change.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":123,"status":"\u003cstring>","reason":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7804617b-38d5-4d0c-b6fa-315c2bb75294":{"description":"The credential is missing, invalid or expired.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","description":"The HTTP status code.","uniqueKey":"error.code","typeLabel":"integer"},"status":{"type":"string","description":"A short category name, for example `NotFound`, `InvalidArgument` or `FailedPrecondition`.","uniqueKey":"error.status","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable reason when one applies, for example `insufficient_funds` when a launch is refused for billing. Branch on this, not on `message`.","uniqueKey":"error.reason","typeLabel":"string"},"message":{"type":"string","description":"A human-readable explanation. Its wording can change.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":123,"status":"\u003cstring>","reason":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"047d43b6-e28c-4fc6-958d-a87cb400c35a":{"description":"The credential does not allow this operation. `error.reason` is `machine_credential_not_supported` when the operation refuses service accounts.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","description":"The HTTP status code.","uniqueKey":"error.code","typeLabel":"integer"},"status":{"type":"string","description":"A short category name, for example `NotFound`, `InvalidArgument` or `FailedPrecondition`.","uniqueKey":"error.status","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable reason when one applies, for example `insufficient_funds` when a launch is refused for billing. Branch on this, not on `message`.","uniqueKey":"error.reason","typeLabel":"string"},"message":{"type":"string","description":"A human-readable explanation. Its wording can change.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":123,"status":"\u003cstring>","reason":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"179d8339-af0a-4d4c-88b7-77b12296454a":{"description":"No event subscription with this name exists in your account.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","description":"The HTTP status code.","uniqueKey":"error.code","typeLabel":"integer"},"status":{"type":"string","description":"A short category name, for example `NotFound`, `InvalidArgument` or `FailedPrecondition`.","uniqueKey":"error.status","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable reason when one applies, for example `insufficient_funds` when a launch is refused for billing. Branch on this, not on `message`.","uniqueKey":"error.reason","typeLabel":"string"},"message":{"type":"string","description":"A human-readable explanation. Its wording can change.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":123,"status":"\u003cstring>","reason":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"4d2975c6-c805-4a40-acff-88435df73dc8":{"description":"Too many requests for now. Event subscription operations are limited per account; retry after the number of seconds in `Retry-After`.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","description":"The HTTP status code.","uniqueKey":"error.code","typeLabel":"integer"},"status":{"type":"string","description":"A short category name, for example `NotFound`, `InvalidArgument` or `FailedPrecondition`.","uniqueKey":"error.status","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable reason when one applies, for example `insufficient_funds` when a launch is refused for billing. Branch on this, not on `message`.","uniqueKey":"error.reason","typeLabel":"string"},"message":{"type":"string","description":"A human-readable explanation. Its wording can change.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":123,"status":"\u003cstring>","reason":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c3e42ebd-982a-4cb0-99ff-6f34f0509501":{"description":"Event subscriptions are not available yet (`unimplemented`); retry later.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","description":"The HTTP status code.","uniqueKey":"error.code","typeLabel":"integer"},"status":{"type":"string","description":"A short category name, for example `NotFound`, `InvalidArgument` or `FailedPrecondition`.","uniqueKey":"error.status","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable reason when one applies, for example `insufficient_funds` when a launch is refused for billing. Branch on this, not on `message`.","uniqueKey":"error.reason","typeLabel":"string"},"message":{"type":"string","description":"A human-readable explanation. Its wording can change.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":123,"status":"\u003cstring>","reason":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"ec4c4e1b-2725-4766-807d-8409e7ecef38":{"description":"Compute is temporarily unable to complete the request; retry later.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","description":"The HTTP status code.","uniqueKey":"error.code","typeLabel":"integer"},"status":{"type":"string","description":"A short category name, for example `NotFound`, `InvalidArgument` or `FailedPrecondition`.","uniqueKey":"error.status","typeLabel":"string"},"reason":{"type":"string","description":"A stable, machine-readable reason when one applies, for example `insufficient_funds` when a launch is refused for billing. Branch on this, not on `message`.","uniqueKey":"error.reason","typeLabel":"string"},"message":{"type":"string","description":"A human-readable explanation. Its wording can change.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":123,"status":"\u003cstring>","reason":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"895e082b-7f69-4ea4-b2e8-39a3485dedce":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Send `Authorization: Bearer \u003ccredential>` to https://customer-api.mountthor.com. People use the session that `mthr login` stores (a token starting `mt_session_`, valid for up to 12 hours). Automation uses a service-account credential (starting `mt_sa_v1_`, valid for 90 days) from Create credential. Each operation names the permission it needs. Service accounts hold permissions through custom roles, and some operations refuse them; those operations say so.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"334a1b89-2e0b-434e-b968-4068e166e58f":{"url":"https://customer-api.mountthor.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Send `Authorization: Bearer \u003ccredential>` to https://customer-api.mountthor.com. People use the session that `mthr login` stores (a token starting `mt_session_`, valid for up to 12 hours). Automation uses a service-account credential (starting `mt_sa_v1_`, valid for 90 days) from Create credential. Each operation names the permission it needs. Service accounts hold permissions through custom roles, and some operations refuse them; those operations say so.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Send `Authorization: Bearer \u003ccredential>` to https://customer-api.mountthor.com. People use the session that `mthr login` stores (a token starting `mt_session_`, valid for up to 12 hours). Automation uses a service-account credential (starting `mt_sa_v1_`, valid for 90 days) from Create credential. Each operation names the permission it needs. Service accounts hold permissions through custom roles, and some operations refuse them; those operations say so.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi/compute.json"},"subdomain":"mountthor","siteName":"Mount Thor","title":"Get event subscription - Mount Thor","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T15:51:10.871Z","originalFileLocation":"api-reference/compute/get-event-subscription.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=\"Returns one event subscription, without its signing key. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability. Service accounts can call it with the compute:GetEventSubscription permission.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mount Thor\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mountthor/riiAjzkRqq-b2xpc/_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/mountthor/riiAjzkRqq-b2xpc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mountthor/riiAjzkRqq-b2xpc/_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/mountthor/riiAjzkRqq-b2xpc/_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/mountthor/riiAjzkRqq-b2xpc/_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/mountthor/riiAjzkRqq-b2xpc/_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/mountthor/riiAjzkRqq-b2xpc/_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/mountthor/riiAjzkRqq-b2xpc/_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/mountthor/riiAjzkRqq-b2xpc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get event subscription - Mount Thor\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns one event subscription, without its signing key. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability. Service accounts can call it with the compute:GetEventSubscription permission.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mount Thor\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mountthor.com/api-reference/compute/get-event-subscription\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mountthor.mintlify.site/_mintlify/api/og/v2?division=Event+subscriptions\u0026amp;title=Get+event+subscription\u0026amp;description=Returns+one+event+subscription%2C+without+its+signing+key.+Every+account+can+use+event+subscriptions.+In+an+account+whose+Macs+your+organization+manages%2C+they+nee\u0026amp;theme=5cf2c0001ae982959e9b5edb\u0026amp;signature=cf2e66331a5a5fc31225c9df6207c0c23ee24f85028b95a4aba5e96ab5a812b4\">\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 event subscription - Mount Thor\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns one event subscription, without its signing key. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability. Service accounts can call it with the compute:GetEventSubscription permission.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mountthor.mintlify.site/_mintlify/api/og/v2?division=Event+subscriptions\u0026amp;title=Get+event+subscription\u0026amp;description=Returns+one+event+subscription%2C+without+its+signing+key.+Every+account+can+use+event+subscriptions.+In+an+account+whose+Macs+your+organization+manages%2C+they+nee\u0026amp;theme=5cf2c0001ae982959e9b5edb\u0026amp;signature=cf2e66331a5a5fc31225c9df6207c0c23ee24f85028b95a4aba5e96ab5a812b4\">\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/mountthor/riiAjzkRqq-b2xpc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mount Thor\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2f3ae0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mountthor.com/api-reference/compute/get-event-subscription\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/compute/get-event-subscription.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mountthor.com/#organization\",\"name\":\"Mount Thor\",\"url\":\"https://docs.mountthor.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mountthor/FI-NP0X3jMU6ANs9/logo/light.svg?fit=max\u0026auto=format\u0026n=FI-NP0X3jMU6ANs9\u0026q=85\u0026s=a075dbc8738ac4ddb608c81b72dc8f3e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mountthor.com#website\",\"name\":\"Mount Thor\",\"url\":\"https://docs.mountthor.com\",\"publisher\":{\"@id\":\"https://docs.mountthor.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mountthor.com/api-reference/compute/get-event-subscription#webpage\",\"url\":\"https://docs.mountthor.com/api-reference/compute/get-event-subscription\",\"name\":\"Get event subscription\",\"description\":\"Returns one event subscription, without its signing key. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability. Service accounts can call it with the compute:GetEventSubscription permission.\",\"dateModified\":\"2026-11-09T15:51:10.871Z\",\"isPartOf\":{\"@id\":\"https://docs.mountthor.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mountthor.com/api-reference/compute/get-event-subscription#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mountthor.com/api-reference/compute/get-event-subscription#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.mountthor.com/api-reference/compute/list-virtual-machines\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Compute\",\"item\":\"https://docs.mountthor.com/api-reference/compute/list-virtual-machines\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Event subscriptions\",\"item\":\"https://docs.mountthor.com/api-reference/compute/list-event-actions\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Get event subscription\",\"item\":\"https://docs.mountthor.com/api-reference/compute/get-event-subscription\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mountthor.com/api-reference/compute/get-event-subscription#apireference\",\"headline\":\"Get event subscription\",\"name\":\"Get event subscription\",\"description\":\"Returns one event subscription, without its signing key. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability. Service accounts can call it with the compute:GetEventSubscription permission.\",\"url\":\"https://docs.mountthor.com/api-reference/compute/get-event-subscription\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mountthor.com/api-reference/compute/get-event-subscription#webpage\"},\"dateModified\":\"2026-11-09T15:51:10.871Z\",\"publisher\":{\"@id\":\"https://docs.mountthor.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mountthor.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mount Thor\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Mount Thor\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/compute/get-event-subscription.md","siteName":"Mount Thor","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Quickstart","href":"/quickstart"},{"group":"Compute","pages":[{"title":"Compute offerings","href":"/compute/offerings"},{"title":"Compute types","href":"/compute/types"},{"title":"Bare metal","href":"/compute/bare-metal"},{"title":"Virtual machines","href":"/compute/virtual-machines"},{"title":"Customer-managed compute","href":"/compute/customer-managed"}]},{"group":"Platform","pages":[{"title":"Kubernetes","href":"/platform/kubernetes"},{"title":"Account","href":"/platform/account"},{"title":"Billing","href":"/platform/billing"},{"title":"Team members","href":"/platform/members"},{"title":"Authentication and access","href":"/platform/authentication-and-access"},{"title":"Service accounts","href":"/platform/service-accounts"},{"title":"Roles and bindings","href":"/platform/roles-and-bindings"},{"title":"Actions","href":"/platform/actions"},{"title":"Machine identity","href":"/platform/machine-identity"}]},{"group":"API Reference","pages":[{"group":"Compute","pages":[{"group":"Virtual machines","pages":[{"title":"List virtual machines","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/virtualmachines","href":"/api-reference/compute/list-virtual-machines"},{"title":"Create virtual machine","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json post /compute/v2/virtualmachines","href":"/api-reference/compute/create-virtual-machine"},{"title":"Get virtual machine","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/virtualmachines/{name}","href":"/api-reference/compute/get-virtual-machine"},{"title":"Delete virtual machine","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json delete /compute/v2/virtualmachines/{name}","href":"/api-reference/compute/delete-virtual-machine"}]},{"group":"Bare metal","pages":[{"title":"List bare-metal machines","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/baremetalmachines","href":"/api-reference/compute/list-bare-metal-machines"},{"title":"Create bare-metal machine","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json post /compute/v2/baremetalmachines","href":"/api-reference/compute/create-bare-metal-machine"},{"title":"Get bare-metal machine","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/baremetalmachines/{name}","href":"/api-reference/compute/get-bare-metal-machine"},{"title":"Delete bare-metal machine","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json delete /compute/v2/baremetalmachines/{name}","href":"/api-reference/compute/delete-bare-metal-machine"}]},{"group":"Catalog","pages":[{"title":"List images","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/catalog/images","href":"/api-reference/compute/list-images"},{"title":"List machine classes","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/catalog/machineclasses","href":"/api-reference/compute/list-machine-classes"}]},{"group":"Reservations","pages":[{"title":"List reservations","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/reservations","href":"/api-reference/compute/list-reservations"}]},{"group":"Compute profile","pages":[{"title":"Get compute profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/computeprofile","href":"/api-reference/compute/get-compute-profile"}]},{"group":"Problem reports","pages":[{"title":"Report a machine problem","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json post /compute/v2/machineproblemreports","href":"/api-reference/compute/report-a-machine-problem"},{"title":"List machine problem reports","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/machineproblemreports","href":"/api-reference/compute/list-machine-problem-reports"},{"title":"Get machine problem report","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/machineproblemreports/{name}","href":"/api-reference/compute/get-machine-problem-report"}]},{"group":"Event subscriptions","pages":[{"title":"List event actions","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/eventactions","href":"/api-reference/compute/list-event-actions"},{"title":"Create event subscription","description":"Sends machine events to an HTTPS endpoint you choose. Choose `topic` and `actions` from List event actions. `uri` can be at most 2,048 bytes, and `actions` at most 64 names of at most 64 bytes each. The response carries the subscription's signing key, `hmacKey`, which only this operation and Rotate signing key return: keep it to verify each delivery's signature. A name that already exists answers 409 and changes nothing. The subscription belongs to your account, not to whoever created it. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability.\n\nService accounts can call it with the `compute:CreateEventSubscription` permission.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json post /compute/v2/eventsubscriptions","href":"/api-reference/compute/create-event-subscription"},{"title":"Get event subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/eventsubscriptions/{name}","href":"/api-reference/compute/get-event-subscription"},{"title":"List event subscriptions","description":"Returns one page of your account's event subscriptions, ordered by name, without their signing keys. Every account can use event subscriptions. In an account whose Macs your organization manages, they need the events capability.\n\nService accounts can call it with the `compute:ListEventSubscriptions` permission.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json get /compute/v2/eventsubscriptions","href":"/api-reference/compute/list-event-subscriptions"},{"title":"Update event subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json patch /compute/v2/eventsubscriptions/{name}","href":"/api-reference/compute/update-event-subscription"},{"title":"Rotate signing key","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json post /compute/v2/eventsubscriptions/{name}/key","href":"/api-reference/compute/rotate-signing-key"},{"title":"Delete event subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi/compute.json delete /compute/v2/eventsubscriptions/{name}","href":"/api-reference/compute/delete-event-subscription"}]}]},{"group":"Billing","pages":[{"group":"Account and funds","pages":[{"title":"Get billing account","deprecated":null,"version":null,"openapi":"/api-reference/openapi/billing.json get /billing/v1/account","href":"/api-reference/billing/get-billing-account"},{"title":"Get funding status","deprecated":null,"version":null,"openapi":"/api-reference/openapi/billing.json get /billing/v1/funding","href":"/api-reference/billing/get-funding-status"},{"title":"Get credits","deprecated":null,"version":null,"openapi":"/api-reference/openapi/billing.json get /billing/v1/credits","href":"/api-reference/billing/get-credits"}]},{"group":"Usage and costs","pages":[{"title":"Get usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi/billing.json get /billing/v1/usage","href":"/api-reference/billing/get-usage"},{"title":"Get costs","deprecated":null,"version":null,"openapi":"/api-reference/openapi/billing.json get /billing/v1/costs","href":"/api-reference/billing/get-costs"},{"title":"List prices","deprecated":null,"version":null,"openapi":"/api-reference/openapi/billing.json get /billing/v1/price-catalog","href":"/api-reference/billing/list-prices"}]},{"group":"Invoices","pages":[{"title":"List invoices","deprecated":null,"version":null,"openapi":"/api-reference/openapi/billing.json get /billing/v1/invoices","href":"/api-reference/billing/list-invoices"},{"title":"Get invoice","deprecated":null,"version":null,"openapi":"/api-reference/openapi/billing.json get /billing/v1/invoices/{invoice_id}","href":"/api-reference/billing/get-invoice"}]}]},{"group":"Account","pages":[{"title":"Get account","deprecated":null,"version":null,"openapi":"/api-reference/openapi/account.json get /admin/v1/account","href":"/api-reference/account/get-account"},{"title":"Update account","deprecated":null,"version":null,"openapi":"/api-reference/openapi/account.json patch /admin/v1/account","href":"/api-reference/account/update-account"}]}]}]}]},"basePath":"","title":"Get event subscription - Mount Thor","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}