---
title: "Create Node Group"
method: POST
path: "/node-groups"
tags: ["Node Groups"]
---

# Create Node Group

`POST /node-groups`

Create a new node group

## Request body

- CreateNodeGroupInput
  - `data` ModelsNodeGroup, required — Node group data
    - `_id` string, objectid — ID
    - `active_count` integer — Active nodes in group (computed)
    - `created_at` string, date-time — Created timestamp
    - `created_by` string, objectid — Created by
    - `description` string — Node group description
    - `name` string — Node group name
    - `node_ids` string[] — Node IDs in this group
    - `total_count` integer — Total nodes in group (computed)
    - `updated_at` string, date-time — Updated timestamp
    - `updated_by` string, objectid — Updated by

## Response `200`

OK

- ControllersResponseGithubModelsNodeGroup
  - `data` ModelsNodeGroup — Node group data
    - `_id` string, objectid — ID
    - `active_count` integer — Active nodes in group (computed)
    - `created_at` string, date-time — Created timestamp
    - `created_by` string, objectid — Created by
    - `description` string — Node group description
    - `name` string — Node group name
    - `node_ids` string[] — Node IDs in this group
    - `total_count` integer — Total nodes in group (computed)
    - `updated_at` string, date-time — Updated timestamp
    - `updated_by` string, objectid — Updated by
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/crawlab-team/apis/crawlab-api.md) · [All operations](https://skmtc.net/crawlab-team/apis/crawlab-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crawlab-team/crawlab-api/revisions/c7a4715c1f13/schema)