---
title: "Add Workflow Node"
method: POST
path: "/v1/agents/{agent_id}/workflow/nodes"
tags: ["Agent Workflow"]
---

# Add Workflow Node

`POST /v1/agents/{agent_id}/workflow/nodes`

Add a node to the agent's stored workflow. The node has no edges yet — call
``POST .../workflow/edges`` to connect it. Returns ``{node_id}``.

## Path parameters

- `agent_id` string, required

## Headers

- `X-API-Key` string, required

## Request body

- NodeCreate — Universal node-creation spec. Same field set as :class:`NodePatch` but ``name`` is required.
  - `name` string, required
  - `prompt` string, nullable
  - `description` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/versions/f48cef80963f/schema)