# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Kinde Management Organizations API
  version: 1.0.0
extends: openapi/kinde-organizations-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 40
- target: $.paths['/api/v1/organization/{org_code}/invites'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's invitations
      effect: read
      questions:
      - Which invitations are still pending for an organization?
      - Can I include revoked or already-accepted invites in the list?
      instructions:
      - text: List pending invitations for organization {org_code}.
        slots:
          org_code: path.org_code
      - text: Show all invites for organization {org_code}, including accepted ones.
        slots:
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organization/{org_code}/invites'].post
  update:
    x-apievangelist-phrasing:
      intent: Invite someone to an organization
      effect: write
      questions:
      - What's the way to invite a new person to join an organization with a role?
      - Can I create an invitation without sending the email?
      instructions:
      - text: Invite {email} to organization {org_code} with roles {roles}.
        slots:
          email: requestBody.email
          org_code: path.org_code
          roles: requestBody.roles
      - text: Send an invite to {first_name} {last_name} at {email} to join {org_code} as {roles}.
        slots:
          first_name: requestBody.first_name
          last_name: requestBody.last_name
          email: requestBody.email
          org_code: path.org_code
          roles: requestBody.roles
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organization/{org_code}/invites/{invite_code}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization invitation
      effect: read
      questions:
      - Can I check the status of one specific invitation?
      - Where do I see who an invite code was sent to?
      instructions:
      - text: Show invitation {invite_code} for organization {org_code}.
        slots:
          invite_code: path.invite_code
          org_code: path.org_code
      - text: Get the details of invite {invite_code} in {org_code}.
        slots:
          invite_code: path.invite_code
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organization/{org_code}/invites/{invite_code}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke an organization invitation
      effect: destructive
      questions:
      - How do I cancel an invitation before it's accepted?
      - Can I revoke an invite that was sent to the wrong address?
      instructions:
      - text: Revoke invitation {invite_code} in organization {org_code}.
        slots:
          invite_code: path.invite_code
          org_code: path.org_code
      - text: Cancel the pending invite {invite_code} for {org_code}.
        slots:
          invite_code: path.invite_code
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organization'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization
      effect: read
      questions:
      - Can I look up an organization's details by its code?
      - What settings are stored on a single organization?
      instructions:
      - text: Show organization {code}.
        slots:
          code: query.code
      - text: Get the details of organization {code}, expanding {expand}.
        slots:
          code: query.code
          expand: query.expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organization'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an organization
      effect: write
      questions:
      - How do I create a new organization for a customer tenant?
      - Can I create a billing customer at the same time as the organization?
      - Is it possible to set brand colors and a handle when creating an org?
      instructions:
      - text: Create an organization named {name}.
        slots:
          name: requestBody.name
      - text: Create organization {name} with external ID {external_id} and handle {handle}.
        slots:
          name: requestBody.name
          external_id: requestBody.external_id
          handle: requestBody.handle
      - text: Create organization {name} on billing plan {billing_plan_code} billed to {billing_email}.
        slots:
          name: requestBody.name
          billing_plan_code: requestBody.billing_plan_code
          billing_email: requestBody.billing_email
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List organizations
      effect: read
      questions:
      - Which organizations exist in my business?
      - Can I page through all my organizations sorted by name?
      instructions:
      - text: List all my organizations.
      - text: Show organizations sorted by {sort}, {page_size} per page.
        slots:
          sort: query.sort
          page_size: query.page_size
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organization/{org_code}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization
      effect: destructive
      questions:
      - Is it possible to delete an organization entirely?
      - Can I remove a tenant organization that's churned?
      instructions:
      - text: Delete organization {org_code}.
        slots:
          org_code: path.org_code
      - text: Permanently remove organization {org_code}.
        slots:
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organization/{org_code}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an organization's settings
      effect: write
      questions:
      - Can I suspend an organization or enforce MFA for its members?
      - Is there a way to let users with certain email domains auto-join an organization?
      - Can I rename an organization or change its brand colors?
      instructions:
      - text: Rename organization {org_code} to {name}.
        slots:
          org_code: path.org_code
          name: requestBody.name
      - text: Allow domains {allowed_domains} to auto-join organization {org_code}.
        slots:
          allowed_domains: requestBody.allowed_domains
          org_code: path.org_code
      - text: Suspend organization {org_code}.
        slots:
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's members
      effect: read
      questions:
      - Who are the members of an organization?
      - Can I list only the org members who have a particular role or permission?
      instructions:
      - text: List the users in organization {org_code}.
        slots:
          org_code: path.org_code
      - text: Show members of {org_code} with role {roles}.
        slots:
          org_code: path.org_code
          roles: query.roles
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users'].post
  update:
    x-apievangelist-phrasing:
      intent: Add existing users to an organization
      effect: write
      questions:
      - What's the way to add users who already exist to an organization?
      - Can I add several existing users to an org in one call?
      instructions:
      - text: Add users {users} to organization {org_code}.
        slots:
          users: requestBody.users
          org_code: path.org_code
      - text: Put these existing users into organization {org_code}.
        slots:
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update users in an organization
      effect: write
      questions:
      - Can I change roles or permissions for several members of an organization at once?
      - Is bulk-updating an organization's membership supported?
      instructions:
      - text: Update members {users} in organization {org_code}.
        slots:
          users: requestBody.users
          org_code: path.org_code
      - text: Bulk-change membership details for organization {org_code}.
        slots:
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List a member's roles in an organization
      effect: read
      questions:
      - Which roles does a user hold inside a particular organization?
      - Can I see one member's org-level roles?
      instructions:
      - text: List roles for user {user_id} in organization {org_code}.
        slots:
          user_id: path.user_id
          org_code: path.org_code
      - text: Show what roles {user_id} has in {org_code}.
        slots:
          user_id: path.user_id
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Give a member a role in an organization
      effect: write
      questions:
      - What's the way to assign a role to a user within an organization?
      - Can I make someone an admin of just one organization?
      instructions:
      - text: Give user {user_id} role {role_id} in organization {org_code}.
        slots:
          user_id: path.user_id
          role_id: requestBody.role_id
          org_code: path.org_code
      - text: Assign role {role_id} to member {user_id} of {org_code}.
        slots:
          role_id: requestBody.role_id
          user_id: path.user_id
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}/roles/{role_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a member's role in an organization
      effect: destructive
      questions:
      - How do I take a role away from a user in one organization?
      - Can I demote an org admin back to a regular member?
      instructions:
      - text: Remove role {role_id} from user {user_id} in organization {org_code}.
        slots:
          role_id: path.role_id
          user_id: path.user_id
          org_code: path.org_code
      - text: Revoke org role {role_id} for member {user_id} of {org_code}.
        slots:
          role_id: path.role_id
          user_id: path.user_id
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}/permissions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a member's permissions in an organization
      effect: read
      questions:
      - Which permissions does a user have within an organization?
      - Can I see where a member's org permissions come from, including roles?
      instructions:
      - text: List permissions for user {user_id} in organization {org_code}.
        slots:
          user_id: path.user_id
          org_code: path.org_code
      - text: Show {user_id}'s permissions in {org_code}, expanding {expand}.
        slots:
          user_id: path.user_id
          org_code: path.org_code
          expand: query.expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}/permissions'].post
  update:
    x-apievangelist-phrasing:
      intent: Grant a member a permission in an organization
      effect: write
      questions:
      - Is it possible to grant a single permission directly to an org member?
      - Can I give a user a permission in one organization without a role?
      instructions:
      - text: Grant permission {permission_id} to user {user_id} in organization {org_code}.
        slots:
          permission_id: requestBody.permission_id
          user_id: path.user_id
          org_code: path.org_code
      - text: Add permission {permission_id} for member {user_id} of {org_code}.
        slots:
          permission_id: requestBody.permission_id
          user_id: path.user_id
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}/permissions/{permission_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a member's permission in an organization
      effect: destructive
      questions:
      - How do I revoke a directly granted permission from an org member?
      - Can I remove one permission from a user in a specific organization?
      instructions:
      - text: Remove permission {permission_id} from user {user_id} in organization {org_code}.
        slots:
          permission_id: path.permission_id
          user_id: path.user_id
          org_code: path.org_code
      - text: Revoke member {user_id}'s permission {permission_id} in {org_code}.
        slots:
          user_id: path.user_id
          permission_id: path.permission_id
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user from an organization
      effect: destructive
      questions:
      - Is there a way to remove someone from an organization without deleting their account?
      - Can I kick a member out of one org?
      instructions:
      - text: Remove user {user_id} from organization {org_code}.
        slots:
          user_id: path.user_id
          org_code: path.org_code
      - text: Take {user_id} out of organization {org_code}.
        slots:
          user_id: path.user_id
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}/apis/{api_id}/scopes/{scope_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Grant an API scope to an org member
      effect: write
      questions:
      - Can I give one organization member access to a specific API scope?
      - How do I grant an API scope to a user only within an organization?
      instructions:
      - text: Grant scope {scope_id} of API {api_id} to user {user_id} in organization {org_code}.
        slots:
          scope_id: path.scope_id
          api_id: path.api_id
          user_id: path.user_id
          org_code: path.org_code
      - text: Add API {api_id} scope {scope_id} for member {user_id} of {org_code}.
        slots:
          api_id: path.api_id
          scope_id: path.scope_id
          user_id: path.user_id
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}/apis/{api_id}/scopes/{scope_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an API scope from an org member
      effect: destructive
      questions:
      - How do I take an API scope away from an organization member?
      - Can I revoke a member's API scope in just one org?
      instructions:
      - text: Remove scope {scope_id} of API {api_id} from user {user_id} in organization {org_code}.
        slots:
          scope_id: path.scope_id
          api_id: path.api_id
          user_id: path.user_id
          org_code: path.org_code
      - text: Revoke member {user_id}'s API {api_id} scope {scope_id} in {org_code}.
        slots:
          user_id: path.user_id
          api_id: path.api_id
          scope_id: path.scope_id
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}/mfa'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a member's organization MFA setup
      effect: read
      questions:
      - Which MFA factors has a user enrolled for an organization?
      - Can I check an org member's multi-factor configuration?
      instructions:
      - text: Show the org MFA configuration for user {user_id} in {org_code}.
        slots:
          user_id: path.user_id
          org_code: path.org_code
      - text: Get member {user_id}'s MFA factors for organization {org_code}.
        slots:
          user_id: path.user_id
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}/mfa'].delete
  update:
    x-apievangelist-phrasing:
      intent: Reset all of a member's org MFA factors
      effect: destructive
      questions:
      - How do I reset every organization MFA factor for a user who lost their device?
      - Can I clear all of a member's org-level MFA enrollments?
      instructions:
      - text: Reset all organization MFA for user {user_id} in {org_code}.
        slots:
          user_id: path.user_id
          org_code: path.org_code
      - text: Clear every org MFA factor for member {user_id} of {org_code}.
        slots:
          user_id: path.user_id
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/users/{user_id}/mfa/{factor_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Reset one of a member's org MFA factors
      effect: destructive
      questions:
      - Can I reset just one organization MFA factor for a user?
      - How do I remove a single org-level authenticator from a member?
      instructions:
      - text: Reset org MFA factor {factor_id} for user {user_id} in {org_code}.
        slots:
          factor_id: path.factor_id
          user_id: path.user_id
          org_code: path.org_code
      - text: Remove factor {factor_id} from member {user_id}'s MFA in organization {org_code}.
        slots:
          factor_id: path.factor_id
          user_id: path.user_id
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/feature_flags'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's feature flags
      effect: read
      questions:
      - Which feature flag values apply to a particular organization?
      - Can I see an org's flag overrides?
      instructions:
      - text: List feature flags for organization {org_code}.
        slots:
          org_code: path.org_code
      - text: Show flag values in effect for {org_code}.
        slots:
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/feature_flags'].delete
  update:
    x-apievangelist-phrasing:
      intent: Clear all of an org's flag overrides
      effect: destructive
      questions:
      - How do I reset all feature flag overrides for an organization?
      - Can I revert every flag for one org back to defaults?
      instructions:
      - text: Delete all feature flag overrides for organization {org_code}.
        slots:
          org_code: path.org_code
      - text: Reset every flag override on {org_code}.
        slots:
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/feature_flags/{feature_flag_key}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Clear one org feature flag override
      effect: destructive
      questions:
      - Can I remove a single feature flag override for an organization?
      - How do I revert one flag to default for one org?
      instructions:
      - text: Remove the override of flag {feature_flag_key} for organization {org_code}.
        slots:
          feature_flag_key: path.feature_flag_key
          org_code: path.org_code
      - text: Revert flag {feature_flag_key} to its default in {org_code}.
        slots:
          feature_flag_key: path.feature_flag_key
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/feature_flags/{feature_flag_key}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Override a feature flag for an organization
      effect: write
      questions:
      - What's the way to turn a feature on for just one organization?
      - Can I override a flag's value for a single org?
      instructions:
      - text: Set flag {feature_flag_key} to {value} for organization {org_code}.
        slots:
          feature_flag_key: path.feature_flag_key
          value: query.value
          org_code: path.org_code
      - text: Override feature {feature_flag_key} with {value} in {org_code}.
        slots:
          feature_flag_key: path.feature_flag_key
          value: query.value
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/properties/{property_key}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set one organization property
      effect: write
      questions:
      - How do I set a single custom property value on an organization?
      - Can I update one org property by its key?
      instructions:
      - text: Set property {property_key} on organization {org_code} to {value}.
        slots:
          property_key: path.property_key
          org_code: path.org_code
          value: query.value
      - text: Update {org_code}'s {property_key} property to {value}.
        slots:
          org_code: path.org_code
          property_key: path.property_key
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/properties'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization's property values
      effect: read
      questions:
      - What custom property values are stored on an organization?
      - Can I read all properties for one org?
      instructions:
      - text: Show property values for organization {org_code}.
        slots:
          org_code: path.org_code
      - text: List custom properties set on {org_code}.
        slots:
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/properties'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set several organization properties
      effect: write
      questions:
      - Can I update multiple custom properties on an organization at once?
      - Is bulk-setting org property values supported?
      instructions:
      - text: Update properties {properties} on organization {org_code}.
        slots:
          properties: requestBody.properties
          org_code: path.org_code
      - text: Set several property values on {org_code} in one go.
        slots:
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/mfa'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an organization's MFA policy
      effect: write
      questions:
      - How do I choose which MFA factors members of an organization can use?
      - Can I enable recovery codes for one org's MFA?
      instructions:
      - text: Set organization {org_code} MFA factors to {enabled_factors}.
        slots:
          org_code: path.org_code
          enabled_factors: requestBody.enabled_factors
      - text: Replace {org_code}'s MFA config with factors {enabled_factors} and recovery codes {is_recovery_codes_enabled}.
        slots:
          org_code: path.org_code
          enabled_factors: requestBody.enabled_factors
          is_recovery_codes_enabled: requestBody.is_recovery_codes_enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organization/{org_code}/handle'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization's handle
      effect: destructive
      questions:
      - Is it possible to remove the handle from an organization?
      - Can I free up an org handle for reuse?
      instructions:
      - text: Delete the handle of organization {org_code}.
        slots:
          org_code: path.org_code
      - text: Remove the handle assigned to {org_code}.
        slots:
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/logos'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization's logos
      effect: read
      questions:
      - Which logos are uploaded for an organization?
      - Can I check an org's light and dark logos?
      instructions:
      - text: Show logo details for organization {org_code}.
        slots:
          org_code: path.org_code
      - text: List the logos uploaded for {org_code}.
        slots:
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/logos/{type}'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload an organization logo
      effect: write
      questions:
      - What's the way to upload a logo for one organization's sign-in pages?
      - Can I give an org its own dark-mode logo?
      instructions:
      - text: Upload {logo} as the {type} logo for organization {org_code}.
        slots:
          logo: requestBody.logo
          type: path.type
          org_code: path.org_code
      - text: Set {org_code}'s {type} logo.
        slots:
          org_code: path.org_code
          type: path.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/logos/{type}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization logo
      effect: destructive
      questions:
      - How do I remove an organization's logo?
      - Can I delete only an org's dark logo?
      instructions:
      - text: Delete the {type} logo for organization {org_code}.
        slots:
          type: path.type
          org_code: path.org_code
      - text: Remove {org_code}'s {type} logo.
        slots:
          org_code: path.org_code
          type: path.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{organization_code}/connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's auth connections
      effect: read
      questions:
      - Which sign-in connections are enabled for an organization?
      - Can I see the enterprise connections one org uses?
      instructions:
      - text: List the auth connections for organization {organization_code}.
        slots:
          organization_code: path.organization_code
      - text: Show connections enabled on org {organization_code}.
        slots:
          organization_code: path.organization_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{organization_code}/connections/{connection_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable a connection for an organization
      effect: write
      questions:
      - Is there a way to turn on an auth connection for a single organization?
      - Can I give one org its own SSO connection?
      instructions:
      - text: Enable connection {connection_id} for organization {organization_code}.
        slots:
          connection_id: path.connection_id
          organization_code: path.organization_code
      - text: Turn on auth connection {connection_id} in org {organization_code}.
        slots:
          connection_id: path.connection_id
          organization_code: path.organization_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{organization_code}/connections/{connection_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Turn off a connection for an organization
      effect: destructive
      questions:
      - How do I disable an auth connection for one organization?
      - Can I stop an org from using a particular sign-in method?
      instructions:
      - text: Disable connection {connection_id} for organization {organization_code}.
        slots:
          connection_id: path.connection_id
          organization_code: path.organization_code
      - text: Remove auth connection {connection_id} from org {organization_code}.
        slots:
          connection_id: path.connection_id
          organization_code: path.organization_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/organizations/{org_code}/sessions'].patch
  update:
    x-apievangelist-phrasing:
      intent: Configure an organization's session policy
      effect: write
      questions:
      - Can an organization have its own authenticated session lifetime?
      - Which setting makes an org use its own SSO session persistence mode?
      instructions:
      - text: Set organization {org_code}'s session lifetime to {authenticated_session_lifetime} seconds.
        slots:
          org_code: path.org_code
          authenticated_session_lifetime: requestBody.authenticated_session_lifetime
      - text: Use SSO session persistence mode {sso_session_persistence_mode} for {org_code}.
        slots:
          sso_session_persistence_mode: requestBody.sso_session_persistence_mode
          org_code: path.org_code
      method: generated
      generated: '2026-09-26'