---
title: "Set Active Org"
method: PUT
path: "/v2/user/active-org"
tags: ["API Gateway"]
---

# Set Active Org

`PUT /v2/user/active-org`

Set the active organization for the current session

## Request body

- object
  - `orgSlug` string, required

## Response `200`

Success — returns updated org details

- UserOrgDetails
  - `org` object, nullable
    - `slug` string
    - `name` string
    - `status` string
    - `branding` object
    - `navigation` Navigation — Organization navigation configuration
      - `version` integer — Schema version number
      - `homePage` string — Route to use as home page (e.g., "/apps/agent-factory"). Must be a valid relative path starting with /. If not set, defaults to the platform default (SecureChat).
      - `menu` NavigationItem[] — Main menu items
        - `id` string, required — Unique identifier for this menu item
        - `type` 'category' | 'item' | 'divider', required
        - `label` string — Display label (not required for dividers)
        - `icon` string — Icon name (from lucide-react)
        - `color` string — Icon color (CSS color value)
        - `href` string — Link destination (for type=item)
        - `target` '_self' | '_blank' — Link target
        - `expanded` boolean — Whether category is expanded by default
        - `badge` string — Badge text to show (e.g., "New", "Beta")
        - `permissions` string[] — Permissions required to see this item
        - `features` NavigationFeature[] — Features attached to this item
          - `type` 'agent' | 'template', required
          - `slug` string, required — Unique identifier for this feature within the menu item
          - `label` string, required — Display label for the feature
          - `agentId` string — Agent ID (required when type=agent)
          - `templateId` string — Template ID (required when type=template)
          - `permissions` string[] — Permissions required to see this feature
        - `visibility` object — Visibility rules for subscription tiers/features
          - `tiers` string[]
          - `features` string[]
        - `items` object[] — Child items (for type=category)
      - `footer` NavigationItem[] — Footer menu items
        - `id` string, required — Unique identifier for this menu item
        - `type` 'category' | 'item' | 'divider', required
        - `label` string — Display label (not required for dividers)
        - `icon` string — Icon name (from lucide-react)
        - `color` string — Icon color (CSS color value)
        - `href` string — Link destination (for type=item)
        - `target` '_self' | '_blank' — Link target
        - `expanded` boolean — Whether category is expanded by default
        - `badge` string — Badge text to show (e.g., "New", "Beta")
        - `permissions` string[] — Permissions required to see this item
        - `features` NavigationFeature[] — Features attached to this item
          - `type` 'agent' | 'template', required
          - `slug` string, required — Unique identifier for this feature within the menu item
          - `label` string, required — Display label for the feature
          - `agentId` string — Agent ID (required when type=agent)
          - `templateId` string — Template ID (required when type=template)
          - `permissions` string[] — Permissions required to see this feature
        - `visibility` object — Visibility rules for subscription tiers/features
          - `tiers` string[]
          - `features` string[]
        - `items` object[] — Child items (for type=category)
      - `quickActions` NavigationItem[] — Quick action buttons
        - `id` string, required — Unique identifier for this menu item
        - `type` 'category' | 'item' | 'divider', required
        - `label` string — Display label (not required for dividers)
        - `icon` string — Icon name (from lucide-react)
        - `color` string — Icon color (CSS color value)
        - `href` string — Link destination (for type=item)
        - `target` '_self' | '_blank' — Link target
        - `expanded` boolean — Whether category is expanded by default
        - `badge` string — Badge text to show (e.g., "New", "Beta")
        - `permissions` string[] — Permissions required to see this item
        - `features` NavigationFeature[] — Features attached to this item
          - `type` 'agent' | 'template', required
          - `slug` string, required — Unique identifier for this feature within the menu item
          - `label` string, required — Display label for the feature
          - `agentId` string — Agent ID (required when type=agent)
          - `templateId` string — Template ID (required when type=template)
          - `permissions` string[] — Permissions required to see this feature
        - `visibility` object — Visibility rules for subscription tiers/features
          - `tiers` string[]
          - `features` string[]
        - `items` object[] — Child items (for type=category)
    - `role` object
      - `slug` string
      - `name` string
      - `permissions` string[]
      - `scopes` string[]
    - `groups` string[]
    - `settings` object
    - `subscription` OrgSubscription
      - `id` string
      - `slug` string, required
      - `name` string, required
      - `tier` string, required
      - `plan` string
      - `status` 'active' | 'inactive' | 'trialing' | 'past_due' | 'canceled', required
      - `isDefault` boolean
      - `limits` object
      - `features` object
      - `billing` object
      - `startedAt` string
      - `expiresAt` string
      - `createdBy` string
      - `updatedBy` string
      - `createdAt` string
      - `updatedAt` string
  - `permissions` string[]
  - `organizations` object[]
    - `slug` string
    - `name` string
    - `roleSlug` string
    - `groups` string[]

## Other responses

- `401` — Unauthenticated
- `403` — Forbidden

---

[API](https://skmtc.net/prisme/apis/prisme-ai-apis.md) · [All operations](https://skmtc.net/prisme/apis/prisme-ai-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prisme/prisme-ai-apis/versions/b702c3eef2f2/schema)