<!-- Generated by SpecStory, Markdown v2.1.0 -->

<!-- cursor Session f30d5c87-c0dc-4752-96d3-4ece4ad14254 (2026-03-17 19:18Z) -->

# Flamenco API exploration (2026-03-17 19:18Z)

_**User**_

Explore this codebase to find information about Flamenco's API. Look for:
1. API documentation files (API.md, api/, docs/api/, etc.)
2. API endpoints and routes in the code
3. Any OpenAPI/Swagger specifications
4. Main server files that define API routes
5. Any README or documentation that explains the API

Return a summary of:
- What Flamenco is (what does this software do?)
- What API capabilities exist
- Key API endpoints or features found
- How to access/interact with the API

---

_**Agent (model accounts/fireworks/models/kimi-k2p5, mode Agent)**_



---

<think><details><summary>Thought Process</summary>
The user wants me to explore a codebase called "Flamenco" to find information about its API. I need to:

1. Look for API documentation files
2. Find API endpoints and routes in the code
3. Look for OpenAPI/Swagger specs
4. Find main server files with API routes
5. Find README or documentation about the API

Let me start by exploring the project structure to understand what Flamenco is and then dive into API-related files.</details></think>

---

I'll explore the Flamenco codebase to find information about its API. Let me start by understanding the project structure and then look for API-related files.

---

<tool-use data-tool-type="shell" data-tool-name="run_terminal_command_v2">
<details><summary>Tool use: **run_terminal_command_v2** • Run command: ls -la</summary>

```bash
ls -la
```
</details>
</tool-use>

---

<tool-use data-tool-type="generic" data-tool-name="glob_file_search">
<details>
<summary>Tool use: **glob_file_search** • Searched codebase "undefined" • **0** result in **1** directory</summary>

Directory: **undefined** (0 file)

</details>
</tool-use>

---

<tool-use data-tool-type="generic" data-tool-name="glob_file_search">
<details>
<summary>Tool use: **glob_file_search** • Searched codebase "undefined" • **0** result in **1** directory</summary>

Directory: **undefined** (0 file)

</details>
</tool-use>

---

<tool-use data-tool-type="generic" data-tool-name="glob_file_search">
<details>
<summary>Tool use: **glob_file_search** • Searched codebase "undefined" • **0** result in **1** directory</summary>

Directory: **undefined** (0 file)

</details>
</tool-use>

---

<tool-use data-tool-type="generic" data-tool-name="glob_file_search">
<details>
<summary>Tool use: **glob_file_search** • Searched codebase "undefined" • **0** result in **1** directory</summary>

Directory: **undefined** (0 file)

</details>
</tool-use>

---

<tool-use data-tool-type="generic" data-tool-name="glob_file_search">
<details>
<summary>Tool use: **glob_file_search** • Searched codebase "undefined" • **0** result in **1** directory</summary>

Directory: **undefined** (0 file)

</details>
</tool-use>

---

<think><details><summary>Thought Process</summary>
It seems the directory might be empty or the files aren't matching my patterns. Let me try different approaches to explore the workspace.</details></think>

---

Let me try a different approach to explore the workspace.

---

<tool-use data-tool-type="shell" data-tool-name="run_terminal_command_v2">
<details><summary>Tool use: **run_terminal_command_v2** • Run command: dir</summary>

```bash
dir
```
</details>
</tool-use>

---

<tool-use data-tool-type="generic" data-tool-name="glob_file_search">
<details>
<summary>Tool use: **glob_file_search** • Searched codebase "undefined" • **68** results in **1** directory</summary>

Directory: **undefined** (68 files)

