Shipeasy
APIOperations

Show the merge gates

The project's merge gates for trail changes — branch freshness, human review, agent findings, blocking evals and CI checks — each with whether it is…

The project's merge gates for trail changes — branch freshness, human review, agent findings, blocking evals and CI checks — each with whether it is evaluated and whether it blocks.

GET
/api/admin/trail-gates

Authorization

bearerSdkKey
AuthorizationBearer <token>

Pass an admin SDK key as Authorization: Bearer sdk_admin_…. Mint via POST /api/admin/keys with type: "admin".

In: header

Header Parameters

X-Project-Id?string

Project the request operates on. Optional — defaults to the project the SDK key belongs to; pass it only to scope a multi-project key (the generated client sets it once from its configuration, so per-call callers never thread it).

Response Body

application/json

application/json

application/json

curl -X GET "https://shipeasy.ai/api/admin/trail-gates"
{
  "upToDate": {
    "enabled": true,
    "blocking": true
  },
  "humanReview": {
    "enabled": true,
    "blocking": true,
    "minApprovals": 1,
    "resetOnPush": true,
    "authorCanApprove": false
  },
  "agentReview": {
    "enabled": true,
    "blocking": true,
    "severity": "high"
  },
  "evals": {
    "enabled": true,
    "blocking": true
  },
  "checks": {
    "enabled": true,
    "blocking": true,
    "required": [
      "string"
    ]
  },
  "discovered": {
    "enabled": true,
    "blocking": true,
    "priority": "nice_to_have"
  },
  "shipsDark": {
    "enabled": false,
    "blocking": false
  },
  "rollback": {
    "enabled": false,
    "blocking": false
  },
  "measured": {
    "enabled": false,
    "blocking": false
  },
  "guarded": {
    "enabled": false,
    "blocking": false
  },
  "copy": {
    "enabled": false,
    "blocking": false
  },
  "plan": {
    "enabled": true,
    "blocking": true
  },
  "requirePlan": true,
  "fixRounds": 3,
  "goalWindowDays": 7,
  "maxGoalReplans": 3,
  "maxParallelRuns": 3,
  "attributionWindowHours": 72,
  "rollout": {
    "steps": [
      1,
      5,
      25,
      50,
      100
    ],
    "holdMinutes": 0,
    "minExposure": 0,
    "internal": {
      "holdMinutes": 0
    },
    "guards": {
      "alertRuleIds": [
        "string"
      ],
      "attributedErrors": true
    },
    "policies": {
      "onBreach": "pull_back",
      "breachTimeoutMinutes": 1,
      "advance": "auto",
      "afterFix": "resume"
    }
  },
  "autopilot": {
    "maxRisk": 0,
    "repos": [
      "string"
    ],
    "types": [
      "feature"
    ],
    "maxFixRounds": 0,
    "maxPullBacks": 0,
    "maxRuns": 0
  },
  "intakeMatching": true,
  "repos": {
    "property1": {
      "checks": {
        "required": [
          "string"
        ]
      }
    },
    "property2": {
      "checks": {
        "required": [
          "string"
        ]
      }
    }
  }
}
{
  "error": "Missing or invalid admin SDK key.",
  "code": "UNAUTHORIZED"
}

{
  "error": "Key is valid but not allowed to act on this project.",
  "code": "FORBIDDEN"
}

Was this page helpful?