Skip to content
GigAI

List answers

GET
/api/answers
curl --request GET \
  --url http://127.0.0.1:8765/api/answers

Every answer of the user, with tags, dates, writer and the jobs that asked or reused it. 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). total counts the answers before q and tag narrow them.

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
q
string

Only answers whose id, question, answer or tag holds this text.

tag
string

Only answers with this tag.

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
{
  "answers": [
    {
      "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",
  "tags": [
    "technical"
  ],
  "total": 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”

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": "target_unavailable",
    "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": "..."
  }
}