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

# Activate

> Write a setup's values into the scene.



## OpenAPI

````yaml /scene-manager-3/api-reference/openapi.json post /setups/{id}/activate
openapi: 3.1.0
info:
  title: Scene Manager
  version: 3.0.0
  description: >-
    Scene Manager's local API, on the computer it runs on. Every call needs a
    Scene Manager licence on this computer.
servers:
  - url: http://127.0.0.1:45710/api/v1
    description: Scene Manager on this computer
security: []
tags:
  - name: Service
    description: Whether Scene Manager is running and connected to an app.
  - name: Setups
    description: 'Saved states of the scene: list, make, change, activate.'
  - name: Folders
    description: Folders of setups. A folder's values pass down to its setups.
  - name: Modules
    description: The parts of a setup (Camera, Output, Lights…) and the properties in them.
  - name: Rendering
    description: Batch render setups, follow the progress, stop.
  - name: Variations
    description: Sets of options rendered in every combination.
  - name: Comments
    description: Comments pinned on shots of the scene, for people and agents.
  - name: Shots
    description: Viewport and frame buffer captures that comments are pinned on.
  - name: Scene
    description: >-
      The open scene itself: its objects, materials, properties, selection and
      scripts.
  - name: Document
    description: Scene Manager's whole document in the open scene, and 2.x import.
  - name: Settings
    description: This person's settings on this computer.
  - name: HDRI library
    description: The HDRI maps in the library folders and in the scene.
paths:
  /setups/{id}/activate:
    post:
      tags:
        - Setups
      summary: Activate
      description: Write a setup's values into the scene.
      operationId: activateSetup
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                modules:
                  type: array
                  items:
                    type: string
                  description: >-
                    Only these modules' values (an edit in the active setup): no
                    Switching extras, no scripts
                keys:
                  type: array
                  items:
                    type: string
                  description: >-
                    Only these properties' values (an edit of one value):
                    nothing else of their module is written again
                wait:
                  type: boolean
                  description: >-
                    Answer when the view has drawn too, every step final (else
                    the camera's step may still be running)
      responses:
        '200':
          description: Applied; every skipped change is listed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Activation'
        '404':
          description: No such setup
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: No DCC or CAD app is connected
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Activation:
      type: object
      properties:
        setup:
          type: string
        results:
          type: array
          items:
            type: object
            properties:
              target:
                type: string
              applied:
                type: array
                items:
                  type: string
              skipped:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    reason:
                      type: string
                  required:
                    - name
                    - reason
            required:
              - target
              - applied
              - skipped
        unset:
          type: array
          items:
            type: string
        unknownTokens:
          type: array
          items:
            type: string
        refused:
          type: array
          items:
            type: object
            properties:
              key:
                type: string
              reason:
                type: string
            required:
              - key
              - reason
          description: >-
            Values not sent because the app would refuse them (an output path
            the file system does not allow), with why
        steps:
          type: array
          items:
            $ref: '#/components/schemas/ActivationStep'
        ms:
          type: number
      required:
        - setup
        - results
        - unset
        - unknownTokens
        - refused
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
    ActivationStep:
      type: object
      properties:
        id:
          type: string
        label:
          type: string
        state:
          type: string
          enum:
            - queued
            - running
            - done
            - skipped
            - failed
        ms:
          type: number
        error:
          type: string
      required:
        - id
        - label
        - state

````

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