---
title: STORY_RUN_LINK
url: https://www.tines.com/docs/formulas/functions/story-run-link/
kind: formula-function
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/llms.txt) › [Formulas](https://www.tines.com/llm/docs/formulas.md) › [Functions](https://www.tines.com/llm/docs/formulas/functions.md)*

# STORY_RUN_LINK

*[View on tines.com](https://www.tines.com/docs/formulas/functions/story-run-link/)*

Returns a link to the currently executing story run. Mode can be set to "action" to return a link to the action with events filtered by story run.

**Categories:** Story Metadata

## Syntax

```
STORY_RUN_LINK([mode: "story_runs"])
```

## Examples

### Example 1

Formula:

```
STORY_RUN_LINK()
```

Output:

```json
"https://<<tenant>>.tines.com/stories/<<story_id>>/runs/<<guid>>/"
```

### Example 2

Formula:

```
STORY_RUN_LINK("action")
```

Output:

```json
"https://<<tenant>>.tines.com/stories/<<story_id>>?actions=<<action_id>>&storyRuns=<<guid>>"
```

## Sample actions

```json
{
  "standardLibVersion": "13",
  "actionRuntimeVersion": "1",
  "agents": [
    {
      "disabled": false,
      "name": "STORY_RUN_LINK",
      "description": "",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "story_run_link": "=STORY_RUN_LINK()"
        }
      },
      "position": {
        "x": 30,
        "y": 3765
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    }
  ],
  "links": [],
  "diagramNotes": []
}
```
