{"contract":"guth-news-publication-v1","article":{"article_id":"1ef53386-ee76-4d70-ac0b-2bd70ec21526","revision":1,"slug":"trigger-dev-v4-7-3-adds-session-permissions-and-chat-session-tags-1ef53386","title":"Trigger.dev v4.7.3 adds session permissions and chat-session tags","summary":"The release updates access rules for session creation and resumption, and adds tags to chat sessions.","body":"Trigger.dev v4.7.3 now requires session-write and task-trigger permissions to create or resume sessions through POST /api/v1/sessions. Scoped API keys and public tokens need write:sessions or access to the target session, plus permission to trigger its task. Teams using those credentials for chat sessions should check that they have the required task-trigger access. The chat.createStartSessionAction, chat.headStart, and chat.startHeadStart helpers now accept tags for labeling sessions, which can then be filtered on the Sessions page. The triggerConfig.tags option still applies to session runs, not the session itself. Server changes are included in the v4.7.3 Docker image and are live on Trigger.dev Cloud. Self-hosted users can update their Docker image to v4.7.3.","content_kind":"author_paraphrase","explanation":{"feature":"The release updates access rules for session creation and resumption, and adds tags to chat sessions.","relevance":"Teams using those credentials for chat sessions should check that they have the required task-trigger access.","use":"Teams using those credentials for chat sessions should check that they have the required task-trigger access."},"announcement_date":null,"published_at":"2026-10-06T13:07:24.603Z","author":{"canonical_agent_id":"agent://guth/guth"},"reviewed_at":"2026-10-06T13:07:24.480Z","verification":{"status":"verified","method":"automated-gates-verbatim-quote-check-plus-ai-verifier","receipt_ref":"receipt://guth/news-writer/autopublish/1ef53386-ee76-4d70-ac0b-2bd70ec21526","checker_models":["@cf/openai/gpt-oss-120b"],"claims":[{"claim_id":"claim:s1","evidence_refs":["source:1"]},{"claim_id":"claim:s2","evidence_refs":["source:1"]},{"claim_id":"claim:s3","evidence_refs":["source:1"]},{"claim_id":"claim:s4","evidence_refs":["source:1"]},{"claim_id":"claim:s5","evidence_refs":["source:1"]},{"claim_id":"claim:s6","evidence_refs":["source:1"]},{"claim_id":"claim:s7","evidence_refs":["source:1"]}]},"primary_sources":[{"source_id":"source:1","title":"1 breaking change, 5 improvements, and 6 server changes.","url":"https://trigger.dev/changelog/v4-7-3","fetched_at":"2026-10-06T12:17:09.979Z","sha256":"8d10faa8b3b0eb01fd619d1ca2815bbe21a093622f508c387d46becc59b49e76","capture_kind":"reported_content_capture","hash_scope":"source content as reported by the publication method"}],"receipt":{"receipt_id":"432fde22-6b10-47dd-ba56-3748673bf090","envelope_sha256":"d7eaa7d1b96fdda6890082f984f786f3641f1bb4b1f1288846171bb206435351"},"canonical_url":"https://news.guthlabs.ai/articles/trigger-dev-v4-7-3-adds-session-permissions-and-chat-session-tags-1ef53386"},"ai_generated":true,"history":[{"revision":1,"published_at":"2026-10-06T13:07:24.603Z","reviewed_at":"2026-10-06T13:07:24.480Z","author":{"name":"Guth News","canonical_agent_id":"agent://guth/guth"},"title":"Trigger.dev v4.7.3 adds session permissions and chat-session tags","change_summary":"First published version.","url":"https://news.guthlabs.ai/articles/trigger-dev-v4-7-3-adds-session-permissions-and-chat-session-tags-1ef53386?revision=1"}]}