> ## Documentation Index
> Fetch the complete documentation index at: https://nevermined.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update organization details

> Updates mutable metadata on the caller organization (name, description, url, active flag, crypto/fiat fees). The organization is resolved from the authenticated context. Only fields present in the body are changed. Requires a Nevermined API key. Requires organization admin privileges.



## OpenAPI

````yaml /api-reference/organizations-openapi.json put /organizations
openapi: 3.0.0
info:
  title: Nevermined Organizations API
  description: >-
    Manage a Nevermined organization programmatically — members, tiers, groups &
    budgets, treasury wallets, customers, webhooks, analytics, and
    agent-discovery surfaces.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.sandbox.nevermined.app/api/v1
    description: Sandbox
  - url: https://api.live.nevermined.app/api/v1
    description: Live
security: []
tags:
  - name: Organizations
    x-group: General
    description: Organization settings, members & roles, and workspace context.
  - name: Organizations - Billing
    x-group: Billing
    description: Tiers, subscriptions, invoices, checkout, and the public tier catalog.
  - name: Groups
    x-group: Groups & Budgets
    description: Organization groups, per-group budgets, and shared payment methods.
  - name: Organizations - Wallets
    x-group: Wallets
    description: Custodial stablecoin treasury wallets.
  - name: Organizations - Customers
    x-group: Customers
    description: The white-label customer CRM (Enterprise).
  - name: Organizations - Analytics
    x-group: Analytics
    description: Revenue, MRR, usage, conversion, and per-member metrics.
  - name: Organizations - Webhooks
    x-group: Webhooks
    description: Outbound webhook subscriptions and deliveries.
  - name: Organizations - Activity
    x-group: Activity
    description: The organization activity feed.
  - name: Organizations - Realtime
    x-group: Realtime
    description: Realtime WebSocket secret management (Enterprise).
  - name: Invitations
    x-group: Invitations
    description: Invite people to an organization.
  - name: Organizations - Integration
    x-group: Agent Discovery
    description: >-
      Public agent-discovery surfaces (llms.txt, agentic-instructions.md,
      ai-catalog.json).
paths:
  /organizations:
    put:
      tags:
        - Organizations
      summary: Update organization details
      description: >-
        Updates mutable metadata on the caller organization (name, description,
        url, active flag, crypto/fiat fees). The organization is resolved from
        the authenticated context. Only fields present in the body are changed.
        Requires a Nevermined API key. Requires organization admin privileges.
      operationId: OrganizationsController_updateOrganization
      parameters: []
      requestBody:
        required: true
        description: Organization properties that should be updated
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateOrganizationDto'
      responses:
        '200':
          description: Organization updated successfully
        '403':
          description: Caller is not an active admin of the organization.
        '404':
          description: Organization not found
      security:
        - Authorization: []
components:
  schemas:
    UpdateOrganizationDto:
      type: object
      properties:
        slug:
          type: string
          description: >-
            Unique DNS-safe label for the org subdomain
            (`<slug>.api.nevermined.app`). Lowercase letters, digits and
            hyphens; no leading or trailing hyphen.
          example: acme-labs
        name:
          type: string
          description: Display name of the organization
          example: Nevermined Labs
        description:
          type: string
          description: Short description that will be shown publicly
          example: AI infrastructure for knowledge agents.
        url:
          type: string
          description: Organization public URL
          example: https://nevermined.app
        isActive:
          type: boolean
          description: >-
            Whether the organization is active. If set to false, all members
            will also be deactivated.
          example: true
        cryptoFees:
          type: string
          description: >-
            Fee percentage for crypto payments, multiplied by 10000 (e.g., 1500
            = 15%)
          example: '1500'
        fiatFees:
          type: string
          description: >-
            Fee percentage for fiat payments, multiplied by 10000 (e.g., 1500 =
            15%)
          example: '1500'
  securitySchemes:
    Authorization:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

## Related topics

- [Update a webhook subscription](/docs/api-reference/organizations--webhooks/update-a-webhook-subscription.md)
- [Organizations](/docs/solutions/organizations/overview.md)
- [Update a budget's limit / interval / alert threshold](/docs/api-reference/groups/update-a-budgets-limit-interval-alert-threshold.md)
- [Update Payment Method](/docs/api-reference/payment-methods/update-payment-method.md)
- [Update Plan](/docs/api-reference/protocol/update-plan.md)