Answer a question
Answer one open question on a queue item — pick option labels in selected (exactly one unless the question is multiSelect) and/or write a free-text other.…
Answer one open question on a queue item — pick option labels in
selected (exactly one unless the question is multiSelect) and/or
write a free-text other. The question moves to completed. When it was
the last open question of a resume run, that agent is re-fired on the
item with every answer. A person's action: never allow-listed for
restricted ops keys.
Unblock an agent from the CLI instead of the dashboard.
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, or a trail handle (e.g. T-12) for a question on a trail.
1 <= length <= 128The question id (from ask or list).
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
application/json
curl -X POST "https://shipeasy.ai/api/admin/ops/string/questions/string/answer" \ -H "Content-Type: application/json" \ -d '{ "selected": [ "Keep it" ] }'{
"id": "string",
"feedbackId": "string",
"trailId": "string",
"header": "string",
"question": "string",
"options": [
{
"label": "string",
"description": "string"
}
],
"multiSelect": true,
"status": "open",
"answer": {
"selected": [
"string"
],
"other": "string"
},
"answeredBy": "string",
"answeredAt": "string",
"agent": "jarvis",
"askedBy": "string",
"runId": "string",
"delivery": "resume",
"deliveredAt": "string",
"deliveryError": "string",
"createdAt": "string",
"updatedAt": "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": "A resource with this name already exists in the project.",
"code": "ALREADY_EXISTS"
}{
"error": "The request body failed structural (schema) validation.",
"code": "VALIDATION"
}Ask the team questions about an item
Ask 1–4 structured questions about a queue item — the way to get a decision from a person when the implementation needs one. Each question is the…
Withdraw a question
Withdraw one open question you asked — it no longer needs an answer (you found it out yourself, or the item moved on). The question moves to cancelled and…