---
title: "Create Variable"
method: POST
path: "/v1/variables"
tags: ["V1 - Variables"]
---

# Create Variable

`POST /v1/variables`

## Request

- Base URL: `https://api.app.noxus.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.app.noxus.ai/v1/variables`
- Auth: API key in header `X-API-Key`

Create a variable or secret.

## Request body

- VariableUpsertRequest: Create payload — used by both group and workflow CRUD.
  - `name` string, required
  - `kind` 'variable' | 'secret'
  - `value_type` 'string' | 'number' | 'boolean' | 'object' | 'datetime' | 'file'
  - `source` 'inline' | 'vault' | 'environment'
  - `inline_value` string, nullable
  - `vault_credential_id` string, nullable
  - `vault_path` string, nullable
  - `vault_key` string, nullable
  - `env_var_name` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/noxus/apis/noxus-backend.md) - [All operations](https://skmtc.dev/noxus/apis/noxus-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/noxus/apis/noxus-backend/revisions/0e37810b7ad5?raw)