Stage Rollback

POST

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

Restore a previously released immutable revision into staging. Requires production rollback and staging deploy permissions. Production only changes through a subsequent promotion PR.

Authentication

AuthorizationBearer

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

Path parameters

trunkIdstringRequired

contextKeystringRequired

Request

This endpoint expects an object.

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

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

reasonstringRequired1-500 characters

Response

Staging restored; receipt contains revisionId

Errors

400

Bad Request Error

403

Forbidden Error

409

Conflict Error

1	const url = 'https://api.agenttrunk.ai/v1/trunks/trunkId/contexts/contextKey/rollback';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <accessToken>', 'Content-Type': 'application/json'},
5	body: '{"revisionId":"string","expectedStagingRevisionId":"string","reason":"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	}