Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
X-Open-Responses
enum<string>
Return Open Responses-compatible output when set (replaces the default response envelope).
Available options:
1,
true
X-Open-Responses-Call-Id
string
Tool call id used for function_call_output items when Open Responses mode is enabled.
Minimum string length: 1
Path Parameters
cardId
string
required
Machines card id.
Minimum string length: 8
Body
application/json
status
enum<string>
Available options:
active,
locked,
canceled,
not_activated
limit
object
Show child attributes
encryptedName
object
Optional encrypted card label. Generate with POST /encryption/encrypt.
Show child attributes
encryptedColor
object
Optional encrypted card color. Generate with POST /encryption/encrypt.
Show child attributes
encryptedEmoji
object
Optional encrypted card emoji. Generate with POST /encryption/encrypt.
Show child attributes
encryptedMemo
object
Optional encrypted card memo. Generate with POST /encryption/encrypt.
Show child attributes
folderId
string | null
isPinned
boolean
sortOrder
integer
Response
Card updated
ok
boolean
required
data
object
required
Show child attributes
summary
string
required
errors
object[]
required
Show child attributes
next
object
Show child attributes
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Machines Cash Docs","colors":{"primary":"#FF4500","light":"#f7f7f7"},"logo":{"light":"https://mintcdn.com/machines-cash/FBFZlb-Jki64gDKi/machines-wordmark.svg?fit=max\u0026auto=format\u0026n=FBFZlb-Jki64gDKi\u0026q=85\u0026s=b2fe18c446fad049723343a7a7bed80e","dark":"https://mintcdn.com/machines-cash/FBFZlb-Jki64gDKi/machines-wordmark.svg?fit=max\u0026auto=format\u0026n=FBFZlb-Jki64gDKi\u0026q=85\u0026s=b2fe18c446fad049723343a7a7bed80e"},"favicon":"/favicon.ico","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript","python"],"prefill":true}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"machines-cash","hasAudioNarration":false,"actualSubdomain":"machines-cash","customDomains":["docs.machines.cash"],"gitSource":{"type":"github","owner":"machines-cash","repo":"machines-cash-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae945cbe58e14fb792655ce:success","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Machines User","count":123},{"language":"default","tag":"Partner","count":54},{"language":"default","tag":"User Additional API","count":33},{"language":"default","tag":"User Cards API","count":20},{"language":"default","tag":"User KYC API","count":13},{"language":"default","tag":"User Identity API","count":13},{"language":"default","tag":"Start","count":10},{"language":"default","tag":"User Deposits API","count":9},{"language":"default","tag":"Use Your Own AI","count":7},{"language":"default","tag":"Core Flows","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api/cards/update","slug":"/api/cards/update","pageMetadata":{"title":"Update card status, limits, or labels","description":null,"deprecated":null,"version":null,"openapi":"openapi.yaml patch /partner/v1/cards/{cardId}","href":"/api/cards/update","autogeneratedByOpenApi":true,"hidden":false},"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":"Update card status, limits, or labels","description":null,"deprecated":null,"version":null,"openapi":"openapi.yaml patch /partner/v1/cards/{cardId}","href":"/api/cards/update","autogeneratedByOpenApi":true,"hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"api.cards.update","tags":["cards"],"summary":"Update card status, limits, or labels","x-mint":{"href":"/api/cards/update"},"security":["5a99c133-c51b-4452-a7fe-f93135dcc2b1"],"parameters":["aa8a2fa1-1b93-4917-8bb2-32f3f919b75f"],"requestBody":"9e44886a-4c4e-4842-a8f9-187867595d2c","responses":{"200":"3e35a90c-57b2-4dc3-8592-559d8a77bf3f","400":"3f10cbc9-af1a-495a-a7f4-65fb166553e9","401":"2ecf28b2-bc69-445d-a1fc-dc76b1c86a8a","403":"d666da96-e094-4e96-b8a6-c8613aac31bb","404":"da557958-c2d9-4922-b593-d65af5c3cb1e"},"method":"patch","type":"path","servers":["7e567c44-cb1d-4ff6-9c91-0c15542f3eb9","80b7005e-1024-44ca-afca-f2a8760a73aa"],"path":"/partner/v1/cards/{cardId}","baseUrlOptions":["https://api.machines.cash","https://dev-api.machines.cash"],"title":"Update card status, limits, or labels","description":"","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.status":"locked"}]},"dependencies":{"parameters":{"aa8a2fa1-1b93-4917-8bb2-32f3f919b75f":{"name":"cardId","in":"path","required":true,"schema":{"type":"string","minLength":8,"isRequired":true,"description":"Machines card id.","uniqueKey":"","typeLabel":"string"},"description":"Machines card id."},"d2f9d08d-bfc5-41cb-965a-9b29e3f32022":{"name":"X-Open-Responses","in":"header","required":false,"schema":{"type":"string","enum":["1","true"],"isRequired":false,"description":"Return Open Responses-compatible output when set (replaces the default response envelope).","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Return Open Responses-compatible output when set (replaces the default response envelope)."},"ca69f19d-1058-4cf9-879b-50ae990d4e9c":{"name":"X-Open-Responses-Call-Id","in":"header","required":false,"schema":{"type":"string","minLength":1,"isRequired":false,"description":"Tool call id used for function_call_output items when Open Responses mode is enabled.","uniqueKey":"","typeLabel":"string"},"description":"Tool call id used for function_call_output items when Open Responses mode is enabled."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"status":{"type":"string","enum":["active","locked","canceled","not_activated"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"limit":{"type":"object","additionalProperties":false,"required":["amountCents","frequency"],"properties":{"amountCents":{"type":"integer","minimum":1,"description":"Limit amount in cents.","example":5000,"isRequired":true,"uniqueKey":"limit.amountCents","typeLabel":"integer"},"frequency":{"type":"string","enum":["perAuthorization","per24HourPeriod","per7DayPeriod","per30DayPeriod","perYearPeriod","allTime"],"isRequired":true,"uniqueKey":"limit.frequency","typeLabel":"enum\u003cstring>"}},"uniqueKey":"limit","typeLabel":"object"},"encryptedName":{"type":"object","description":"Optional encrypted card label. Generate with `POST /encryption/encrypt`.","required":["v","iv","ct"],"properties":{"v":{"type":"integer","minimum":1,"maximum":1000000,"description":"Schema version.","example":1,"isRequired":true,"uniqueKey":"encryptedName.v","typeLabel":"integer"},"iv":{"type":"string","description":"Base64url-encoded IV (12 bytes).","example":"Qz4f2m7Hk1P9x0ab","isRequired":true,"uniqueKey":"encryptedName.iv","typeLabel":"string"},"ct":{"type":"string","description":"Base64url-encoded ciphertext + auth tag.","example":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i","isRequired":true,"uniqueKey":"encryptedName.ct","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"encryptedName","typeLabel":"object"},"encryptedColor":{"type":"object","description":"Optional encrypted card color. Generate with `POST /encryption/encrypt`.","required":["v","iv","ct"],"properties":{"v":{"type":"integer","minimum":1,"maximum":1000000,"description":"Schema version.","example":1,"isRequired":true,"uniqueKey":"encryptedColor.v","typeLabel":"integer"},"iv":{"type":"string","description":"Base64url-encoded IV (12 bytes).","example":"Qz4f2m7Hk1P9x0ab","isRequired":true,"uniqueKey":"encryptedColor.iv","typeLabel":"string"},"ct":{"type":"string","description":"Base64url-encoded ciphertext + auth tag.","example":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i","isRequired":true,"uniqueKey":"encryptedColor.ct","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"encryptedColor","typeLabel":"object"},"encryptedEmoji":{"type":"object","description":"Optional encrypted card emoji. Generate with `POST /encryption/encrypt`.","required":["v","iv","ct"],"properties":{"v":{"type":"integer","minimum":1,"maximum":1000000,"description":"Schema version.","example":1,"isRequired":true,"uniqueKey":"encryptedEmoji.v","typeLabel":"integer"},"iv":{"type":"string","description":"Base64url-encoded IV (12 bytes).","example":"Qz4f2m7Hk1P9x0ab","isRequired":true,"uniqueKey":"encryptedEmoji.iv","typeLabel":"string"},"ct":{"type":"string","description":"Base64url-encoded ciphertext + auth tag.","example":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i","isRequired":true,"uniqueKey":"encryptedEmoji.ct","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"encryptedEmoji","typeLabel":"object"},"encryptedMemo":{"type":"object","description":"Optional encrypted card memo. Generate with `POST /encryption/encrypt`.","required":["v","iv","ct"],"properties":{"v":{"type":"integer","minimum":1,"maximum":1000000,"description":"Schema version.","example":1,"isRequired":true,"uniqueKey":"encryptedMemo.v","typeLabel":"integer"},"iv":{"type":"string","description":"Base64url-encoded IV (12 bytes).","example":"Qz4f2m7Hk1P9x0ab","isRequired":true,"uniqueKey":"encryptedMemo.iv","typeLabel":"string"},"ct":{"type":"string","description":"Base64url-encoded ciphertext + auth tag.","example":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i","isRequired":true,"uniqueKey":"encryptedMemo.ct","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"encryptedMemo","typeLabel":"object"},"folderId":{"oneOf":[{"type":"string","uniqueKey":"folderId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"folderId.oneOf.1","typeLabel":"null"}],"uniqueKey":"folderId","typeLabel":"string | null"},"isPinned":{"type":"boolean","uniqueKey":"isPinned","typeLabel":"boolean"},"sortOrder":{"type":"integer","uniqueKey":"sortOrder","typeLabel":"integer"}},"example":{"status":"locked"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"locked"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"3e35a90c-57b2-4dc3-8592-559d8a77bf3f":{"description":"Card updated","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ok","data","summary","errors"],"properties":{"ok":{"type":"boolean","const":true,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"data":{"type":"object","additionalProperties":false,"required":["cardId","status","last4","expirationMonth","expirationYear","encryptedName","isPinned","sortOrder","createdAt"],"properties":{"cardId":{"type":"string","isRequired":true,"uniqueKey":"data.cardId","typeLabel":"string"},"status":{"type":"string","enum":["active","locked","canceled","not_activated"],"isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"last4":{"type":"string","isRequired":true,"uniqueKey":"data.last4","typeLabel":"string"},"expirationMonth":{"type":"integer","isRequired":true,"uniqueKey":"data.expirationMonth","typeLabel":"integer"},"expirationYear":{"type":"integer","isRequired":true,"uniqueKey":"data.expirationYear","typeLabel":"integer"},"encryptedName":{"oneOf":[{"type":"object","description":"Encrypted payload generated by `POST /encryption/encrypt` (recommended). Canonical field order is `v`, `iv`, `ct` (order doesn’t matter in JSON). See `/encryption`.","required":["v","iv","ct"],"properties":{"v":{"type":"integer","minimum":1,"maximum":1000000,"description":"Schema version.","example":1,"isRequired":true,"uniqueKey":"data.encryptedName.oneOf.0.v","typeLabel":"integer"},"iv":{"type":"string","description":"Base64url-encoded IV (12 bytes).","example":"Qz4f2m7Hk1P9x0ab","isRequired":true,"uniqueKey":"data.encryptedName.oneOf.0.iv","typeLabel":"string"},"ct":{"type":"string","description":"Base64url-encoded ciphertext + auth tag.","example":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i","isRequired":true,"uniqueKey":"data.encryptedName.oneOf.0.ct","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"data.encryptedName.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"data.encryptedName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.encryptedName","typeLabel":"object | null"},"isPinned":{"type":"boolean","isRequired":true,"uniqueKey":"data.isPinned","typeLabel":"boolean"},"sortOrder":{"type":"integer","isRequired":true,"uniqueKey":"data.sortOrder","typeLabel":"integer"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"brand":{"type":"string","example":"VISA","uniqueKey":"data.brand","typeLabel":"string"},"limit":{"oneOf":[{"type":"object","required":["amountCents","frequency"],"properties":{"amountCents":{"type":"integer","minimum":1,"description":"Limit amount in cents.","example":5000,"isRequired":true,"uniqueKey":"data.limit.oneOf.0.amountCents","typeLabel":"integer"},"frequency":{"type":"string","enum":["perAuthorization","per24HourPeriod","per7DayPeriod","per30DayPeriod","perYearPeriod","allTime"],"isRequired":true,"uniqueKey":"data.limit.oneOf.0.frequency","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"data.limit.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.limit.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.limit","typeLabel":"object | null"},"encryptedColor":{"oneOf":[{"type":"object","description":"Encrypted payload generated by `POST /encryption/encrypt` (recommended). Canonical field order is `v`, `iv`, `ct` (order doesn’t matter in JSON). See `/encryption`.","required":["v","iv","ct"],"properties":{"v":{"type":"integer","minimum":1,"maximum":1000000,"description":"Schema version.","example":1,"isRequired":true,"uniqueKey":"data.encryptedColor.oneOf.0.v","typeLabel":"integer"},"iv":{"type":"string","description":"Base64url-encoded IV (12 bytes).","example":"Qz4f2m7Hk1P9x0ab","isRequired":true,"uniqueKey":"data.encryptedColor.oneOf.0.iv","typeLabel":"string"},"ct":{"type":"string","description":"Base64url-encoded ciphertext + auth tag.","example":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i","isRequired":true,"uniqueKey":"data.encryptedColor.oneOf.0.ct","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.encryptedColor.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.encryptedColor.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.encryptedColor","typeLabel":"object | null"},"encryptedEmoji":{"oneOf":[{"type":"object","description":"Encrypted payload generated by `POST /encryption/encrypt` (recommended). Canonical field order is `v`, `iv`, `ct` (order doesn’t matter in JSON). See `/encryption`.","required":["v","iv","ct"],"properties":{"v":{"type":"integer","minimum":1,"maximum":1000000,"description":"Schema version.","example":1,"isRequired":true,"uniqueKey":"data.encryptedEmoji.oneOf.0.v","typeLabel":"integer"},"iv":{"type":"string","description":"Base64url-encoded IV (12 bytes).","example":"Qz4f2m7Hk1P9x0ab","isRequired":true,"uniqueKey":"data.encryptedEmoji.oneOf.0.iv","typeLabel":"string"},"ct":{"type":"string","description":"Base64url-encoded ciphertext + auth tag.","example":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i","isRequired":true,"uniqueKey":"data.encryptedEmoji.oneOf.0.ct","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.encryptedEmoji.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.encryptedEmoji.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.encryptedEmoji","typeLabel":"object | null"},"encryptedMemo":{"oneOf":[{"type":"object","description":"Encrypted payload generated by `POST /encryption/encrypt` (recommended). Canonical field order is `v`, `iv`, `ct` (order doesn’t matter in JSON). See `/encryption`.","required":["v","iv","ct"],"properties":{"v":{"type":"integer","minimum":1,"maximum":1000000,"description":"Schema version.","example":1,"isRequired":true,"uniqueKey":"data.encryptedMemo.oneOf.0.v","typeLabel":"integer"},"iv":{"type":"string","description":"Base64url-encoded IV (12 bytes).","example":"Qz4f2m7Hk1P9x0ab","isRequired":true,"uniqueKey":"data.encryptedMemo.oneOf.0.iv","typeLabel":"string"},"ct":{"type":"string","description":"Base64url-encoded ciphertext + auth tag.","example":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i","isRequired":true,"uniqueKey":"data.encryptedMemo.oneOf.0.ct","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"data.encryptedMemo.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.encryptedMemo.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.encryptedMemo","typeLabel":"object | null"},"folderId":{"oneOf":[{"type":"string","uniqueKey":"data.folderId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.folderId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.folderId","typeLabel":"string | null"},"contractId":{"oneOf":[{"type":"string","uniqueKey":"data.contractId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.contractId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.contractId","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"summary":{"type":"string","isRequired":true,"uniqueKey":"summary","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","example":"invalid_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","example":"missing required field","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","description":"Optional field name that caused the error.","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"next":{"type":"object","additionalProperties":false,"properties":{"pollAfterMs":{"type":"integer","minimum":0,"uniqueKey":"next.pollAfterMs","typeLabel":"integer"},"suggestedTool":{"type":"string","uniqueKey":"next.suggestedTool","typeLabel":"string"},"suggestedArgs":{"type":"object","additionalProperties":true,"uniqueKey":"next.suggestedArgs","typeLabel":"object"}},"uniqueKey":"next","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"data":{"cardId":"\u003cstring>","status":"active","last4":"\u003cstring>","expirationMonth":123,"expirationYear":123,"encryptedName":{"v":1,"iv":"Qz4f2m7Hk1P9x0ab","ct":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i"},"isPinned":true,"sortOrder":123,"createdAt":"2023-11-07T05:31:56Z","brand":"VISA","limit":{"amountCents":5000,"frequency":"perAuthorization"},"encryptedColor":{"v":1,"iv":"Qz4f2m7Hk1P9x0ab","ct":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i"},"encryptedEmoji":{"v":1,"iv":"Qz4f2m7Hk1P9x0ab","ct":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i"},"encryptedMemo":{"v":1,"iv":"Qz4f2m7Hk1P9x0ab","ct":"Hdbb2yT2F4xWZL5m5bJX3eJb4n8wVhjPzqLw2h7i"},"folderId":"\u003cstring>","contractId":"\u003cstring>"},"summary":"\u003cstring>","errors":[{"code":"invalid_request","message":"missing required field","field":"\u003cstring>"}],"next":{"pollAfterMs":1,"suggestedTool":"\u003cstring>","suggestedArgs":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"3f10cbc9-af1a-495a-a7f4-65fb166553e9":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ok","summary","errors"],"properties":{"ok":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"summary":{"type":"string","example":"invalid request","isRequired":true,"uniqueKey":"summary","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","example":"invalid_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","example":"missing required field","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","description":"Optional field name that caused the error.","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"next":{"type":"object","additionalProperties":false,"properties":{"pollAfterMs":{"type":"integer","minimum":0,"uniqueKey":"next.pollAfterMs","typeLabel":"integer"},"suggestedTool":{"type":"string","uniqueKey":"next.suggestedTool","typeLabel":"string"},"suggestedArgs":{"type":"object","additionalProperties":true,"uniqueKey":"next.suggestedArgs","typeLabel":"object"}},"uniqueKey":"next","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"summary":"invalid request","errors":[{"code":"invalid_request","message":"missing required field","field":"\u003cstring>"}],"next":{"pollAfterMs":1,"suggestedTool":"\u003cstring>","suggestedArgs":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"2ecf28b2-bc69-445d-a1fc-dc76b1c86a8a":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ok","summary","errors"],"properties":{"ok":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"summary":{"type":"string","example":"invalid request","isRequired":true,"uniqueKey":"summary","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","example":"invalid_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","example":"missing required field","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","description":"Optional field name that caused the error.","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"next":{"type":"object","additionalProperties":false,"properties":{"pollAfterMs":{"type":"integer","minimum":0,"uniqueKey":"next.pollAfterMs","typeLabel":"integer"},"suggestedTool":{"type":"string","uniqueKey":"next.suggestedTool","typeLabel":"string"},"suggestedArgs":{"type":"object","additionalProperties":true,"uniqueKey":"next.suggestedArgs","typeLabel":"object"}},"uniqueKey":"next","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"summary":"invalid request","errors":[{"code":"invalid_request","message":"missing required field","field":"\u003cstring>"}],"next":{"pollAfterMs":1,"suggestedTool":"\u003cstring>","suggestedArgs":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"d666da96-e094-4e96-b8a6-c8613aac31bb":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ok","summary","errors"],"properties":{"ok":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"summary":{"type":"string","example":"invalid request","isRequired":true,"uniqueKey":"summary","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","example":"invalid_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","example":"missing required field","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","description":"Optional field name that caused the error.","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"next":{"type":"object","additionalProperties":false,"properties":{"pollAfterMs":{"type":"integer","minimum":0,"uniqueKey":"next.pollAfterMs","typeLabel":"integer"},"suggestedTool":{"type":"string","uniqueKey":"next.suggestedTool","typeLabel":"string"},"suggestedArgs":{"type":"object","additionalProperties":true,"uniqueKey":"next.suggestedArgs","typeLabel":"object"}},"uniqueKey":"next","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"summary":"invalid request","errors":[{"code":"invalid_request","message":"missing required field","field":"\u003cstring>"}],"next":{"pollAfterMs":1,"suggestedTool":"\u003cstring>","suggestedArgs":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"da557958-c2d9-4922-b593-d65af5c3cb1e":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ok","summary","errors"],"properties":{"ok":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"summary":{"type":"string","example":"invalid request","isRequired":true,"uniqueKey":"summary","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","example":"invalid_request","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","example":"missing required field","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","description":"Optional field name that caused the error.","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"next":{"type":"object","additionalProperties":false,"properties":{"pollAfterMs":{"type":"integer","minimum":0,"uniqueKey":"next.pollAfterMs","typeLabel":"integer"},"suggestedTool":{"type":"string","uniqueKey":"next.suggestedTool","typeLabel":"string"},"suggestedArgs":{"type":"object","additionalProperties":true,"uniqueKey":"next.suggestedArgs","typeLabel":"object"}},"uniqueKey":"next","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"summary":"invalid request","errors":[{"code":"invalid_request","message":"missing required field","field":"\u003cstring>"}],"next":{"pollAfterMs":1,"suggestedTool":"\u003cstring>","suggestedArgs":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5a99c133-c51b-4452-a7fe-f93135dcc2b1":{"Session":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}}},"servers":{"7e567c44-cb1d-4ff6-9c91-0c15542f3eb9":{"url":"https://api.machines.cash","description":"production"},"80b7005e-1024-44ca-afca-f2a8760a73aa":{"url":"https://dev-api.machines.cash","description":"sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"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":"Session","name":"Authorization"}],"title":"Session"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"machines-cash","siteName":"Machines Cash Docs","title":"Update card status, limits, or labels - Machines Cash Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-16T15:42:33.516Z","originalFileLocation":"api/cards/update.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=\"Machines Cash Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/machines-cash/TEo99zZciZyfKLJK/_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/machines-cash/TEo99zZciZyfKLJK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/machines-cash/TEo99zZciZyfKLJK/_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/machines-cash/TEo99zZciZyfKLJK/_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/machines-cash/TEo99zZciZyfKLJK/_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/machines-cash/TEo99zZciZyfKLJK/_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/machines-cash/TEo99zZciZyfKLJK/_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/machines-cash/TEo99zZciZyfKLJK/_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/machines-cash/TEo99zZciZyfKLJK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update card status, limits, or labels - Machines Cash Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Machines Cash Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.machines.cash/api/cards/update\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://machines-cash.mintlify.site/_mintlify/api/og/v2?division=Cards+API\u0026amp;title=Update+card+status%2C+limits%2C+or+labels\u0026amp;theme=c32948fa8a7d98240d30f730\u0026amp;signature=24eae70c91ebda462cc0329b977de2cba87e717097856d5df5717047aeb96b20\">\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=\"Update card status, limits, or labels - Machines Cash Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://machines-cash.mintlify.site/_mintlify/api/og/v2?division=Cards+API\u0026amp;title=Update+card+status%2C+limits%2C+or+labels\u0026amp;theme=c32948fa8a7d98240d30f730\u0026amp;signature=24eae70c91ebda462cc0329b977de2cba87e717097856d5df5717047aeb96b20\">\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/machines-cash/TEo99zZciZyfKLJK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Machines Cash Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF4500\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.machines.cash/api/cards/update\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/cards/update.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.machines.cash/#organization\",\"name\":\"Machines Cash Docs\",\"url\":\"https://docs.machines.cash\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/machines-cash/FBFZlb-Jki64gDKi/machines-wordmark.svg?fit=max\u0026auto=format\u0026n=FBFZlb-Jki64gDKi\u0026q=85\u0026s=b2fe18c446fad049723343a7a7bed80e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.machines.cash#website\",\"name\":\"Machines Cash Docs\",\"url\":\"https://docs.machines.cash\",\"publisher\":{\"@id\":\"https://docs.machines.cash/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.machines.cash/api/cards/update#webpage\",\"url\":\"https://docs.machines.cash/api/cards/update\",\"name\":\"Update card status, limits, or labels\",\"dateModified\":\"2026-03-16T15:42:33.516Z\",\"isPartOf\":{\"@id\":\"https://docs.machines.cash#website\"},\"breadcrumb\":{\"@id\":\"https://docs.machines.cash/api/cards/update#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.machines.cash/api/cards/update#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cards API\",\"item\":\"https://docs.machines.cash/api/cards/list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update card status, limits, or labels\",\"item\":\"https://docs.machines.cash/api/cards/update\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.machines.cash/api/cards/update#apireference\",\"headline\":\"Update card status, limits, or labels\",\"name\":\"Update card status, limits, or labels\",\"url\":\"https://docs.machines.cash/api/cards/update\",\"mainEntityOfPage\":{\"@id\":\"https://docs.machines.cash/api/cards/update#webpage\"},\"dateModified\":\"2026-03-16T15:42:33.516Z\",\"publisher\":{\"@id\":\"https://docs.machines.cash/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.machines.cash#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Machines Cash Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Machines Cash Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/cards/update.md","siteName":"Machines Cash Docs","nav":{"global":null,"tabs":[{"tab":"Machines User","pages":[{"title":"Machines User","href":"/user-changelog"}]},{"tab":"Partner","groups":[{"group":"Updates","pages":[{"title":"Changelog","href":"/partner-changelog"}]},{"group":"Start","pages":[{"title":"Partner","href":"/partner"},{"title":"Quickstart","href":"/getting-started"},{"title":"Authentication","href":"/authentication"},{"title":"Encryption","href":"/encryption"},{"title":"Sandbox Testing","href":"/sandbox-testing"}]},{"group":"Wallet Providers","pages":[{"title":"Privy","href":"/partners/privy"},{"title":"Crossmint","href":"/partners/crossmint"},{"title":"Openfort","href":"/partners/openfort"}]},{"group":"Core Flows","pages":[{"title":"KYC Flow","href":"/kyc-flow"},{"title":"Agreements","href":"/agreements"},{"title":"Cards","href":"/cards"},{"title":"Balances","href":"/balances"},{"title":"Deposits","href":"/deposits"},{"title":"Transactions","href":"/transactions"},{"title":"Withdrawals","href":"/withdrawals"}]},{"group":"Legal","pages":[{"title":"Terms","href":"/terms"}]},{"group":"Agentic","pages":[{"title":"Agentic Payments","href":"/agentic-payments"},{"title":"Agent Tool Schemas","href":"/agent-tool-schemas"},{"title":"Agent Best Practices","href":"/best-practices-agents"},{"title":"Partner LLM Context","href":"/partners/llms"}]},{"group":"Reference","pages":[{"title":"Examples","href":"/partners/examples"},{"title":"Supported Tokens and Chains","href":"/partners/supported-tokens-and-chains"},{"title":"Errors \u0026 Retries","href":"/errors"}]},{"group":"Authentication API","pages":[{"title":"Create a short-lived user session token","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/sessions","href":"/api/sessions"}]},{"group":"Users API","pages":[{"title":"Resolve or create a Machines user","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/users/resolve","href":"/api/users/resolve"}]},{"group":"KYC API","pages":[{"title":"Get KYC field requirements","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/kyc/schema","href":"/api/kyc/schema"},{"title":"Submit KYC application data","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/kyc/applications","href":"/api/kyc/applications"},{"title":"Get current KYC status","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/kyc/status","href":"/api/kyc/status"},{"title":"Get KYC field requirements and values","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/kyc/values","href":"/api/kyc/values"}]},{"group":"Agreements API","pages":[{"title":"Get user agreements","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/agreements","href":"/api/agreements/list"},{"title":"Accept user agreements","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/agreements","href":"/api/agreements/accept"}]},{"group":"Cards API","pages":[{"title":"List cards","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/cards","href":"/api/cards/list"},{"title":"Create a card","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/cards","href":"/api/cards/create"},{"title":"Get card by id","description":null,"deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/cards/{cardId}","href":"/api/cards/get"},{"title":"Update card status, limits, or labels","deprecated":null,"version":null,"openapi":"openapi.yaml patch /partner/v1/cards/{cardId}","href":"/api/cards/update"},{"title":"Delete a card","description":"Cancels the card immediately.","deprecated":null,"version":null,"openapi":"openapi.yaml delete /partner/v1/cards/{cardId}","href":"/api/cards/delete"},{"title":"Create a card secrets session","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/cards/secrets/session","href":"/api/cards/secrets/session"},{"title":"Retrieve encrypted card secrets","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/cards/{cardId}/secrets","href":"/api/cards/secrets"}]},{"group":"Encryption API","pages":[{"title":"Get the per-user data key","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/encryption/data-key","href":"/api/encryption/data-key"},{"title":"Encrypt plaintext with the data key","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/encryption/encrypt","href":"/api/encryption/encrypt"},{"title":"Decrypt ciphertext with the data key","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/encryption/decrypt","href":"/api/encryption/decrypt"}]},{"group":"Balances API","pages":[{"title":"Get balance details","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/balances","href":"/api/balances/get"}]},{"group":"Deposits API","pages":[{"title":"List deposit assets","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/deposits/assets","href":"/api/deposits/assets"},{"title":"Get min/max range for a deposit pair","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/deposits/range","href":"/api/deposits/range"},{"title":"Estimate deposit receive amount","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/deposits/estimate","href":"/api/deposits/estimate"},{"title":"Create a deposit address","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/deposits","href":"/api/deposits/create"},{"title":"List deposits","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/deposits","href":"/api/deposits/list"},{"title":"Get a deposit","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/deposits/{depositId}","href":"/api/deposits/get"}]},{"group":"Transactions API","pages":[{"title":"List transaction history","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/transactions","href":"/api/transactions/list"}]},{"group":"Withdrawals API","pages":[{"title":"List withdrawal destination assets","deprecated":null,"version":null,"openapi":"openapi.yaml get /partner/v1/withdrawals/assets","href":"/api/withdrawals/assets"},{"title":"Get min/max range for a withdrawal destination","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/withdrawals/range","href":"/api/withdrawals/range"},{"title":"Estimate withdrawal receive amount","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/withdrawals/estimate","href":"/api/withdrawals/estimate"},{"title":"Request a withdrawal signature payload","deprecated":null,"version":null,"openapi":"openapi.yaml post /partner/v1/withdrawals","href":"/api/withdrawals/create"}]},{"group":"Hidden","hidden":true,"pages":[{"title":"KYC Field Values","href":"/kyc-values"}]}]}]},"basePath":"","title":"Update card status, limits, or labels - Machines Cash Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}