Say the result you want: which fields, renamed how, filtered, sorted, grouped, counted or averaged. Pomerado writes the shape’s code and checks it against every form the tool’s result can take before saving it. It answers in a few seconds and starts no job.
A shape only reshapes what the tool returns. A request for data the tool doesn’t return answers needs_tool_change: ask for that with POST /v1/tools/{id}/changes. One no shape can do, such as one needing the time or other pages, answers not_possible.
Fields the tool adds later stay out of a shape unless you asked to keep everything; the shape then lists them in new_fields.
Shapes are free, and only you can see and use them. You can have 50 for each tool and 500 in all.
Callers: an API key, an integration’s API key, an MCP OAuth token or a Dashboard session.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
id
string
required
a tool ID: tool_ and 32 lowercase hex digits
Example:
"tool_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
Body
application/json
request
string
required
The result you want, in your own words: which fields, renamed how, filtered, sorted, counted or averaged, such as "only the name and price in dollars, cheapest first"
Required string length: 1 - 2000
Response
The saved shape, or why none was saved
Option 1
Option 2
Option 3
Option 4
outcome
enum<string>
required
Available options:
saved
shape
object
required
Show child attributes
preview
any
required
The shape's result for a made-up result of the tool
message
string
required
What happened, in words
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pomerado","description":"Fast, reliable tools for websites, for AI agents and programs: an MCP server and a REST API.","colors":{"primary":"#c71f3e","light":"#f04a5f","dark":"#a81734"},"logo":{"light":"https://mintcdn.com/pomerado/MWnuKCF6pT3dH-IM/logo/light.svg?fit=max\u0026auto=format\u0026n=MWnuKCF6pT3dH-IM\u0026q=85\u0026s=b1723a79805dcc9e0c0982901abf76fd","dark":"https://mintcdn.com/pomerado/MWnuKCF6pT3dH-IM/logo/dark.svg?fit=max\u0026auto=format\u0026n=MWnuKCF6pT3dH-IM\u0026q=85\u0026s=e91dd44a93eff07c2e368db999756f98","href":"https://pomerado.ai"},"favicon":"https://mintcdn.com/pomerado/MWnuKCF6pT3dH-IM/logo/favicon.png?fit=max\u0026auto=format\u0026n=MWnuKCF6pT3dH-IM\u0026q=85\u0026s=78a3bf5220c92811101e80f0f1c2708a","api":{"examples":{"languages":["curl","javascript","python"]}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pomerado","hasAudioNarration":false,"actualSubdomain":"pomerado","customDomains":["docs.pomerado.ai"],"gitSource":{"type":"github","owner":"pomerado","repo":"pomerado-docs","deployBranch":"main","contentDirectory":"public-docs","isPrivate":true,"mountPath":"","label":"","_id":"6af0f181ddecdf8794c0cadb"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af97af859fc4106fcc4e0ad","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API reference","count":134},{"language":"default","tag":"Docs","count":51},{"language":"default","tag":"Guides","count":41},{"language":"default","tag":"Tools and integrations","count":25},{"language":"default","tag":"MCP reference","count":18},{"language":"default","tag":"Pomerado MCP","count":16},{"language":"default","tag":"Jobs","count":12},{"language":"default","tag":"Payer profiles","count":11},{"language":"default","tag":"Saved logins","count":10},{"language":"default","tag":"Team","count":10}]},"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":"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/shapes/make-a-shape","slug":"/api-reference/shapes/make-a-shape","pageMetadata":{"title":"Make a shape","description":"Make a shape of a tool from words: your own form for its result, which a run returns when you pass the shape's id as shape.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/tools/{id}/shapes","href":"/api-reference/shapes/make-a-shape","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Make a shape of a tool from words: your own form for its result, which a run returns when you pass the shape’s id as shape.\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);return _jsx(Accordion,{title:`Details`,id:`details`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Say the result you want: which fields, renamed how, filtered, sorted, grouped, counted or averaged. Pomerado writes the shape’s code and checks it against every form the tool’s result can take before saving it. It answers in a few seconds and starts no job.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`A shape only reshapes what the tool returns. A request for data the tool doesn’t return answers needs_tool_change: ask for that with POST /v1/tools/{id}/changes. One no shape can do, such as one needing the time or other pages, answers not_possible.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Fields the tool adds later stay out of a shape unless you asked to keep everything; the shape then lists them in new_fields.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Shapes are free, and only you can see and use them. You can have 50 for each tool and 500 in all.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Callers:`}),` an API key, an integration’s API key, an MCP OAuth token or a Dashboard session.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Permission:`}),` `,_jsx(_components.code,{children:`runs:create`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Effect:`}),` Creates or changes something.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Errors:`}),` `,_jsx(_components.a,{href:`/errors#not_found`,children:_jsx(_components.code,{children:`not_found`})}),`, `,_jsx(_components.a,{href:`/errors#sign_in_required`,children:_jsx(_components.code,{children:`sign_in_required`})}),`, `,_jsx(_components.a,{href:`/errors#shape_limit_reached`,children:_jsx(_components.code,{children:`shape_limit_reached`})}),`, `,_jsx(_components.a,{href:`/errors#shape_create_throttled`,children:_jsx(_components.code,{children:`shape_create_throttled`})}),`, and the `,_jsx(_components.a,{href:`/errors`,children:`errors any request can get`}),`.`]}),`\n`]}),`\n`]})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Make a shape","description":"Make a shape of a tool from words: your own form for its result, which a run returns when you pass the shape's id as shape.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/tools/{id}/shapes","href":"/api-reference/shapes/make-a-shape","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"shapes.create","tags":["shapes"],"summary":"Make a shape","description":"Make a shape of a tool from words: your own form for its result, which a run returns when you pass the shape's id as shape.","parameters":["da94dc45-85fa-4f8d-ba10-e1c079b2631f"],"requestBody":"bcdf8562-082a-4812-a95b-b55fba26930e","responses":{"200":"5171a79c-3f2b-4da7-b537-0d9335397bd8","400":"5d0f889f-3adb-4448-a21c-6e1ba228c06f","401":"3a9ec200-ba50-461f-a848-2d2a59b0ab31","403":"5e4f3497-e7a1-4296-9616-75696a1b9a0c","404":"652adb81-5d03-4380-839a-2ee53db99cff","409":"e9f70ff1-7b61-438a-a03e-40816a04d214","410":"c263b194-0bc9-4c96-b793-0b7902b119ae","413":"53ab536e-dd3b-425f-addb-f16777c6f12c","429":"ccec1725-1907-4a61-b10d-fac3f7d82ce6","500":"d2ec9a93-64e9-41ce-9a07-9d23d1d4e10d","503":"173c29c9-275c-439b-91d9-0acb3c2ed863"},"security":["6495b004-3efd-44f8-884c-df6bf26992ae"],"x-pomerado-effect":"write","x-pomerado-callers":["session","oauth","api_key","integration_key","service_account_key"],"x-pomerado-permission":"runs:create","x-mint":{"content":"\u003cAccordion title=\"Details\">\n\n- Say the result you want: which fields, renamed how, filtered, sorted, grouped, counted or averaged. Pomerado writes the shape's code and checks it against every form the tool's result can take before saving it. It answers in a few seconds and starts no job.\n- A shape only reshapes what the tool returns. A request for data the tool doesn't return answers needs_tool_change: ask for that with POST /v1/tools/\\{id\\}/changes. One no shape can do, such as one needing the time or other pages, answers not_possible.\n- Fields the tool adds later stay out of a shape unless you asked to keep everything; the shape then lists them in new_fields.\n- Shapes are free, and only you can see and use them. You can have 50 for each tool and 500 in all.\n\n- **Callers:** an API key, an integration's API key, an MCP OAuth token or a Dashboard session.\n- **Permission:** `runs:create`.\n- **Effect:** Creates or changes something.\n- **Errors:** [`not_found`](/errors#not_found), [`sign_in_required`](/errors#sign_in_required), [`shape_limit_reached`](/errors#shape_limit_reached), [`shape_create_throttled`](/errors#shape_create_throttled), and the [errors any request can get](/errors).\n\n\u003c/Accordion>"},"method":"post","type":"path","servers":["c6a56640-289a-4948-a5b3-bf54ed227851"],"path":"/v1/tools/{id}/shapes","baseUrlOptions":["https://api.pomerado.ai"],"title":"Make a shape","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"da94dc45-85fa-4f8d-ba10-e1c079b2631f":{"name":"id","in":"path","required":true,"description":"a tool ID: tool_ and 32 lowercase hex digits","schema":{"type":"string","examples":["tool_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"],"isRequired":true,"description":"a tool ID: tool_ and 32 lowercase hex digits","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["request"],"properties":{"request":{"type":"string","description":"The result you want, in your own words: which fields, renamed how, filtered, sorted, counted or averaged, such as \"only the name and price in dollars, cheapest first\"","minLength":1,"maxLength":2000,"isRequired":true,"uniqueKey":"request","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"request":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"5171a79c-3f2b-4da7-b537-0d9335397bd8":{"description":"The saved shape, or why none was saved","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["outcome","shape","preview","message"],"properties":{"outcome":{"type":"string","enum":["saved"],"isRequired":true,"uniqueKey":"oneOf.0.outcome","typeLabel":"enum\u003cstring>"},"shape":{"type":"object","required":["id","tool_id","name","request","version","code","output_schema","passes_new_fields","new_fields","created_at","updated_at"],"properties":{"id":{"type":"string","description":"shp_ and 32 lowercase hex digits","isRequired":true,"uniqueKey":"oneOf.0.shape.id","typeLabel":"string"},"tool_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.shape.tool_id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.shape.name","typeLabel":"string"},"request":{"type":"string","description":"The words the current version was made from","isRequired":true,"uniqueKey":"oneOf.0.shape.request","typeLabel":"string"},"version":{"type":"number","isRequired":true,"uniqueKey":"oneOf.0.shape.version","typeLabel":"number"},"code":{"type":"string","description":"The function Pomerado wrote, read-only: a small JavaScript arrow function of the result","isRequired":true,"uniqueKey":"oneOf.0.shape.code","typeLabel":"string"},"output_schema":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"oneOf.0.shape.output_schema.additionalProperties","typeLabel":"any"},"description":"The form the shape's results take, as JSON Schema","isRequired":true,"uniqueKey":"oneOf.0.shape.output_schema","typeLabel":"object"},"passes_new_fields":{"type":"boolean","description":"Whether fields the tool adds later come through the shape too, except one the shape replaces with its own field of the same name, which new_fields lists","isRequired":true,"uniqueKey":"oneOf.0.shape.passes_new_fields","typeLabel":"boolean"},"new_fields":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.shape.new_fields.items.[INDEX]","typeLabel":"string"},"description":"Fields the tool returns now that the shape leaves out","isRequired":true,"uniqueKey":"oneOf.0.shape.new_fields","typeLabel":"string[]"},"created_at":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.shape.created_at","typeLabel":"string"},"updated_at":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.shape.updated_at","typeLabel":"string"},"notice":{"type":"string","description":"Present when new_fields isn't empty: says so, and how to add them","uniqueKey":"oneOf.0.shape.notice","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.0.shape","typeLabel":"object"},"preview":{"$id":"/schemas/unknown","description":"The shape's result for a made-up result of the tool","isRequired":true,"uniqueKey":"oneOf.0.preview","typeLabel":"any"},"message":{"type":"string","description":"What happened, in words","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["outcome","missing","message"],"properties":{"outcome":{"type":"string","enum":["needs_tool_change"],"isRequired":true,"uniqueKey":"oneOf.1.outcome","typeLabel":"enum\u003cstring>"},"missing":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.missing.items.[INDEX]","typeLabel":"string"},"description":"The data the request needs that the tool doesn't return","isRequired":true,"uniqueKey":"oneOf.1.missing","typeLabel":"string[]"},"message":{"type":"string","description":"What happened, in words","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"},{"type":"object","required":["outcome","message"],"properties":{"outcome":{"type":"string","enum":["not_possible"],"isRequired":true,"uniqueKey":"oneOf.2.outcome","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What happened, in words","isRequired":true,"uniqueKey":"oneOf.2.message","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.2","typeLabel":"object"},{"type":"object","required":["outcome","findings","message"],"properties":{"outcome":{"type":"string","enum":["not_written"],"isRequired":true,"uniqueKey":"oneOf.3.outcome","typeLabel":"enum\u003cstring>"},"findings":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.3.findings.items.[INDEX]","typeLabel":"string"},"description":"Why Pomerado's code didn't pass its checks","isRequired":true,"uniqueKey":"oneOf.3.findings","typeLabel":"string[]"},"message":{"type":"string","description":"What happened, in words","isRequired":true,"uniqueKey":"oneOf.3.message","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.3","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"outcome":"saved","shape":{"id":"\u003cstring>","tool_id":"\u003cstring>","name":"\u003cstring>","request":"\u003cstring>","version":123,"code":"\u003cstring>","output_schema":{},"passes_new_fields":true,"new_fields":["\u003cstring>"],"created_at":"\u003cstring>","updated_at":"\u003cstring>","notice":"\u003cstring>"},"preview":"\u003cunknown>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"5d0f889f-3adb-4448-a21c-6e1ba228c06f":{"description":"invalid_request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"3a9ec200-ba50-461f-a848-2d2a59b0ab31":{"description":"sign_in_required, unauthorized, reauthentication_required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"5e4f3497-e7a1-4296-9616-75696a1b9a0c":{"description":"forbidden","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"652adb81-5d03-4380-839a-2ee53db99cff":{"description":"not_found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"e9f70ff1-7b61-438a-a03e-40816a04d214":{"description":"shape_limit_reached","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"c263b194-0bc9-4c96-b793-0b7902b119ae":{"description":"moved_to_team","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"53ab536e-dd3b-425f-addb-f16777c6f12c":{"description":"request_too_large","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"ccec1725-1907-4a61-b10d-fac3f7d82ce6":{"description":"shape_create_throttled","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"d2ec9a93-64e9-41ce-9a07-9d23d1d4e10d":{"description":"internal_error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"173c29c9-275c-439b-91d9-0acb3c2ed863":{"description":"temporarily_unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable","docs_url"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"docs_url":{"type":"string","isRequired":true,"uniqueKey":"error.docs_url","typeLabel":"string"},"details":{"type":"object","required":[],"properties":{},"additionalProperties":{"oneOf":[{"$id":"/schemas/unknown"}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"uniqueKey":"error.details","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"docs_url":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"6495b004-3efd-44f8-884c-df6bf26992ae":{"bearer":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearer"}}},"servers":{"c6a56640-289a-4948-a5b3-bf54ed227851":{"url":"https://api.pomerado.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearer"},"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":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"pomerado","siteName":"Pomerado","title":"Make a shape - Pomerado","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T09:27:26.872Z","originalFileLocation":"api-reference/shapes/make-a-shape.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=\"Make a shape of a tool from words: your own form for its result, which a run returns when you pass the shape\u0026#x27;s id as shape.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pomerado\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_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/pomerado/OK4DStTtADU9WYMj/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pomerado/OK4DStTtADU9WYMj/_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/pomerado/OK4DStTtADU9WYMj/_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/pomerado/OK4DStTtADU9WYMj/_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/pomerado/OK4DStTtADU9WYMj/_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/pomerado/OK4DStTtADU9WYMj/_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/pomerado/OK4DStTtADU9WYMj/_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/pomerado/OK4DStTtADU9WYMj/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Make a shape - Pomerado\">\u003cmeta data-mint-head property=\"og:description\" content=\"Make a shape of a tool from words: your own form for its result, which a run returns when you pass the shape\u0026#x27;s id as shape.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pomerado\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.pomerado.ai/api-reference/shapes/make-a-shape\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pomerado.mintlify.site/_mintlify/api/og/v2?division=Shapes\u0026amp;title=Make+a+shape\u0026amp;description=Make+a+shape+of+a+tool+from+words%3A+your+own+form+for+its+result%2C+which+a+run+returns+when+you+pass+the+shape%27s+id+as+shape.\u0026amp;theme=43a9dbd260677a50f1d670ed\u0026amp;signature=00a44529b607ef0da4e4b4a1669a6f86ee8d7549a9ce1f3d1bf4e8840eb39727\">\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=\"Make a shape - Pomerado\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Make a shape of a tool from words: your own form for its result, which a run returns when you pass the shape\u0026#x27;s id as shape.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pomerado.mintlify.site/_mintlify/api/og/v2?division=Shapes\u0026amp;title=Make+a+shape\u0026amp;description=Make+a+shape+of+a+tool+from+words%3A+your+own+form+for+its+result%2C+which+a+run+returns+when+you+pass+the+shape%27s+id+as+shape.\u0026amp;theme=43a9dbd260677a50f1d670ed\u0026amp;signature=00a44529b607ef0da4e4b4a1669a6f86ee8d7549a9ce1f3d1bf4e8840eb39727\">\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/pomerado/OK4DStTtADU9WYMj/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pomerado\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#c71f3e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.pomerado.ai/api-reference/shapes/make-a-shape\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/shapes/make-a-shape.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.pomerado.ai/#organization\",\"name\":\"Pomerado\",\"url\":\"https://docs.pomerado.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pomerado/MWnuKCF6pT3dH-IM/logo/light.svg?fit=max\u0026auto=format\u0026n=MWnuKCF6pT3dH-IM\u0026q=85\u0026s=b1723a79805dcc9e0c0982901abf76fd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.pomerado.ai#website\",\"name\":\"Pomerado\",\"url\":\"https://docs.pomerado.ai\",\"publisher\":{\"@id\":\"https://docs.pomerado.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.pomerado.ai/api-reference/shapes/make-a-shape#webpage\",\"url\":\"https://docs.pomerado.ai/api-reference/shapes/make-a-shape\",\"name\":\"Make a shape\",\"description\":\"Make a shape of a tool from words: your own form for its result, which a run returns when you pass the shape's id as shape.\",\"dateModified\":\"2026-11-15T09:27:26.872Z\",\"isPartOf\":{\"@id\":\"https://docs.pomerado.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.pomerado.ai/api-reference/shapes/make-a-shape#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.pomerado.ai/api-reference/shapes/make-a-shape#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Shapes\",\"item\":\"https://docs.pomerado.ai/api-reference/shapes/list-your-shapes-of-a-tool\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Make a shape\",\"item\":\"https://docs.pomerado.ai/api-reference/shapes/make-a-shape\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.pomerado.ai/api-reference/shapes/make-a-shape#apireference\",\"headline\":\"Make a shape\",\"name\":\"Make a shape\",\"description\":\"Make a shape of a tool from words: your own form for its result, which a run returns when you pass the shape's id as shape.\",\"url\":\"https://docs.pomerado.ai/api-reference/shapes/make-a-shape\",\"mainEntityOfPage\":{\"@id\":\"https://docs.pomerado.ai/api-reference/shapes/make-a-shape#webpage\"},\"dateModified\":\"2026-11-15T09:27:26.872Z\",\"publisher\":{\"@id\":\"https://docs.pomerado.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.pomerado.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Pomerado\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Pomerado\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/shapes/make-a-shape.md","siteName":"Pomerado","nav":{"global":null,"anchors":[{"anchor":"Docs","pages":[{"title":"Docs","href":""}]},{"anchor":"API reference","groups":[{"group":"Overview","pages":[{"title":"API reference","sidebarTitle":"Introduction","href":"/api-reference/introduction"}]},{"group":"Account","pages":[{"title":"Get your account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/account","href":"/api-reference/account/get-your-account"},{"title":"Set your name","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/account/name","href":"/api-reference/account/set-your-name"},{"title":"Get your preferences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/account/preferences","href":"/api-reference/account/get-your-preferences"},{"title":"Change your preferences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/account/preferences","href":"/api-reference/account/change-your-preferences"},{"title":"Set your time zone","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/account/time-zone","href":"/api-reference/account/set-your-time-zone"},{"title":"Get your account's privacy settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/account/privacy","href":"/api-reference/account/get-your-accounts-privacy-settings"},{"title":"Change your account's privacy settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/account/privacy","href":"/api-reference/account/change-your-accounts-privacy-settings"},{"title":"Get your card page's brand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/account/card-page","href":"/api-reference/account/get-your-card-pages-brand"},{"title":"Set your card page's brand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/account/card-page","href":"/api-reference/account/set-your-card-pages-brand"}]},{"group":"Runs","pages":[{"title":"List the runs your team started","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/runs","href":"/api-reference/runs/list-the-runs-your-team-started"},{"title":"Run a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/runs","href":"/api-reference/runs/run-a-tool"},{"title":"Run a read-only tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/runs/read-only","href":"/api-reference/runs/run-a-read-only-tool"},{"title":"Run an integration's tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/integrations/{id}/tools/{tool_id}/runs","href":"/api-reference/runs/run-an-integrations-tool"},{"title":"Run a read-only tool on a list of inputs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/runs/read-only/batch","href":"/api-reference/runs/run-a-read-only-tool-on-a-list-of-inputs"},{"title":"Run an integration's read tool on a list of inputs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/integrations/{id}/tools/{tool_id}/runs/batch","href":"/api-reference/runs/run-an-integrations-read-tool-on-a-list-of-inputs"},{"title":"Get a batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/batches/{id}","href":"/api-reference/runs/get-a-batch"},{"title":"Cancel a batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/batches/{id}/cancel","href":"/api-reference/runs/cancel-a-batch"},{"title":"Get a run's log","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/runs/{id}/log","href":"/api-reference/runs/get-a-runs-log"}]},{"group":"Builds","pages":[{"title":"Build a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/builds","href":"/api-reference/builds/build-a-tool"}]},{"group":"Build ideas","pages":[{"title":"Get build ideas","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/suggestions","href":"/api-reference/suggestions/get-build-ideas"}]},{"group":"Jobs","pages":[{"title":"List jobs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs","href":"/api-reference/jobs/list-jobs"},{"title":"Get a job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{id}","href":"/api-reference/jobs/get-a-job"},{"title":"Answer a job's question","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/jobs/{id}/answers","href":"/api-reference/jobs/answer-a-jobs-question"},{"title":"Cancel a job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/jobs/{id}/cancel","href":"/api-reference/jobs/cancel-a-job"},{"title":"Resume a paused build","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/jobs/{id}/resume","href":"/api-reference/jobs/resume-a-paused-build"},{"title":"Get a build's activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{id}/activity","href":"/api-reference/jobs/get-a-builds-activity"}]},{"group":"Tools and integrations","pages":[{"title":"Tools and integrations","sidebarTitle":"Overview","href":"/api-reference/tools-and-integrations"},{"title":"List tools","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/tools","href":"/api-reference/tools/list-tools"},{"title":"Get a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/tools/{id}","href":"/api-reference/tools/get-a-tool"},{"title":"Delete a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/tools/{id}","href":"/api-reference/tools/delete-a-tool"},{"title":"Request a change to a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/tools/{id}/changes","href":"/api-reference/tools/request-a-change-to-a-tool"},{"title":"List integrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/integrations","href":"/api-reference/integrations/list-integrations"},{"title":"List your team's integrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/integrations/team","href":"/api-reference/integrations/list-your-teams-integrations"},{"title":"Get an integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/integrations/{id}","href":"/api-reference/integrations/get-an-integration"},{"title":"Set integration visibility","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/integrations/{id}/visibility","href":"/api-reference/integrations/set-integration-visibility"},{"title":"Delete an integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/integrations/{id}/tools","href":"/api-reference/integrations/delete-an-integration"},{"title":"Get an integration's OpenAPI document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/integrations/{id}/openapi.json","href":"/api-reference/integrations/get-an-integrations-openapi-document"},{"title":"Get an integration's reference","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/integrations/{id}/reference","href":"/api-reference/integrations/get-an-integrations-reference"},{"title":"Add an integration to My integrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/integrations/{id}/added","href":"/api-reference/integrations/add-an-integration-to-my-integrations"},{"title":"Remove an added integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/integrations/{id}/added","href":"/api-reference/integrations/remove-an-added-integration"},{"title":"Get MCP client setup","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/connect","href":"/api-reference/connect/get-mcp-client-setup"},{"title":"List your team's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/code","href":"/api-reference/code/list-your-teams-code"},{"title":"Get a tool's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/code/{id}","href":"/api-reference/code/get-a-tools-code"},{"title":"Download a tool's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/code/{id}/export","href":"/api-reference/code/download-a-tools-code"},{"title":"Get a download link for a tool's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/code/{id}/export-link","href":"/api-reference/code/get-a-download-link-for-a-tools-code"},{"title":"Save a file in a tool's draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/code/{id}/draft","href":"/api-reference/code/save-a-file-in-a-tools-draft"},{"title":"Discard a tool's draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/code/{id}/draft","href":"/api-reference/code/discard-a-tools-draft"},{"title":"Restore an earlier version of a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/code/{id}/versions/{number}/restore","href":"/api-reference/code/restore-an-earlier-version-of-a-tool"},{"title":"Run a tool's code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/code/{id}/runs","href":"/api-reference/code/run-a-tools-code"},{"title":"Read a run's output","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/code/runs/{id}/output","href":"/api-reference/code/read-a-runs-output"},{"title":"Publish a tool's draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/code/{id}/draft/publish","href":"/api-reference/code/publish-a-tools-draft"}]},{"group":"Shapes","pages":[{"title":"List your shapes of a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/tools/{id}/shapes","href":"/api-reference/shapes/list-your-shapes-of-a-tool"},{"title":"Get a shape","description":"Get one of your shapes: its code, the form of its results, the words it was made from and its last 100 versions.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/shapes/{id}","href":"/api-reference/shapes/get-a-shape"},{"title":"Make a shape","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/tools/{id}/shapes","href":"/api-reference/shapes/make-a-shape"},{"title":"Change a shape","description":"Change one of your shapes from words, rename it, or both, as a new version.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/shapes/{id}","href":"/api-reference/shapes/change-a-shape"},{"title":"Delete a shape","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/shapes/{id}","href":"/api-reference/shapes/delete-a-shape"},{"title":"Restore a version of a shape","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/shapes/{id}/restore","href":"/api-reference/shapes/restore-a-version-of-a-shape"}]},{"group":"Files","pages":[{"title":"Get a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/files/{id}","href":"/api-reference/files/get-a-file"},{"title":"Upload a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/files","href":"/api-reference/files/upload-a-file"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/files/{id}","href":"/api-reference/files/delete-a-file"}]},{"group":"Webhooks","pages":[{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Get a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/webhooks/{id}","href":"/api-reference/webhooks/get-a-webhook"},{"title":"Create a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhooks","href":"/api-reference/webhooks/create-a-webhook"},{"title":"Update a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/webhooks/{id}","href":"/api-reference/webhooks/update-a-webhook"},{"title":"Delete a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/webhooks/{id}","href":"/api-reference/webhooks/delete-a-webhook"},{"title":"Test a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhooks/{id}/test","href":"/api-reference/webhooks/test-a-webhook"},{"title":"Rotate a webhook secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/webhooks/{id}/rotate-secret","href":"/api-reference/webhooks/rotate-a-webhook-secret"}]},{"group":"Saved logins","pages":[{"title":"List pending logins","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins/pending","href":"/api-reference/logins/list-pending-logins"},{"title":"List saved logins","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins","href":"/api-reference/logins/list-saved-logins"},{"title":"Get a saved login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins/{id}","href":"/api-reference/logins/get-a-saved-login"},{"title":"Save a login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins","href":"/api-reference/logins/save-a-login"},{"title":"Change a saved login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/logins/{id}","href":"/api-reference/logins/change-a-saved-login"},{"title":"Delete a saved login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/logins/{id}","href":"/api-reference/logins/delete-a-saved-login"},{"title":"Import saved logins","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins/import","href":"/api-reference/logins/import-saved-logins"},{"title":"Get a pending login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins/pending/{id}","href":"/api-reference/logins/get-a-pending-login"},{"title":"Cancel a pending login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/logins/pending/{id}","href":"/api-reference/logins/cancel-a-pending-login"},{"title":"Reveal a saved login","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins/{id}/reveal","href":"/api-reference/logins/reveal-a-saved-login"}]},{"group":"2FA","pages":[{"title":"Replace recovery codes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/logins/{id}/recovery-codes","href":"/api-reference/two_factor/replace-recovery-codes"},{"title":"Get an authenticator code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins/{id}/authenticator-code","href":"/api-reference/two_factor/get-an-authenticator-code"},{"title":"Get a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins/{id}/sms-number","href":"/api-reference/two_factor/get-a-phone-number"},{"title":"Assign a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins/{id}/sms-number","href":"/api-reference/two_factor/assign-a-phone-number"},{"title":"Verify a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/logins/{id}/sms-number/verify","href":"/api-reference/two_factor/verify-a-phone-number"},{"title":"Remove a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/logins/{id}/sms-number","href":"/api-reference/two_factor/remove-a-phone-number"}]},{"group":"Login access","pages":[{"title":"Get login access","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/logins/{id}/access","href":"/api-reference/login_access/get-login-access"},{"title":"Change login access","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/logins/{id}/access","href":"/api-reference/login_access/change-login-access"}]},{"group":"Team","pages":[{"title":"List team members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/team/members","href":"/api-reference/team/list-team-members"},{"title":"List invitations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/team/invitations","href":"/api-reference/team/list-invitations"},{"title":"Get team settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/team","href":"/api-reference/team/get-team-settings"},{"title":"Change a member's role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/team/members/{user_id}","href":"/api-reference/team/change-a-members-role"},{"title":"Remove a team member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/team/members/{user_id}","href":"/api-reference/team/remove-a-team-member"},{"title":"Invite team members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/team/invitations","href":"/api-reference/team/invite-team-members"},{"title":"Resend an invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/team/invitations/{id}/resend","href":"/api-reference/team/resend-an-invitation"},{"title":"Revoke an invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/team/invitations/{id}","href":"/api-reference/team/revoke-an-invitation"},{"title":"Get the team's intent setting","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/team/intent-settings","href":"/api-reference/team/get-the-teams-intent-setting"},{"title":"Change the team's intent setting","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/team/intent-settings","href":"/api-reference/team/change-the-teams-intent-setting"}]},{"group":"Single sign-on","pages":[{"title":"Get the team's single sign-on setup","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/team/sso","href":"/api-reference/sso/get-the-teams-single-sign-on-setup"},{"title":"Open the team's Admin Portal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/team/sso/setup-links","href":"/api-reference/sso/open-the-teams-admin-portal"},{"title":"Email your IT admin a setup link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/team/sso/it-admin-invitations","href":"/api-reference/sso/email-your-it-admin-a-setup-link"}]},{"group":"Audit log","pages":[{"title":"List your team's audit log","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/audit-events","href":"/api-reference/audit/list-your-teams-audit-log"}]},{"group":"API keys","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/api-keys","href":"/api-reference/api_keys/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys","href":"/api-reference/api_keys/create-an-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/api-keys/{id}","href":"/api-reference/api_keys/revoke-an-api-key"},{"title":"Rotate an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys/{id}/rotate","href":"/api-reference/api_keys/rotate-an-api-key"},{"title":"Mark an API key copied","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys/{id}/copied","href":"/api-reference/api_keys/mark-an-api-key-copied"}]},{"group":"Connected apps","pages":[{"title":"List connected apps","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/connected-apps","href":"/api-reference/connected_apps/list-connected-apps"},{"title":"Disconnect an app","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/connected-apps/{id}","href":"/api-reference/connected_apps/disconnect-an-app"}]},{"group":"Usage and quota","pages":[{"title":"Get your usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage","href":"/api-reference/usage/get-your-usage"},{"title":"Get your team's spend this billing period","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage/spend","href":"/api-reference/usage/get-your-teams-spend-this-billing-period"},{"title":"Get your plan limits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/quota","href":"/api-reference/quota/get-your-plan-limits"}]},{"group":"Spend controls","pages":[{"title":"Get your team's daily cap and overage budget","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage/spend-controls","href":"/api-reference/spend_controls/get-your-teams-daily-cap-and-overage-budget"},{"title":"Change your team's daily cap or overage budget","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/usage/spend-controls","href":"/api-reference/spend_controls/change-your-teams-daily-cap-or-overage-budget"},{"title":"List your team's usage alerts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage/alerts","href":"/api-reference/usage_alerts/list-your-teams-usage-alerts"},{"title":"Add a usage alert","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/usage/alerts","href":"/api-reference/usage_alerts/add-a-usage-alert"},{"title":"Change a usage alert","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/usage/alerts/{alert_id}","href":"/api-reference/usage_alerts/change-a-usage-alert"},{"title":"Delete a usage alert","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/usage/alerts/{alert_id}","href":"/api-reference/usage_alerts/delete-a-usage-alert"},{"title":"Get your usage summary email","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage/summary","href":"/api-reference/usage_summary/get-your-usage-summary-email"},{"title":"Change your usage summary email","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/usage/summary","href":"/api-reference/usage_summary/change-your-usage-summary-email"}]},{"group":"Billing","pages":[{"title":"Get your subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/billing","href":"/api-reference/billing/get-your-subscription"},{"title":"Start a Premium checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/billing/checkout","href":"/api-reference/billing/start-a-premium-checkout"},{"title":"Open the billing portal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/billing/portal","href":"/api-reference/billing/open-the-billing-portal"},{"title":"Redeem a free Premium code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/billing/redeem","href":"/api-reference/billing/redeem-a-free-premium-code"}]},{"group":"Payer profiles","pages":[{"title":"List payer profiles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payer-profiles","href":"/api-reference/payer_profiles/list-payer-profiles"},{"title":"Get a payer profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payer-profiles/{id}","href":"/api-reference/payer_profiles/get-a-payer-profile"},{"title":"Create a payer profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/payer-profiles","href":"/api-reference/payer_profiles/create-a-payer-profile"},{"title":"Update a payer profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/payer-profiles/{id}","href":"/api-reference/payer_profiles/update-a-payer-profile"},{"title":"Delete a payer profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/payer-profiles/{id}","href":"/api-reference/payer_profiles/delete-a-payer-profile"},{"title":"Add a payer address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/payer-profiles/{id}/addresses","href":"/api-reference/payer_addresses/add-a-payer-address"},{"title":"Update a payer address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/payer-profiles/{id}/addresses/{address_id}","href":"/api-reference/payer_addresses/update-a-payer-address"},{"title":"Delete a payer address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/payer-profiles/{id}/addresses/{address_id}","href":"/api-reference/payer_addresses/delete-a-payer-address"},{"title":"List payment methods","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payer-profiles/{id}/payment-methods","href":"/api-reference/payment_methods/list-payment-methods"},{"title":"Add a payment method","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/payer-profiles/{id}/payment-methods","href":"/api-reference/payment_methods/add-a-payment-method"},{"title":"Delete a payment method","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/payer-profiles/{id}/payment-methods/{payment_method_id}","href":"/api-reference/payment_methods/delete-a-payment-method"}]},{"group":"Problem reports","pages":[{"title":"Report a problem","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/issue-reports","href":"/api-reference/issue_reports/report-a-problem"}]}]},{"anchor":"MCP reference","pages":[{"title":"MCP reference","href":"/mcp-reference/conventions"}]},{"anchor":"Errors","pages":[{"title":"Errors","href":"/errors"}]}]},"basePath":"","title":"Make a shape - Pomerado","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}