| File |
|------|
| `scripts/TalkingHeads cycles_optix_gpu.js` |
| `sqlite/2025.04.22.09.37.45_flamenco-manager.sqlite` |
| `unified_flamenco_launcher.ps1` |
| `.specstory/history/2025-07-15_18-30Z-configure-launch-standard-worker-for-flamenco-3-7.md` |
| `.gitignore` |
| `.specstory/history/2025-05-06_21-34Z-identifying-mistakes-and-seeking-guidance.md` |
| `.specstory/history/2025-08-13_18-59Z-remove-seq-from-jobname-format.md` |
| `.specstory/history/2025-11-21_01-14Z-workers-failing-and-ssh-connection-issues.md` |
| `sqlite/2025.06.06.09.50.20_flamenco-manager.sqlite` |
| `sqlite/2025.05.09.09.38.44_flamenco-manager.sqlite` |
| `.specstory/history/2025-05-05_16-17Z-flamenco-job-status-troubleshooting.md` |
| `.specstory/history/2025-04-04_17-25Z-creating-worker2-scripts-for-flamenco.md` |
| `.specstory/history/2025-11-06_17-28Z-update-path-structure-for-renders.md` |
| `sqlite/2025.05.05.16.15.03_flamenco-manager.sqlite` |
| `.specstory/history/2025-11-19_17-03Z-why-is-git-frozen.md` |
| `sqlite/2025.05.05.10.09.33_flamenco-manager.sqlite` |
| `sqlite/2025.07.22.09.37.20_flamenco-manager.sqlite` |
| `.specstory/history/2025-04-23_20-48Z-network-drive-mapping-and-file-copying-script.md` |
| `.specstory/history/2025-11-21_16-43Z-fixing-sheepit-worker-incompatibility.md` |
| `.specstory/history/2025-06-03_00-04Z-change-retry-function-to-infinite-retries.md` |
| `.specstory/history/2026-01-08_23-42Z-windows-symlinking-error.md` |
| `sqlite/2026.01.08.10.06.50_flamenco-manager.sqlite` |
| `.specstory/history/2026-03-06_22-52Z-sequence-determination-in-custom-javascripts.md` |
| `sqlite/2025.11.19.11.05.13_flamenco-manager.sqlite` |
| `TODO.md` |
| `sqlite/2025.06.17.13.57.17_flamenco-manager.sqlite` |
| `.specstory/history/2025-05-06_20-07Z-switching-to-optix-gpu-rendering.md` |
| `.specstory/history/2026-01-09_18-22Z-nexus-manager-access-issue.md` |
| `sqlite/2025.07.15.10.16.07_flamenco-manager.sqlite` |
| `sqlite/2025.04.17.09.50.29_flamenco-manager.sqlite` |
| `unified_sheepit_launcher.bat` |
| `sqlite/2025.07.10.10.00.59_flamenco-manager.sqlite` |
| `.specstory/history/2026-03-04_02-01Z-testing-discussion.md` |
| `.specstory/history/2026-03-16_20-23Z-blocklisting-in-flamenco-codebase.md` |
| `.specstory/history/2026-03-16_20-23Z-disabling-blocklisting-in-flamenco.md` |
| `sqlite/2025.05.12.10.52.00_flamenco-manager.sqlite` |
| `unified_sheepit_launcher.ps1` |
| `.specstory/.project.json` |
| `linux_flamenco_manager.bat` |
| `.specstory\.what-is-this.md` |
| `sqlite/2025.05.28.17.21.15_flamenco-manager.sqlite` |
| `.specstory/history/2025-05-23_23-12Z-replace-remotecmd-with-remotesimplified.md` |
| `sqlite/2025.07.15.14.04.28_flamenco-manager.sqlite` |
| `unified_flamenco_launcher.bat` |
| `.specstory/history/2026-02-10_22-00Z-error-in-blender-file-cleanup-command.md` |
| `sqlite/2025.04.24.09.43.08_flamenco-manager.sqlite` |
| `.specstory/history/2025-05-07_22-05Z-script-modification-for-masterbox.md` |
| `.specstory/history/2026-01-09_20-34Z-flamenco-project-file-path-consistency.md` |
| `.specstory/.gitignore` |
| `.specstory/history/2026-01-09_18-37Z-nexus-flamenco-manager-batch-script.md` |
| `.specstory/history/2025-05-14_15-49Z-cmd-worker-error-handling-and-retry-logic.md` |
| `sqlite/2025.04.21.09.53.46_flamenco-manager.sqlite` |
| `sqlite/2025.09.11.11.39.47_flamenco-manager.sqlite` |
| `sqlite/2026.02.10.10.22.19_flamenco-manager.sqlite` |
| `.specstory/history/2026-01-08_17-28Z-shaman-symlinking-for-windows-samba.md` |
| `.specstory/history/2025-05-13_23-13Z-bypassing-password-prompts-in-script.md` |
| `.gitattributes` |
| `sqlite/2025.10.27.12.46.53_flamenco-manager.sqlite` |
| `scripts/outline.txt` |
| `sqlite/2025.04.25.09.55.50_flamenco-manager.sqlite` |
| `.specstory/history/2025-05-12_16-04Z-technical-scripting-and-troubleshooting-discussion.md` |
| `.specstory/history/2025-11-03_19-27Z-create-sister-script-for-sheepit.md` |
| `sqlite/2025.07.28.09.34.53_flamenco-manager.sqlite` |
| `sqlite/2025.07.01.11.02.08_flamenco-manager.sqlite` |
| `.cursorindexingignore` |
| `.specstory/history/2025-04-25_19-30Z-i9-13ks-setup-troubleshooting.md` |
| `scripts/TalkingHeads Custom Render.js` |
| `sqlite/2026.03.02.11.11.48_flamenco-manager.sqlite` |

