Get Rollback Plan

GET

https://api.agenttrunk.ai/v1/trunks/:trunkId/contexts/:contextKey/rollback

Check whether an immutable revision can be restored to staging. This is advisory; the write rechecks permissions, release evidence, and staging concurrency. Ineligible responses do not expose the current staging revision.

Authentication

AuthorizationBearer

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

Path parameters

trunkIdstringRequired

contextKeystringRequired

Query parameters

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

Response

Rollback eligibility and the expected staging revision when eligible.

eligibleboolean

expectedStagingRevisionIdstring or null

reasonstring

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

1	const url = 'https://api.agenttrunk.ai/v1/trunks/trunkId/contexts/contextKey/rollback?revisionId=revisionId';
2	const options = {method: 'GET', headers: {Authorization: 'Bearer <accessToken>'}};
3
4	try {
5	const response = await fetch(url, options);
6	const data = await response.json();
7	console.log(data);
8	} catch (error) {
9	console.error(error);
10	}

1	{
2	"eligible": true,
3	"expectedStagingRevisionId": "string",
4	"reason": "string"
5	}