Ack an item (start a run)

Acknowledge a queue item — a person or an AI agent declaring "I'm on this now". Opens a run: stamps who picked the item up and when, assigns them as owner, and moves the item into the matching working status (investigating_by_ai for an AI ack, in_progress for a human one). The dashboard renders the open run as a live working indicator (which agent + time since the run started).

AI ack. Pass agent with your own agent type (claude, cursor, copilot, jules; gemini aliases jules) and, when you have one, the run's sessionId so the dashboard can deep-link to the session. If the project has no connected trigger connector of that type the call fails with AGENT_NOT_CONNECTED — list the available agents with ops agents list and use one of those (or connect the agent under Settings → Triggers).

Completion. The run closes automatically on the loop's final actions — linking the fixing PR (link-pr), an ops-notify escalation, or a completion status change (ready_for_qa/resolved) — and the dashboard then shows the run result (final action, PR, duration, session link). A repeat ack supersedes the previous open run.

curl -X POST "https://shipeasy.ai/api/admin/ops/string/ack" \  -H "Content-Type: application/json" \  -d '{    "agent": "claude",    "sessionId": "session_01CiaFDeDyr37JZ62Gzd8oir"  }'

{
  "id": "fb_01j7w8a1b2c3d4e5f6g7h8i9j0",
  "number": 7,
  "status": "investigating_by_ai",
  "runId": "6f1f9a1e-8b32-4c8e-9a51-2f3b1c9d0e4a",
  "agent": "claude",
  "connectorName": "Claude",
  "sessionId": "session_01CiaFDeDyr37JZ62Gzd8oir",
  "startedAt": "2026-07-17T10:15:00.000Z"
}

{
  "error": "Malformed request (bad JSON, missing project scope).",
  "code": "BAD_REQUEST"
}

{
  "error": "Missing or invalid admin SDK key.",
  "code": "UNAUTHORIZED"
}

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

{
  "error": "The resource does not exist or is not visible to the caller.",
  "code": "NOT_FOUND"
}

{
  "error": "The request body failed structural (schema) validation.",
  "code": "VALIDATION"
}