---
title: "WorkflowEdge"
description: "The `WorkflowEdge` entity."
section: "Reference"
group: "Types"
order: 269
---

## Definition

```ts
interface WorkflowEdge {
  id: string;
  workflowId: string;
  sourceNodeId: string | null;
  targetNodeId: string | null;
  handle: string | null;
  priority: number;
  label: string | null;
  createdAt: string;
}
```

## Fields

| Field          | Type             | Notes                                                                        |
| -------------- | ---------------- | ---------------------------------------------------------------------------- |
| `id`           | `string`         | `readonly` `required`                                                        |
| `workflowId`   | `string`         | `required` — Workflow this edge belongs to.                                  |
| `sourceNodeId` | `string \| null` | `required` — Source node of the edge; null when this is an entry edge.       |
| `targetNodeId` | `string \| null` | `required` — Target node of the edge; null when this is an exit edge.        |
| `handle`       | `string \| null` | `required` — Named output handle on the source node, if any.                 |
| `priority`     | `number`         | `required` — Edge ordering priority when a node has multiple outgoing edges. |
| `label`        | `string \| null` | `required` — Optional human-readable edge label.                             |
| `createdAt`    | `string`         | `readonly` `required` — ISO-8601 timestamp of creation.                      |