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

# Add Machine Group

> Adds a new machine group for a specific actor, identified by `ActorID`.



## OpenAPI

````yaml /openapi/lynx.yaml post /v1/actor/{ActorID}/machineGroups
openapi: 3.0.1
info:
  title: Nayax Operational Lynx API
  version: v1
servers:
  - url: https://qa-lynx.nayax.com/operational
security:
  - Authorization: []
paths:
  /v1/actor/{ActorID}/machineGroups:
    post:
      tags:
        - Actors
      summary: Add Machine Group
      description: Adds a new machine group for a specific actor, identified by `ActorID`.
      operationId: add-machine-group
      parameters:
        - name: ActorID
          in: path
          required: true
          description: >-
            The unique identifier of the actor for whom the machine group is
            being added.
          schema:
            type: integer
            format: int64
      requestBody:
        required: true
        description: The details of the machine group to be added.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MachineGroupRequestDTO'
      responses:
        '200':
          description: The machine group was added successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MachineGroupResponseDTO'
components:
  schemas:
    MachineGroupRequestDTO:
      type: object
      description: >-
        Represents the data required to create or update a machine group
        associated with an actor.
      properties:
        MachineGroupId:
          type: integer
          format: int32
          nullable: true
          description: >-
            The unique identifier of the machine group. This is typically
            provided when updating an existing machine group.
        MachineGroupName:
          type: string
          nullable: true
          description: The name of the machine group.
        MachineGroupCode:
          type: integer
          format: int64
          nullable: true
          description: >-
            A code assigned to the machine group for identification or
            categorization.
        MachineGroupStatus:
          $ref: '#/components/schemas/ActiveInactiveEnum'
          type: integer
          format: int32
          description: >-
            The status identifier of the machine group, indicating its current
            state.
        LanguageId:
          $ref: '#/components/schemas/LanguageIdEnum'
          type: integer
          format: int32
          nullable: true
          description: The virtual machine's language in the "General" tab.
      additionalProperties: false
    MachineGroupResponseDTO:
      type: object
      description: >-
        Represents the details of a machine group associated with an actor,
        including identification, status, and audit information.
      properties:
        MachineGroupId:
          type: integer
          format: int32
          nullable: true
          description: The unique identifier of the machine group.
        ActorId:
          type: integer
          format: int64
          nullable: true
          description: >-
            The unique identifier of the actor associated with this machine
            group.
        MachineGroupName:
          type: string
          nullable: true
          description: The name of the machine group.
        MachineGroupCode:
          type: integer
          format: int64
          nullable: true
          description: >-
            A code assigned to the machine group for identification or
            categorization.
        MachineGroupStatus:
          type: integer
          format: int32
          description: >-
            The status identifier of the machine group, indicating its current
            state.
        CreatedBy:
          type: integer
          format: int64
          nullable: true
          description: The unique identifier of the user who created this machine group.
        CreatedOn:
          type: string
          format: date-time
          nullable: true
          description: The date and time when the machine group was created.
        UpdatedOn:
          type: string
          format: date-time
          nullable: true
          description: The date and time when the machine group was last updated.
        UpdatedBy:
          type: integer
          format: int64
          nullable: true
          description: >-
            The unique identifier of the user who last updated this machine
            group.
      additionalProperties: false
    ActiveInactiveEnum:
      enum:
        - 1
        - 2
      x-enumDescriptions:
        '1': Active
        '2': Inactive
    LanguageIdEnum:
      enum:
        - 2
        - 4
        - 7
        - 8
        - 9
        - 10
        - 11
        - 12
        - 13
        - 14
        - 15
        - 16
        - 17
        - 18
        - 21
        - 22
        - 23
        - 27
        - 28
        - 29
        - 30
        - 31
        - 34
        - 41
        - 42
        - 51
        - 52
        - 54
        - 62
        - 64
        - 81
      x-enumDescriptions:
        '2': Turkish
        '4': Hebrew
        '7': English
        '8': French
        '9': Romanian
        '10': Swedish
        '11': Norwegian
        '12': Russian
        '13': Iceland
        '14': Portuguese
        '15': Spanish
        '16': Italian
        '17': Danish
        '18': Polish
        '21': Dutch
        '22': Chinese
        '23': Hungarian
        '27': Thai
        '28': German
        '29': Japanese
        '30': Greek
        '31': English UK
        '34': Latvian
        '41': Slovenian
        '42': Estonian
        '51': Vietnamese
        '52': Czech
        '54': Finnish
        '62': Arabic
        '64': Lithuanian
        '81': Bulgarian
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: Enter your Bearer token. It's required to authenticate API requests.

````