Save a new instructions version
Appends a version and makes it active.
Token callers create a teach version. Use it after a reviewer sends a draft back with feedback: rewrite the instructions with your own AI step, then save the result here with the reviewer's comment and the output it came from.
Dashboard sessions create manual edits or restores.
Send baseVersion - the version you read and rewrote - to make the save conditional. If anything was saved since (an edit in the dashboard, an accepted suggestion, another run), nothing is written and you get 409 with code: VERSION_CONFLICT and the currentVersion: fetch the instructions again, reapply your change, and retry. Without baseVersion the save always wins, which can silently undo a change made in between.
https://www.tracira.com/api/instructions/versionsAuthorization
webhookToken Workspace API token, from the Integrations page.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/instructions/versions" \ -H "Content-Type: application/json" \ -d '{ "project": "Customer Support", "task": "Email reply", "content": "You write friendly, concise replies to customer emails. Always sign off as The Support Team.", "teachComment": "Always sign off as The Support Team", "logId": "b1c2d3e4-5f60-4711-8899-aabbccddeeff" }'{ "version": 0}List instruction versions GET
Full version history for a project and task, newest first, including each version's text and what caused it.
Queue feedback for the instructions POST
Adds a note to the queue that the next suggested instructions update is drafted from - the same queue the dashboard's Teach the AI and Request a change fill. Use it for feedback that reaches your automation outside Tracira, such as a correction typed in your own chat app.