{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pramaan","description":"Provider-neutral capabilities behind one API: search, enrichment, social data, email, payments and more.","colors":{"primary":"#2F5D50","light":"#6FA58F","dark":"#2F5D50"},"api":{"playground":{"display":"interactive"},"examples":{"languages":["bash","javascript","python"]}},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pramaan","hasAudioNarration":false,"actualSubdomain":"pramaan","customDomains":["docs.pramaan.dev"],"gitSource":{"type":"github","owner":"pramaan-dev","repo":"capabilities-lab","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adbe7ffbf69fb6fbc89ac3d","collectionId":"d5b92733-dc5c-4a3b-a67a-cf0a9e1d8561","liveDeploymentHistoryId":"6adbe7ffbf69fb6fbc89ac3d","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6adbe7ffbf69fb6fbc89ac3d","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"Superpowers","count":3574},{"language":"default","tag":"Missions","count":876},{"language":"default","tag":"Social media","count":727},{"language":"default","tag":"Finance","count":564},{"language":"default","tag":"Data","count":501},{"language":"default","tag":"Developer tools","count":486},{"language":"default","tag":"Gen AI","count":469},{"language":"default","tag":"Phone \u0026 messaging","count":383},{"language":"default","tag":"AI search and SEO","count":311},{"language":"default","tag":"Travel \u0026 places","count":283}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"editor-nav-generations","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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run","slug":"/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run","pageMetadata":{"title":"Describe one outcome: its schemas and the capability steps it may run","description":null,"deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/outcomes/{id}","href":"/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run","autogeneratedByOpenApi":true},"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":"Describe one outcome: its schemas and the capability steps it may run","description":null,"deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/outcomes/{id}","href":"/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"describeOutcome","tags":["outcomes"],"summary":"Describe one outcome: its schemas and the capability steps it may run","security":["4f1180ac-3556-45e4-aee2-89c4f6c67584"],"parameters":["54036908-a336-4edd-99a0-c13564205c2c"],"responses":{"200":"954c99e5-ef7c-4129-bc78-5ab5c3542faf","default":"d88410b6-6188-4744-a1e5-56e18ae358e3"},"method":"get","type":"path","servers":["3ac9b93f-e757-45b0-9465-c19d9818577f"],"path":"/v1/outcomes/{id}","baseUrlOptions":["https://api.pramaan.dev"],"title":"Describe one outcome: its schemas and the capability steps it may run","description":"","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"54036908-a336-4edd-99a0-c13564205c2c":{"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"id","in":"path"}},"responses":{"954c99e5-ef7c-4129-bc78-5ab5c3542faf":{"description":"The outcome","content":{"application/json":{"schema":{"type":"object","required":["input_schema","options_schema","result_schema","steps","id","description","version","effect_class","mode","price_max_micro","personal_data","available"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"description":{"type":"string","isRequired":true,"uniqueKey":"description","typeLabel":"string"},"version":{"type":"integer","isRequired":true,"uniqueKey":"version","typeLabel":"integer"},"effect_class":{"type":"string","description":"The highest effect class among the steps it may run.","isRequired":true,"uniqueKey":"effect_class","typeLabel":"string"},"mode":{"type":"string","enum":["sync","async"],"description":"async: the run answers 202 with a job; poll GET /v1/jobs/{id}.","isRequired":true,"uniqueKey":"mode","typeLabel":"enum\u003cstring>"},"price_max_micro":{"type":"integer","description":"The most a run can cost with every step on, micro-USD.","isRequired":true,"uniqueKey":"price_max_micro","typeLabel":"integer"},"personal_data":{"type":"boolean","description":"true: a step looks up, scores or contacts a person.","isRequired":true,"uniqueKey":"personal_data","typeLabel":"boolean"},"available":{"type":"boolean","description":"false: a step's capability is not served yet.","isRequired":true,"uniqueKey":"available","typeLabel":"boolean"},"input_schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"input_schema.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"input_schema","typeLabel":"object"},"options_schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"options_schema.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"options_schema","typeLabel":"object"},"result_schema":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"result_schema.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"result_schema","typeLabel":"object"},"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"steps.items.[INDEX].id","typeLabel":"string"},"label":{"type":"string","isRequired":true,"uniqueKey":"steps.items.[INDEX].label","typeLabel":"string"},"capability":{"type":"string","isRequired":true,"uniqueKey":"steps.items.[INDEX].capability","typeLabel":"string"},"effect_class":{"type":"string","isRequired":true,"uniqueKey":"steps.items.[INDEX].effect_class","typeLabel":"string"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"steps.items.[INDEX].required","typeLabel":"boolean"},"max_calls":{"type":"integer","isRequired":true,"uniqueKey":"steps.items.[INDEX].max_calls","typeLabel":"integer"},"requires_approval":{"type":"boolean","isRequired":true,"uniqueKey":"steps.items.[INDEX].requires_approval","typeLabel":"boolean"},"price_max_micro":{"type":"integer","isRequired":true,"uniqueKey":"steps.items.[INDEX].price_max_micro","typeLabel":"integer"},"mode":{"type":"string","enum":["sync","async"],"isRequired":true,"uniqueKey":"steps.items.[INDEX].mode","typeLabel":"enum\u003cstring>"},"needs_connection":{"type":"boolean","isRequired":true,"uniqueKey":"steps.items.[INDEX].needs_connection","typeLabel":"boolean"}},"required":["id","label","capability","effect_class","required","max_calls","requires_approval","price_max_micro","mode","needs_connection"],"uniqueKey":"steps.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"steps","typeLabel":"object[]"},"read_only_key":{"type":"boolean","description":"True when the calling key may only run read_only capabilities.","uniqueKey":"read_only_key","typeLabel":"boolean"},"requires_approval":{"type":"boolean","enum":[true],"description":"Present when a step asks a person to approve: a run then needs Pramaan-Plan.","uniqueKey":"requires_approval","typeLabel":"enum\u003cboolean>"},"capability_ids":{"type":"array","items":{"type":"string","uniqueKey":"capability_ids.items.[INDEX]","typeLabel":"string"},"description":"Capability ids in mission step order.","uniqueKey":"capability_ids","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","description":"\u003cstring>","version":123,"effect_class":"\u003cstring>","mode":"sync","price_max_micro":123,"personal_data":true,"available":true,"input_schema":{},"options_schema":{},"result_schema":{},"steps":[{"id":"\u003cstring>","label":"\u003cstring>","capability":"\u003cstring>","effect_class":"\u003cstring>","required":true,"max_calls":123,"requires_approval":true,"price_max_micro":123,"mode":"sync","needs_connection":true}],"read_only_key":true,"requires_approval":true,"capability_ids":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"d88410b6-6188-4744-a1e5-56e18ae358e3":{"description":"Error (see the error guide for codes)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["addendum_required","invalid_request","unauthorized","forbidden","spend_cap_reached","not_found","job_not_found","conflict","connection_required","rate_limited","internal","upstream_unavailable","upstream_timeout"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","maxLength":200,"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"next":{"type":"string","maxLength":200,"isRequired":true,"uniqueKey":"error.next","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"effect":{"type":"string","enum":["none"],"description":"Present when nothing was sent, charged or created: every source refused before acting, or the request was refused before anything ran (validation, approval, balance, limits). Absent when anything may have happened: check before retrying an action.","uniqueKey":"error.effect","typeLabel":"enum\u003cstring>"},"slot":{"type":"string","uniqueKey":"error.slot","typeLabel":"string"},"required_micro":{"type":"integer","description":"With `spend_cap_reached`: the most the request can cost, micro-USD.","uniqueKey":"error.required_micro","typeLabel":"integer"},"reason":{"type":"string","enum":["balance","daily_cap","member_limit","approval_required"],"description":"With `spend_cap_reached`: not enough credit, the daily spend cap, or the spending limit of the member the call acts as. With `forbidden`: `approval_required`, the call needs an approver (send `Pramaan-Approved-By`).","uniqueKey":"error.reason","typeLabel":"enum\u003cstring>"},"plan":{"type":"string","description":"With `approval_required` on an outcome: the plan to show a person, then send in `Pramaan-Plan`.","uniqueKey":"error.plan","typeLabel":"string"},"needs":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["approval"],"isRequired":true,"uniqueKey":"error.needs.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"detail":{"type":"string","isRequired":true,"uniqueKey":"error.needs.items.[INDEX].detail","typeLabel":"string"},"step":{"type":"string","uniqueKey":"error.needs.items.[INDEX].step","typeLabel":"string"}},"required":["kind","detail"],"uniqueKey":"error.needs.items.[INDEX]","typeLabel":"object"},"description":"With `approval_required` on an outcome: the steps that ask a person to approve.","uniqueKey":"error.needs","typeLabel":"object[]"}},"required":["code","message","next","request_id","retryable"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"addendum_required","message":"\u003cstring>","next":"\u003cstring>","request_id":"\u003cstring>","retryable":true,"effect":"none","slot":"\u003cstring>","required_micro":123,"reason":"balance","plan":"\u003cstring>","needs":[{"kind":"approval","detail":"\u003cstring>","step":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4f1180ac-3556-45e4-aee2-89c4f6c67584":{"bearer":{"type":"http","scheme":"bearer","description":"API key: `sk_live_…`","scopes":[],"schemeName":"bearer"}}},"servers":{"3ac9b93f-e757-45b0-9465-c19d9818577f":{"url":"https://api.pramaan.dev"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key: `sk_live_…`","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key: `sk_live_…`","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"specs/platform.json"},"subdomain":"pramaan","siteName":"Pramaan","title":"Describe one outcome: its schemas and the capability steps it may run - Pramaan","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T23:06:51.207Z","originalFileLocation":"platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run.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=\"application-name\" content=\"Pramaan\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/pramaan/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/pramaan/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/pramaan/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/pramaan/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Describe one outcome: its schemas and the capability steps it may run - Pramaan\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pramaan\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.pramaan.dev/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pramaan.mintlify.app/_mintlify/api/og/v2?division=outcomes\u0026amp;title=Describe+one+outcome%3A+its+schemas+and+the+capability+steps+it+may+run\u0026amp;theme=6306bb51639d389103e420be\u0026amp;signature=838c7f7eb4ef20f9e70f161e168eebd710f1db07b504ddef35e348b77104f531\">\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=\"Describe one outcome: its schemas and the capability steps it may run - Pramaan\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pramaan.mintlify.app/_mintlify/api/og/v2?division=outcomes\u0026amp;title=Describe+one+outcome%3A+its+schemas+and+the+capability+steps+it+may+run\u0026amp;theme=6306bb51639d389103e420be\u0026amp;signature=838c7f7eb4ef20f9e70f161e168eebd710f1db07b504ddef35e348b77104f531\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/pramaan/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pramaan\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2F5D50\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.pramaan.dev/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/platform/outcomes/describe-one-outcome%3A-its-schemas-and-the-capability-steps-it-may-run.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.pramaan.dev/#organization\",\"name\":\"Pramaan\",\"url\":\"https://docs.pramaan.dev\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.pramaan.dev#website\",\"name\":\"Pramaan\",\"url\":\"https://docs.pramaan.dev\",\"publisher\":{\"@id\":\"https://docs.pramaan.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.pramaan.dev/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run#webpage\",\"url\":\"https://docs.pramaan.dev/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run\",\"name\":\"Describe one outcome: its schemas and the capability steps it may run\",\"dateModified\":\"2026-10-23T23:06:51.207Z\",\"isPartOf\":{\"@id\":\"https://docs.pramaan.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.pramaan.dev/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.pramaan.dev/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"outcomes\",\"item\":\"https://docs.pramaan.dev/platform/outcomes/list-outcomes:-a-fixed-sequence-of-capability-steps-under-one-business-name\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Describe one outcome: its schemas and the capability steps it may run\",\"item\":\"https://docs.pramaan.dev/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.pramaan.dev/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run#apireference\",\"headline\":\"Describe one outcome: its schemas and the capability steps it may run\",\"name\":\"Describe one outcome: its schemas and the capability steps it may run\",\"url\":\"https://docs.pramaan.dev/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run\",\"mainEntityOfPage\":{\"@id\":\"https://docs.pramaan.dev/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run#webpage\"},\"dateModified\":\"2026-10-23T23:06:51.207Z\",\"publisher\":{\"@id\":\"https://docs.pramaan.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.pramaan.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Pramaan\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Pramaan","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Superpowers","menu":[{"item":"Data","description":"Companies, people and contacts: research, lead lists, work emails and company signals.","pages":[{"title":"Data","href":"/superpowers/agency-directory/agencieslist-categories"}]},{"item":"Social media","description":"Posts, profiles, comments and trends on every network, and posting from your accounts.","pages":[{"title":"Social media","href":"/superpowers/apple-music/apple-musicalbumdetail"}]},{"item":"AI search and SEO","description":"Rankings, keywords, backlinks, and how AI answer engines see your brand.","pages":[{"title":"AI search and SEO","href":"/superpowers/ai-answer-engines/aeobrandstop"}]},{"item":"Advertising","description":"Your ad accounts, competitors' ads, audiences and creator deals.","pages":[{"title":"Advertising","href":"/superpowers/ad-accounts/adsaccountconnectcredentials"}]},{"item":"News","description":"Headlines, articles and news feeds on any topic, company or market.","pages":[{"title":"News","href":"/superpowers/company-news/companiesnews"}]},{"item":"Research","description":"Deep research, academic papers and answers that cite their sources.","pages":[{"title":"Research","href":"/superpowers/google-dataset-search/googledatasetdetail"}]},{"item":"Legal","description":"Courts, cases, dockets, judges and statutes.","pages":[{"title":"Legal","href":"/superpowers/company-court-records/companieslitigationlist"}]},{"item":"Web tools","description":"Read, scrape and watch any website, or drive a real browser.","pages":[{"title":"Web tools","href":"/superpowers/remote-browser/browsercaptchasolve"}]},{"item":"E-commerce","description":"Products, prices, reviews and marketplaces, through to shipping and tracking.","pages":[{"title":"E-commerce","href":"/superpowers/amazon/amazonbestsellerslist"}]},{"item":"Travel \u0026 places","description":"Maps, places, addresses, property, routes, weather and travel.","pages":[{"title":"Travel \u0026 places","href":"/superpowers/addresses-and-geocoding/addressverify"}]},{"item":"Finance","description":"Take payments, run billing, move money, handle tax and read the markets.","pages":[{"title":"Finance","href":"/superpowers/open-banking/bankingaccountbalancesget"}]},{"item":"Crypto \u0026 DeFi","description":"Tokens, wallets, chains, DeFi yields and on-chain data.","pages":[{"title":"Crypto \u0026 DeFi","href":"/superpowers/wallets-and-on-chain/cryptoaddressvalidate"}]},{"item":"Gen AI","description":"Make images, video, voice and music, and call language models.","pages":[{"title":"Gen AI","href":"/superpowers/ai-model-rankings/ai-modelsarenabest-coding-models"}]},{"item":"Email \u0026 calendar","description":"Send and read email, and book, run and sum up meetings.","pages":[{"title":"Email \u0026 calendar","href":"/superpowers/calendar/calendaragendaget"}]},{"item":"Phone \u0026 messaging","description":"Calls, AI phone agents, SMS, WhatsApp, chat and one-time codes.","pages":[{"title":"Phone \u0026 messaging","href":"/superpowers/in-app-chat/chatchannelcreate"}]},{"item":"Hiring \u0026 assessments","description":"Jobs, pay, candidates and proctored tests.","pages":[{"title":"Hiring \u0026 assessments","href":"/superpowers/proctored-exams/assessmentexamcreate"}]},{"item":"Identity \u0026 security","description":"Verify people, stop fraud, run sign-in and check for threats.","pages":[{"title":"Identity \u0026 security","href":"/superpowers/sign-in-and-users/authbackenddelete"}]},{"item":"Developer tools","description":"Code, deploys, storage, databases, workflows and documents.","pages":[{"title":"Developer tools","href":"/superpowers/connected-apps/appsactionchoices"}]},{"item":"Other","pages":[{"title":"Other","href":"/superpowers/other/adsaccountinvitationcreate"}]}],"pages":[{"title":"Superpowers","href":"/superpowers/agency-directory/agencieslist-categories"}]},{"tab":"Missions","menu":[{"item":"Data","description":"Companies, people and contacts: research, lead lists, work emails and company signals.","pages":[{"title":"Data","href":"/missions/data/accountcontactsmap"}]},{"item":"Social media","description":"Posts, profiles, comments and trends on every network, and posting from your accounts.","pages":[{"title":"Social media","href":"/missions/social-media/advocatesfind"}]},{"item":"AI search and SEO","description":"Rankings, keywords, backlinks, and how AI answer engines see your brand.","pages":[{"title":"AI search and SEO","href":"/missions/ai-search-and-seo/aeocitationgap"}]},{"item":"Advertising","description":"Your ad accounts, competitors' ads, audiences and creator deals.","pages":[{"title":"Advertising","href":"/missions/advertising/adintel"}]},{"item":"News","description":"Headlines, articles and news feeds on any topic, company or market.","pages":[{"title":"News","href":"/missions/news/brandmentionsreport"}]},{"item":"Research","description":"Deep research, academic papers and answers that cite their sources.","pages":[{"title":"Research","href":"/missions/research/answercompare"}]},{"item":"Legal","description":"Courts, cases, dockets, judges and statutes.","pages":[{"title":"Legal","href":"/missions/legal/caselawresearch"}]},{"item":"Web tools","description":"Read, scrape and watch any website, or drive a real browser.","pages":[{"title":"Web tools","href":"/missions/web-tools/brandnameavailability"}]},{"item":"E-commerce","description":"Products, prices, reviews and marketplaces, through to shipping and tracking.","pages":[{"title":"E-commerce","href":"/missions/e-commerce/amazoncompetitormap"}]},{"item":"Travel \u0026 places","description":"Maps, places, addresses, property, routes, weather and travel.","pages":[{"title":"Travel \u0026 places","href":"/missions/travel-\u0026-places/addresscheck"}]},{"item":"Finance","description":"Take payments, run billing, move money, handle tax and read the markets.","pages":[{"title":"Finance","href":"/missions/finance/bankaccountconfirm"}]},{"item":"Crypto \u0026 DeFi","description":"Tokens, wallets, chains, DeFi yields and on-chain data.","pages":[{"title":"Crypto \u0026 DeFi","href":"/missions/crypto-\u0026-defi/airdropscout"}]},{"item":"Gen AI","description":"Make images, video, voice and music, and call language models.","pages":[{"title":"Gen AI","href":"/missions/gen-ai/audiocaptionsync"}]},{"item":"Email \u0026 calendar","description":"Send and read email, and book, run and sum up meetings.","pages":[{"title":"Email \u0026 calendar","href":"/missions/email-\u0026-calendar/dailyagenda"}]},{"item":"Phone \u0026 messaging","description":"Calls, AI phone agents, SMS, WhatsApp, chat and one-time codes.","pages":[{"title":"Phone \u0026 messaging","href":"/missions/phone-\u0026-messaging/broadcastdraft"}]},{"item":"Hiring \u0026 assessments","description":"Jobs, pay, candidates and proctored tests.","pages":[{"title":"Hiring \u0026 assessments","href":"/missions/hiring-\u0026-assessments/assessmentexambuild"}]},{"item":"Identity \u0026 security","description":"Verify people, stop fraud, run sign-in and check for threats.","pages":[{"title":"Identity \u0026 security","href":"/missions/identity-\u0026-security/accessreview"}]},{"item":"Developer tools","description":"Code, deploys, storage, databases, workflows and documents.","pages":[{"title":"Developer tools","href":"/missions/developer-tools/agentrunreview"}]}],"pages":[{"title":"Missions","href":"/missions/data/accountcontactsmap"}]},{"tab":"Platform API","groups":[{"group":"platform","pages":[{"title":"Start a direct file upload (link valid 15 minutes)","deprecated":null,"version":null,"openapi":"/specs/platform.json post /v1/files/uploads","href":"/platform/platform/start-a-direct-file-upload-link-valid-15-minutes"},{"title":"Check an uploaded file and make it ready","deprecated":null,"version":null,"openapi":"/specs/platform.json post /v1/files/{id}/finish","href":"/platform/platform/check-an-uploaded-file-and-make-it-ready"},{"title":"List your files, newest first","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/files","href":"/platform/platform/list-your-files-newest-first"},{"title":"Upload a file to pass to a capability as `fileId`","deprecated":null,"version":null,"openapi":"/specs/platform.json post /v1/files","href":"/platform/platform/upload-a-file-to-pass-to-a-capability-as-`fileid`"},{"title":"One file's facts and a fresh link","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/files/{id}","href":"/platform/platform/one-files-facts-and-a-fresh-link"},{"title":"Delete a file now; its links stop working at once","deprecated":null,"version":null,"openapi":"/specs/platform.json delete /v1/files/{id}","href":"/platform/platform/delete-a-file-now;-its-links-stop-working-at-once"},{"title":"List capabilities","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/capabilities","href":"/platform/platform/list-capabilities"},{"title":"Describe one capability, with its request and result JSON Schema","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/capabilities/{id}","href":"/platform/platform/describe-one-capability-with-its-request-and-result-json-schema"},{"title":"What a request would cost at most, without running it","deprecated":null,"version":null,"openapi":"/specs/platform.json post /v1/capabilities/{id}/estimate","href":"/platform/platform/what-a-request-would-cost-at-most-without-running-it"},{"title":"Job status: running, done (with result) or failed (with error)","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/jobs/{id}","href":"/platform/platform/job-status:-running-done-with-result-or-failed-with-error"},{"title":"Cancel a running job","deprecated":null,"version":null,"openapi":"/specs/platform.json post /v1/jobs/{id}/cancel","href":"/platform/platform/cancel-a-running-job"},{"title":"Calls and spend per capability per day","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/usage","href":"/platform/platform/calls-and-spend-per-capability-per-day"},{"title":"Credit balance, credit set aside for running requests, and today's spend","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/balance","href":"/platform/platform/credit-balance-credit-set-aside-for-running-requests-and-todays-spend"},{"title":"Workspace addendum acceptances","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/workspace/addenda","href":"/platform/platform/workspace-addendum-acceptances"},{"title":"Accept the current background-checks addendum","deprecated":null,"version":null,"openapi":"/specs/platform.json post /v1/workspace/addenda","href":"/platform/platform/accept-the-current-background-checks-addendum"},{"title":"The people in your organisation, with their roles","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/members","href":"/platform/platform/the-people-in-your-organisation-with-their-roles"},{"title":"Your connected accounts: the ids routing rules and Pramaan-Account name","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/accounts","href":"/platform/platform/your-connected-accounts:-the-ids-routing-rules-and-pramaan-account-name"},{"title":"Your routing rules for this environment","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/routing-policy","href":"/platform/platform/your-routing-rules-for-this-environment"},{"title":"Replace your routing rules","deprecated":null,"version":null,"openapi":"/specs/platform.json put /v1/routing-policy","href":"/platform/platform/replace-your-routing-rules"},{"title":"Close your workspace","deprecated":null,"version":null,"openapi":"/specs/platform.json post /v1/workspace/close","href":"/platform/platform/close-your-workspace"},{"title":"Your organisation and its display name","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/organization","href":"/platform/platform/your-organisation-and-its-display-name"},{"title":"Set your organisation's display name","deprecated":null,"version":null,"openapi":"/specs/platform.json put /v1/organization","href":"/platform/platform/set-your-organisations-display-name"},{"title":"Move an end user off the account a sticky rule bound them to","deprecated":null,"version":null,"openapi":"/specs/platform.json delete /v1/bindings/{family}/{endUser}","href":"/platform/platform/move-an-end-user-off-the-account-a-sticky-rule-bound-them-to"}]},{"group":"outcomes","pages":[{"title":"List outcomes: a fixed sequence of capability steps under one business name","description":null,"deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/outcomes","href":"/platform/outcomes/list-outcomes:-a-fixed-sequence-of-capability-steps-under-one-business-name"},{"title":"Describe one outcome: its schemas and the capability steps it may run","deprecated":null,"version":null,"openapi":"/specs/platform.json get /v1/outcomes/{id}","href":"/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run"},{"title":"The plan for one input, without running it","description":"Send the body you would send to the run. Nothing runs, nothing is charged or set aside. Show a person the steps and your input, then send `plan` back in Pramaan-Plan when you run.","deprecated":null,"version":null,"openapi":"/specs/platform.json post /v1/outcomes/{id}/estimate","href":"/platform/outcomes/the-plan-for-one-input-without-running-it"}]}]}]},"title":"Describe one outcome: its schemas and the capability steps it may run - Pramaan","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}