List | AgentTrunk Documentation

const url = 'https://api.agenttrunk.ai/v1/trunks/trunkId/promotion-requests';
const options = {method: 'GET', headers: {Authorization: 'Bearer <accessToken>'}};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "data": [
    {
      "id": "string",
      "trunkId": "string",
      "scopeId": "string",
      "sourceCommitSha": "string",
      "targetCommitSha": "string",
      "changes": [
        {
          "contextId": "string",
          "contextKey": "string",
          "sourceRevisionId": "string",
          "targetRevisionId": "string"
        }
      ],
      "status": "open",
      "createdBy": "string",
      "createdAt": "2024-01-15T09:30:00Z",
      "evidenceReference": "string",
      "delegatedActorId": "string",
      "mergedBy": "string",
      "mergedDelegatedActorId": "string",
      "mergedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "nextCursor": "string"
}

Authentication

AuthorizationBearer

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

Path parameters

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

Query parameters

cursorstringOptional

scopeIdstringOptional<=200 characters

statusenumOptional

Allowed values:

limitintegerOptional1-100Defaults to 50

Response

A data array and nextCursor for organization-scoped requests. Scope/status filters run before snapshotting. Read permissions for both environments are checked on each page. Continue even when data is empty if nextCursor is not null. Snapshots expire after 15 minutes; mutation endpoints always validate current PR state.

datalist of objects

nextCursorstring or nullOptional