docs(tasks): nullable title on task runs — originating scheduled task's title

[sweetmantech]

What

Amends the TaskRunResponse schema in api-reference/openapi/releases.json with a new nullable title field: the originating scheduled task's title, when resolvable. Purely additive (+5 lines, JSON parse re-validated, all pre-existing bytes untouched).

Why

GET /api/tasks/runs proxies Trigger.dev runs, which only carry taskIdentifier — and every scheduled prompt shares customer-prompt-task, so the chat homepage renders five identical "Scheduled Task" rows (recoupable/chat#1850, video-parity item 1). The api resolves each list-mode run's title by joining Trigger's filter[schedule] runs against the account's scheduled_actions (title + trigger_schedule_id). title is null when a run cannot be mapped to a scheduled task (e.g. non-scheduled runs), and is not present in retrieve mode (runId provided) — mirroring the schema's existing mode-scoped field notes.

Links

• Tracking: Valuation-first homepage (Catalog HQ): surface catalog value + task runs on chat home; fix the .dev cross-domain auth regression chat#1850 (Open — video/experience parity, item 1)
• Siblings: api implementation PR + chat render PR (linked from the tracking issue)
• Merge order: docs (this) → api → chat. Contract-first; the field is additive so docs landing first documents a field the api serves shortly after.

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features
  • Task run responses now include an optional title field when available, helping identify the originating scheduled task in run listings.
  • If a scheduled task can’t be resolved, the field may be returned as null.

---

Summary by cubic

Adds a nullable title field to TaskRunResponse so run listings can show the originating scheduled task’s title. Improves readability of GET /api/tasks/runs by naming scheduled runs; the field is only in list mode, may be null if unresolved, and is omitted in retrieve mode.

^{Written for commit 83faa16. Summary will update on new commits.}

[cursor]

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f1f01293-4c8a-4a62-9e49-8d4e39596f54

📥 Commits

Reviewing files that changed from the base of the PR and between a902d8e and 83faa16.

📒 Files selected for processing (1)

• api-reference/openapi/releases.json

---

📝 Walkthrough

Walkthrough

The OpenAPI specification for TaskRunResponse is updated to include a new optional, nullable title field representing the originating scheduled task's title, applicable only when listing runs without a specified runId.

Changes

TaskRunResponse Schema Update

Layer / File(s)	Summary
Add title field to schema api-reference/openapi/releases.json	Adds a nullable title string property to TaskRunResponse, documented as populated only during run listing and null otherwise.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Estimated code review effort

(see above)

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly reflects the main change: adding a nullable task-run title derived from the originating scheduled task.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/task-runs-title

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cubic-dev-ai]

No issues found across 1 file

_{Re-trigger cubic}