Skip to main content
PUT
/
v0
/
organisation
/
{org_id}
/
environments
/
{env_id}
/
features
/
{feature}
Enable or update a feature for an environment
curl --request PUT \
  --url https://sis.sumvin.com/v0/organisation/{org_id}/environments/{env_id}/features/{feature} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "enabled": true,
  "config": {
    "mode": "websdk"
  }
}
'
{
  "_links": {
    "self": {
      "href": "<string>",
      "method": "GET",
      "templated": false,
      "description": "<string>"
    },
    "environment": {
      "href": "<string>",
      "method": "GET",
      "templated": false,
      "description": "<string>"
    }
  },
  "feature": {
    "enabled": true,
    "config": {},
    "created_at": 123,
    "updated_at": 123
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
org_id
string
required
​
env_id
string
required
​
feature
enum<string>
required

Feature flags an SIS organisation can enable for its users.

Flags drive cohort selection during onboarding and runtime behaviour across the API surface:

  • AI_AGENT: Sumvin's signing service deploys the Safe and attaches an agent signer. Default cohort. Mutually exclusive with USER_SIGNED_DEPLOY.
  • USER_SIGNED_DEPLOY: The user's primary EOA signs the Safe deployment UserOp via Sumvin's prepare/submit endpoints; Sumvin sponsors gas via Pimlico. Recommended for partners who want user-controlled wallets without agent custody. Mutually exclusive with AI_AGENT.
  • CRYPTO_WALLET_CARD: Issue a crypto-funded card backed by the user's wallet.
  • VIRTUAL_IBAN: Provision a virtual IBAN for the user.
  • GASLESS_WALLET_RAILS: Sumvin sponsors gas for user transactions.
  • AI_ADVISOR: Enable the AI advisor / insights surface for the user.
  • KYC: Pin the KYC sub-flow render mode (websdk, hybrid, or document_only) for this organisation/environment via config.mode. When the feature row is absent, disabled, or config is omitted, the global feature-flag default applies. The resolved mode is surfaced on the onboarding kyc_verification step as meta.kyc_mode (see KYCMode).
  • ONRAMP: Offer fiat-to-crypto onramp (Meld /ramp) to the organisation's users. Advertises the capability in the environment's feature listing; access to the /v0/ramp/* endpoints is governed by PINT token scope, not this flag.
Available options:
ai_agent,
user_signed_deploy,
crypto_wallet_card,
virtual_iban,
gasless_wallet_rails,
ai_advisor,
kyc,
onramp

Body

application/json
​
enabled
boolean
default:true
​
config
Config · object

Feature-specific configuration. Shape depends on the feature slug. For kyc, set mode to one of websdk, hybrid, or document_only to override the default KYC sub-flow for this environment.

Example:
{ "mode": "websdk" }

Response

Successful Response

​
_links
EnvChildLinks · object
required
​
feature
FeatureData · object
required