</details>
</tool-use>

---

<think><details><summary>Thought Process</summary>
This is interesting. I can see:
1. SQLite databases named "flamenco-manager.sqlite" - suggesting Flamenco is a render farm manager
2. Scripts for "TalkingHeads" which seem to be custom JavaScript files
3. Some .specstory/history files which contain conversations about Flamenco
4. Scripts for launching workers and managing Flamenco

Let me look at the TODO.md file and some of these specstory files to understand what Flamenco is. Also let me check the scripts folder.</details></think>

---

I can see this is related to Flamenco render farm manager. Let me explore the key files to understand the API.

---

<tool-use data-tool-type="read" data-tool-name="read_file_v2">
<details><summary>Tool use: **read_file_v2** • Read file: C:\Users\Nathan\Desktop\flamenco\TODO.md</summary>

</details>
</tool-use>

---

<tool-use data-tool-type="read" data-tool-name="read_file_v2">
<details><summary>Tool use: **read_file_v2** • Read file: C:\Users\Nathan\Desktop\flamenco\.specstory\.what-is-this.md</summary>

</details>
</tool-use>

---

<tool-use data-tool-type="generic" data-tool-name="glob_file_search">
<details>
<summary>Tool use: **glob_file_search** • Searched codebase "undefined" • **0** result in **1** directory</summary>

Directory: **undefined** (0 file)

</details>
</tool-use>

---

<tool-use data-tool-type="generic" data-tool-name="glob_file_search">
<details>
<summary>Tool use: **glob_file_search** • Searched codebase "undefined" • **0** result in **1** directory</summary>

Directory: **undefined** (0 file)

</details>
</tool-use>

---

<tool-use data-tool-type="generic" data-tool-name="glob_file_search">
<details>
<summary>Tool use: **glob_file_search** • Searched codebase "undefined" • **2** results in **1** directory</summary>

Directory: **undefined** (2 files)

| File |
|------|
| `scripts/TalkingHeads cycles_optix_gpu.js` |
| `scripts/TalkingHeads Custom Render.js` |

</details>
</tool-use>

---

<think><details><summary>Thought Process</summary>
So there are no Go or Python source files in this directory - this seems to be a workspace with scripts and databases for using Flamenco, not the actual Flamenco source code. The Flamenco source code must be elsewhere. Let me look at the specstory history files to learn more about what Flamenco is and its API.</details></think>

