Ask QA a question about an item
Put a question to QA on a queue item — use it when you do not know the answer yourself and QA's decision unblocks the work. The question is open until QA…
Put a question to QA on a queue item — use it when you do not know the
answer yourself and QA's decision unblocks the work. The question is open
until QA answers it; it surfaces on the item (ops get → qaQuestions)
and in the project-wide QA backlog (ops list --qa-questions open). The
asker is the caller's identity; pass agent to record it as asked by that
agent type.
A coding agent cannot tell whether an empty state is a bug or intended; it asks QA and carries on with the rest of the item.
Authorization
bearerSdkKey Pass an admin SDK key as Authorization: Bearer sdk_admin_…. Mint via POST /api/admin/keys with type: "admin".
In: header
Path Parameters
Per-project item number (e.g. 7) or the full ops item id.
1 <= length <= 128Header Parameters
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).
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://shipeasy.ai/api/admin/ops/string/qa-questions" \ -H "Content-Type: application/json" \ -d '{ "question": "Should an archived metric still show on the experiment readout, or be hidden?" }'{
"id": "string",
"feedbackId": "string",
"question": "string",
"status": "open",
"askedByEmail": "string",
"askedByAgent": "jarvis",
"answer": "string",
"answeredByEmail": "string",
"answeredByAgent": "jarvis",
"answeredAt": "string",
"createdAt": "string"
}{
"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"
}List an item's QA questions
The questions put to QA on a queue item, newest first (max 100), each with QA's answer once given. ops get returns the same list as qaQuestions.
Answer a QA question
Answer one open QA question. The question moves to answered and the answer shows on the item. An answered question cannot be answered again (409); ask a new…