---
title: "Create custom nodes"
method: POST
path: "/api/v2/custom-nodes"
tags: ["Custom Node Management", "Community", "Enterprise"]
---

# Create custom nodes

`POST /api/v2/custom-nodes`

This endpoint registers new node kinds along with optional display metadata such as icons and colors.
The provided configuration controls how nodes of the specified kinds are interpreted and rendered in the UI.
Only free, solid-style Font Awesome icons are supported. Hex color codes must follow the format #RGB or #RRGGBB.
If no valid icon or color is provided, the system will fall back to a question mark icon and a white background color.
Batch input is supported; you may submit multiple configuration objects in a single request.

## Request body

- object
  - `custom_types` object

## Response `201`

CREATED

- object
  - `data` ModelCustomNode[]
    - `id` integer
    - `kindName` string
    - `config` ModelCustomNodeConfig
      - `icon` object
        - `type` string
        - `name` string
        - `color` string

## Other responses

- `400` — **Bad Request** This could be due to one of the following reasons: - JSON payload is missing or malformed - Path or query parameters are missing or invalid/malformed - The data sent is not valid (ex- sending a `string` in an `integer` field)
- `401` — **Unauthorized** This endpoint failed an authentication requirement. Either the client tried to access a protected endpoint without being authenticated, or an auth validation failed (ex- invalid credentials or expired token).
- `409` — **Conflict** Duplicate Kind Name
- `500` — **Internal Server Error** This is usually the result of either an unexpected database or application error. The client may try modifying or resending the request, but the error is likely not related to the client doing something wrong.

---

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