{"templateId":"markdown","versions":[{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/governance/intents","default":true,"active":true,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/governance/intents","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/governance/intents","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/governance/intents","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/governance/intents","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/governance/intents","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Intents and approvals","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"intents-and-approvals","__idx":0},"children":["Intents and approvals"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Executive summary"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["An intent is a governed proposal to change the system. Every governed modification must go through the intent workflow before execution."]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Intents are immutable after submission."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User-signed intents are signed by the proposer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API-only system-signed intents are submitted without a client-side signature, then signed by the platform before policy evaluation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Policies determine which additional approvals are required."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authorized checkers can approve or reject."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Completed intents create an auditable record of governance decisions."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Why this matters"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Intents are the enforcement mechanism for governance. Transfers, policy changes, user changes, domain changes, and many administrative updates flow through this model. This gives operators and auditors a complete record of who proposed a change, which policy governed it, who approved or rejected it, and whether it executed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-an-intent","__idx":1},"children":["What is an intent?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An intent represents a proposed change that:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Is signed by the proposer, or is system-signed after API authentication."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Has an operation-specific payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Targets a domain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Expires if not approved in time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Executes only after the selected policy workflow is satisfied."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most workflows use user-signed intents. The proposer authenticates, signs the request body with their registered private key, and the signature is verified before policy evaluation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["System-signed intents are available only through the API. A service caller authenticates with a bearer token and submits a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SystemSigned"]}," request body without an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["author"]}," field or top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signature"]},". The platform signs the proposal internally, then policies with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["intentOrigin: \"SystemSigned\""]}," decide whether the proposal is allowed. Even when system-signed intent configuration is enabled by default at deployment level, proposals remain disabled until the Gateway public signing key is registered in Notary and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOTARY_SYSTEM_SIGNED_INTENTS_ENABLED"]}," is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enabled: true"]},". For request details, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/governance/intents/intent-request-structure#system-signed-proposal-request-body"},"children":["Intent request structure"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"intent-lifecycle","__idx":2},"children":["Intent lifecycle"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"stateDiagram-v2\n [*] --> Proposed: Submit intent\n Proposed --> PendingApproval: Policy workflow applies\n PendingApproval --> Approved: Required approvals received\n PendingApproval --> Rejected: Approver rejects\n PendingApproval --> Expired: Expiry time passes\n Approved --> Executed: System applies change\n Executed --> [*]\n Rejected --> [*]\n Expired --> [*]\n","diagramHtml":"

Submit intent

Policy workflow applies

Required approvals received

Approver rejects

Expiry time passes

System applies change

Proposed

PendingApproval

Approved

Rejected

Expired

Executed

","diagramHtmlDark":"

Submit intent

Policy workflow applies

Required approvals received

Approver rejects

Expiry time passes

System applies change

Proposed

PendingApproval

Approved

Rejected

Expired

Executed

"},"children":["stateDiagram-v2\n [*] --> Proposed: Submit intent\n Proposed --> PendingApproval: Policy workflow applies\n PendingApproval --> Approved: Required approvals received\n PendingApproval --> Rejected: Approver rejects\n PendingApproval --> Expired: Expiry time passes\n Approved --> Executed: System applies change\n Executed --> [*]\n Rejected --> [*]\n Expired --> [*]\n"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"State"},"children":["State"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Proposed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Intent has been accepted for policy evaluation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pending approval"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Intent is waiting for additional approvals."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Approved"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required approvals have been collected."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Executed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The change has been applied."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rejected"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An approver rejected the intent."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Expired"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The approval window passed before completion."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"maker-checker-model","__idx":3},"children":["Maker-checker model"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Actor"},"children":["Actor"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Responsibility"},"children":["Responsibility"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User maker"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Creates and signs a user-signed intent. The maker's signature counts as the first approval."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Service submitter"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submits a system-signed proposal with the API. The service submitter is recorded by subject, not by user ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Checker"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reviews, approves, or rejects according to the policy workflow. Approvals and rejections remain user-signed."]}]}]}]}]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"sequenceDiagram\n participant Op as Operator\n participant Sup as Supervisor\n participant Comp as Compliance\n participant Sys as System\n\n Op->>Sys: Propose transfer intent\n Sup->>Sys: Approve\n Comp->>Sys: Approve\n Sys->>Sys: Execute intent\n","diagramHtml":"SystemComplianceSupervisorOperatorSystemComplianceSupervisorOperatorPropose transfer intentApproveApproveExecute intent","diagramHtmlDark":"SystemComplianceSupervisorOperatorSystemComplianceSupervisorOperatorPropose transfer intentApproveApproveExecute intent"},"children":["sequenceDiagram\n participant Op as Operator\n participant Sup as Supervisor\n participant Comp as Compliance\n participant Sys as System\n\n Op->>Sys: Propose transfer intent\n Sup->>Sys: Approve\n Comp->>Sys: Approve\n Sys->>Sys: Execute intent\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For user-signed intents, the maker must have a role that satisfies the first policy workflow step. The maker cannot provide another approval for the same workflow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For system-signed intents, the service submitter can propose only intent types admitted by a matching ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SystemSigned"]}," policy. If the selected policy has an approval workflow, user-signed approvers complete that workflow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"intent-types","__idx":4},"children":["Intent types"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Category"},"children":["Category"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example intent types"},"children":["Example intent types"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domain management"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateDomain"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_UpdateDomain"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_LockDomain"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_UnlockDomain"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User management"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateUser"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_UpdateUser"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_LockUser"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_UnlockUser"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Policy management"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreatePolicy"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_UpdatePolicy"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_LockPolicy"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_UnlockPolicy"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account and vault management"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateAccount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_UpdateAccount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateVault"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_UpdateVault"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Endpoint management"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateEndpoint"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_UpdateEndpoint"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transactions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateTransactionOrder"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_CreateTransferOrder"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Compliance"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v0_ReleaseQuarantinedTransfers"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For complete payload structure, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/governance/intents/reference"},"children":["Intent reference"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/governance/intents/intent-request-structure"},"children":["Intent request structure"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"intent-expiry-and-targeting","__idx":5},"children":["Intent expiry and targeting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every intent has an expiry time. If the required approvals are not received before expiry, the intent does not execute and must be recreated if still needed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An intent targets a domain. Users can target their own domain and, where governance allows, descendant domains. Users cannot target parent or sibling domains directly."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"dry-runs","__idx":6},"children":["Dry runs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dry runs validate a payload before live submission. Use dry runs for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Policy changes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Domain changes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User and user role-assignment changes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["High-risk transactions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Any payload where condition or workflow behavior is uncertain."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For operations, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/governance/intents/manage-intents-and-approvals"},"children":["Manage intents and approvals"]},"."]}]},"headings":[{"value":"Intents and approvals","id":"intents-and-approvals","depth":1},{"value":"What is an intent?","id":"what-is-an-intent","depth":2},{"value":"Intent lifecycle","id":"intent-lifecycle","depth":2},{"value":"Maker-checker model","id":"maker-checker-model","depth":2},{"value":"Intent types","id":"intent-types","depth":2},{"value":"Intent expiry and targeting","id":"intent-expiry-and-targeting","depth":2},{"value":"Dry runs","id":"dry-runs","depth":2}],"frontmatter":{"seo":{"title":"Intents and approvals"}},"lastModified":"2026-08-04T20:25:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/governance/intents","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}