---
title: "Save the role card and the questions for the recruiter"
method: POST
path: "/api/v1/agent/intake/role_card"
tags: ["Agent"]
---

# Save the role card and the questions for the recruiter

`POST /api/v1/agent/intake/role_card`

## Request

- Base URL: `https://api.flexiple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flexiple.com/api/v1/agent/intake/role_card`
- Auth: HTTP bearer

The role card and up to 5 questions, each with 2 to 6 options and your pick in `recommended`. Detailed: send no `answers`. Fast: send `answers` for every question. The reply's `phase` is "questions" (end your turn) or "research" (go on).

## Request body

- object
  - `title` string, required
  - `facts` object[], required
    - `id` string, required
    - `label` string, required
    - `mark` 'stated' | 'inferred', required
  - `questions` object[], required
    - `id` string, required
    - `kind` 'check' | 'ask', required
    - `short` string, required
    - `title` string, required
    - `why` string, required
    - `multi` boolean
    - `allow_decide` boolean
    - `company` boolean
    - `recommended` string[], required
    - `options` object[], required
      - `id` string, required
      - `label` string, required
      - `sub` string
      - `new_company_id` integer
  - `answers` object: Fast only. Keyed by question id: {"picks": [option ids], "decide": false, "other": [text], "new_company_id": id on the company question}

## Response `200`

Recorded, with the phase the run moved to; or refused

- object
  - `data` object, required
    - `phase` 'questions' | 'research'
    - `reply` string: What to do next
    - `refused` boolean: Present and true only when a rule was broken
    - `reason` string: Why it was refused, in a plain sentence

---

[API](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1.md) - [All operations](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/revisions/27e7987859f2?raw)