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

# Save group layout

> Replace the complete group membership layout. Omitted contexts become ungrouped.

Requires `admin` scope. See [Context groups](https://docs.neuronsearchlab.com/console/context-groups.md) for rail priority and group-rule behaviour.


## OpenAPI

````yaml api-reference/platform-openapi.json PUT /api/context/groups/layout
openapi: 3.0.3
info:
  title: NeuronSearchLab Platform API
  version: 1.0.0
  description: >-
    Control-plane API for the NeuronSearchLab console: contexts, rules,
    pipelines, models, training, analytics, and workspace administration.
servers:
  - url: https://console.neuronsearchlab.com
security:
  - bearerAuth: []
tags:
  - name: Catalog
    description: Item search, item details, and metadata key listings.
  - name: Identity
    description: >-
      Identity resolution, consent, partner-scoped NSL IDs, and data
      collaborations.
  - name: Segments
    description: User segments.
  - name: Events
    description: Event types, training templates, and event value configuration.
  - name: Contexts
    description: Recommendation contexts and active model resolution.
  - name: Rules
    description: Ranking rules engine.
  - name: Pipelines
    description: Recommendation pipeline configuration.
  - name: Experiments
    description: A/B experiments.
  - name: Models
    description: Model versions.
  - name: Model Families
    description: Grouped model versions.
  - name: Serving Endpoints
    description: Model-serving endpoint configuration.
  - name: Training
    description: Training runs and jobs.
  - name: Dashboard
    description: Console dashboard metrics.
  - name: Analytics
    description: Recommendation, event, and catalog analytics.
  - name: Search
    description: Console-wide search.
  - name: Explainability
    description: Recommendation explanation.
  - name: Assistant
    description: Console and Studio assistants.
  - name: API Keys
    description: Platform API key management.
  - name: Team
    description: Team membership.
  - name: Billing
    description: billing portal and plan changes.
  - name: Integrations
    description: Third-party integrations.
  - name: Catalog Ingest
    description: Scheduled catalog feeds.
paths:
  /api/context/groups/layout:
    put:
      tags:
        - Contexts
      summary: Save group layout
      description: >-
        Replace the complete group membership layout. Omitted contexts become
        ungrouped. Requires an API key with admin scope.
      operationId: saveContextGroupLayout
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - groups
              properties:
                groups:
                  type: array
                  items:
                    type: object
                    required:
                      - id
                      - members
                    properties:
                      id:
                        type: integer
                        minimum: 1
                      members:
                        type: array
                        items:
                          type: object
                          required:
                            - context_id
                          properties:
                            context_id:
                              type: integer
                              minimum: 1
                            exempt:
                              type: boolean
                              default: false
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid input
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
components:
  responses:
    Error401:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error403:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error404:
      description: Not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Platform API key issued from Console > Platform API Keys. Format:
        nsl_<prefix>_<token>.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.