# WorkflowNodeReference

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/http-api/schemas/workflownodereference/
> Summary: OpenAPI request or response schema for WorkflowNodeReference, including required fields, defaults, constraints, and linked nested types.

[← All HTTP schemas](/http-api/schemas/)

Points to a single node entering a workflow's graph: an agent from the
catalog, or a function registered in code.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `name` | yes | `string` | Gets the referenced name: an agent name from the catalog when WorkflowNodeKind WorkflowNodeReference.Kind is WorkflowNodeKind.Agent, or a function name from the code registry when it is WorkflowNodeKind.Function. | — |
| `kind` | yes | [`WorkflowNodeKind`](/http-api/schemas/workflownodekind/) | Gets which registry `Name` is looked up in. | — |
| `settings` | no | `null` oneOf [`JsonElement`](/http-api/schemas/jsonelement/) | — | — |
| `timeout` | no | `string` | Gets the longest time one call of this node may take. `null` (the default) uses the node's default: the timeout its function was registered with, or the installation's `Tracon:AgentGraph:ChildDeadline` for an agent node. | pattern `^-?(\d+\.)?\d{2}:\d{2}:\d{2}(\.\d{1,7})?$` |
| `agentVersion` | no | `integer (int32)` | Gets the version of the agent this step runs. `null` (the default) runs the agent's current version, resolved each time the step runs. | pattern `^-?(?:0\\|[1-9]\d*)$` |