---

This workspace contains scripts for using Flamenco but not the source code. Let me examine the specstory history files to find API information.

---

<tool-use data-tool-type="read" data-tool-name="read_file_v2">
<details><summary>Tool use: **read_file_v2** • Read file: C:\Users\Nathan\Desktop\flamenco\.specstory\history\2025-05-05_16-17Z-flamenco-job-status-troubleshooting.md</summary>

</details>
</tool-use>

---

<tool-use data-tool-type="read" data-tool-name="read_file_v2">
<details><summary>Tool use: **read_file_v2** • Read file: C:\Users\Nathan\Desktop\flamenco\.specstory\history\2026-03-16_20-23Z-blocklisting-in-flamenco-codebase.md</summary>

</details>
</tool-use>

---

<tool-use data-tool-type="read" data-tool-name="read_file_v2">
<details><summary>Tool use: **read_file_v2** • Read file: C:\Users\Nathan\Desktop\flamenco\.specstory\history\2026-03-16_20-23Z-disabling-blocklisting-in-flamenco.md</summary>

</details>
</tool-use>

---

<tool-use data-tool-type="read" data-tool-name="read_file_v2">
<details><summary>Tool use: **read_file_v2** • Read file: C:\Users\Nathan\Desktop\flamenco\scripts\TalkingHeads Custom Render.js</summary>

</details>
</tool-use>

---

<think><details><summary>Thought Process</summary>
Now I have comprehensive information about Flamenco's API from the specstory history files. Let me read a few more files to get a complete picture and also check for any additional API documentation.</details></think>

---

Excellent! I've found extensive API information. Let me read a few more specstory files and scripts to get a complete picture.

---

<tool-use data-tool-type="read" data-tool-name="read_file_v2">
<details><summary>Tool use: **read_file_v2** • Read file: C:\Users\Nathan\Desktop\flamenco\.specstory\history\2025-07-15_18-30Z-configure-launch-standard-worker-for-flamenco-3-7.md</summary>

</details>
</tool-use>

---

<tool-use data-tool-type="read" data-tool-name="read_file_v2">
<details><summary>Tool use: **read_file_v2** • Read file: C:\Users\Nathan\Desktop\flamenco\scripts\outline.txt</summary>

</details>
</tool-use>

---

<tool-use data-tool-type="read" data-tool-name="read_file_v2">
<details><summary>Tool use: **read_file_v2** • Read file: C:\Users\Nathan\Desktop\flamenco\unified_flamenco_launcher.ps1</summary>

</details>
</tool-use>

---

<think><details><summary>Thought Process</summary>
I now have extensive information about Flamenco's API. Let me also search for more information about the API endpoints and how to interact with them.</details></think>

---

Let me search for a few more references to complete the API picture.

---

<tool-use data-tool-type="unknown" data-tool-name="ripgrep_raw_search">
<details>
<summary>Tool use: **ripgrep_raw_search**</summary>


Parameters:

```json
{
  "pattern": "api/v3|GET|POST|PATCH|DELETE",
  "path": "C:\\Users\\Nathan\\Desktop\\flamenco\\.specstory",
  "outputMode": "content",
  "context": 2,
  "caseInsensitive": false
}
```
Additional data:

```json
{
  "isPruned": true,
  "pattern": "api/v3|GET|POST|PATCH|DELETE",
  "path": "C:\\Users\\Nathan\\Desktop\\flamenco\\.specstory",
  "outputMode": "content",
  "totalFiles": 1,
  "totalMatches": 203,
  "topFiles": [
    {
      "uri": ".specstory/history/2025-08-13_18-59Z-remove-seq-from-jobname-format.md",
      "matchCount": 500
    }
  ]
}
```
Status: **completed**


</details>
</tool-use>

---

