Actions11
- Output Actions
- Instruction Actions
- API Actions
Output → Update an Output
AI-generatedSummary
Update details of an existing Output in Tracira, including its metadata, file labels, and associated session, subject, or actor IDs, without changing the output content, verdict, or decision.
Inputs
- Output ID (required) — The ID of the output to update, typically mapped from a previous Send an Output operation or Decision trigger.
- Metadata — Key-value pairs to add or update on the output's metadata. Only specified keys are changed; unspecified keys remain unchanged if metadata mode is 'merge'.
- Metadata (JSON) — A JSON object with structured metadata values stored alongside the simple key-value metadata entries. Keys present here but also in Metadata entries will have the Metadata entry take precedence.
- Remove Metadata Keys — Comma-separated list of metadata keys to delete explicitly from the output. Ignored if keys do not exist.
- Existing Metadata — Defines how to handle existing metadata on the output: 'Keep It and Add These' merges new keys with existing, while 'Replace It With These' replaces all metadata with the provided keys, clearing all if none specified.
- File Labels — Labels to rename files already attached to this output, allowing human reviewers to distinguish between files. Only existing files can be relabeled; to add files, use Send an Output.
- Update Fields — Optional fields to update actorId (who triggered the execution), sessionId (conversation/thread), and subjectId (customer, ticket, or record associated with the output).
Output shape
a single record
Returns the updated output record as JSON. Requires at least one metadata entry, removal key, file label, or update field to be specified; otherwise, an error is thrown indicating nothing to update.