Put Provenance | AgentTrunk Documentation

Requires revision read and staging environment deployment permission. Author identity is assigned server-side. Does not modify content, channels, or PR approval. Concurrent updates return 409; reread and reconcile, never blindly retry with a newer token.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

trunkIdstringRequiredformat: "^trunk_[A-Za-z0-9]+$"

contextKeystringRequiredformat: "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$"

Request

This endpoint expects an object.

revisionIdstringRequiredformat: "^[a-f0-9]{64}$"

textstringRequired1-16000 characters

Maximum 16000 UTF-8 bytes; not 16000 arbitrary Unicode characters.

expectedNotesCommitShastring or nullRequiredformat: "^[a-f0-9]{40}$"

Null for the first note; otherwise the notesCommitSha returned by GET.

Response

Saved note and its notesCommitSha receipt.

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

502

Bad Gateway Error

1	const url = 'https://api.agenttrunk.ai/v1/trunks/trunkId/contexts/contextKey/provenance';
2	const options = {
3	method: 'PUT',
4	headers: {Authorization: 'Bearer <accessToken>', 'Content-Type': 'application/json'},
5	body: '{"revisionId":"string","text":"string","expectedNotesCommitSha":"string"}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}