Skip to content
GigAI

Get one answer

GET
/api/answers/{question_id}
curl --request GET \
  --url http://127.0.0.1:8765/api/answers/example

One answer. Answers belong to the user, not to a profile: every profile’s assessment and tailoring reads the same ones. Each answer: the question_id (its id in the other routes), the question as asked (the id itself when only the id is known), the answer, a model-free tag (technical, experience-level, eligibility, education, domain, leadership, conflict, failure, collaboration, system-design, delivery, skill, other; or your own), jobs (the postings that asked it, confirmed a suggestion with it, or whose assessment reused it: kind answered | confirmed | reused), written_by (operator | agent), source (free text the writer gave: where the answer came from; null when it gave none), created_at, updated_at, revision (send it back on PUT and DELETE) and the last writes in history ({at, by, action}; an entry with answer is an earlier text kept when two profiles’ answers were merged).

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
question_id
required
string

An answer’s id (e.g. cloud:gcp). Percent-encode it in the path.

Responses

Section titled “Responses”

200

Section titled “200”

Success.

Media typeapplication/json
object
schema_version
required
Allowed value: scout-answers-response:1
key
additional properties
any
Example
{
  "answer": {
    "answer": "Yes, 4 years, GKE + BigQuery",
    "created_at": "2026-10-02T15:00:00.000000Z",
    "history": [
      {
        "action": "answered",
        "at": "2026-10-02T15:00:00.000000Z",
        "by": "agent"
      }
    ],
    "jobs": [
      {
        "at": "2026-10-02T15:00:00.000000Z",
        "company": "Acme",
        "job_identity": "https://boards.greenhouse.io/acme/jobs/101",
        "kind": "answered",
        "title": "Software Engineer",
        "url": "https://boards.greenhouse.io/acme/jobs/101"
      }
    ],
    "question": "Do you have GCP experience?",
    "question_id": "cloud:gcp",
    "revision": 1,
    "source": "from the user's repo infra-charts, at the user's request",
    "tag": "technical",
    "updated_at": "2026-10-02T15:00:00.000000Z",
    "written_by": "agent"
  },
  "schema_version": "scout-answers-response:1"
}

403

Section titled “403”

Forbidden / forbidden_origin: loopback peer and Host 127.0.0.1:<port> or localhost:<port> only (Origin too on writes).

Media typeapplication/json
object
error
required
object
allowed_keys
Array<string>
code
required
string
message
required
string
key
additional properties
any
Examplegenerated
{
  "error": {
    "allowed_keys": [
      "example"
    ],
    "code": "example",
    "message": "example"
  }
}

404

Section titled “404”

Not_found, target_unavailable

Media typeapplication/json
object
error
required
object
allowed_keys
Array<string>
code
required
string
message
required
string
key
additional properties
any
Example
{
  "error": {
    "code": "not_found",
    "message": "..."
  }
}

422

Section titled “422”

Unknown_key

Media typeapplication/json
object
error
required
object
allowed_keys
Array<string>
code
required
string
message
required
string
key
additional properties
any
Example
{
  "error": {
    "code": "unknown_key",
    "message": "..."
  }
}