---
title: "Save the role research document"
method: POST
path: "/api/v1/agent/intake/research"
tags: ["Agent"]
---

# Save the role research document

`POST /api/v1/agent/intake/research`

## 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/research`
- Auth: HTTP bearer

The research document: a summary, the nine sections by key, and the funnel from search_candidates. May be saved a few sections at a time; each save replaces the last. Directions wait for all nine sections and a funnel.

## Request body

- object
  - `summary` string: 3 to 5 bullet points, one per line, each starting with "- ". Each bullet is one short, plain sentence for a non-technical recruiter. No jargon, no semicolons, no hedging. Together they cover who to look for, where they work now (name the peer companies when known), how pay compares with the budget, and the one thing to check when reviewing people. For example: - Look for backend engineers who build payment systems. - Most work at fintechs like Razorpay, PhonePe and Juspay. - Your budget covers about 7 in 10 of them. - When you review people, check they have run their own code in production.
  - `sections` object[]
    - `key` 'job' | 'titles' | 'skills' | 'seniority' | 'talent_pool' | 'great_vs_average' | 'company_fit' | 'backgrounds' | 'how_to_find', required
    - `peek` string, required
    - `bullets` string[], required
    - `sources` object[], required
      - `label` string, required
      - `url` string, nullable
  - `funnel` object[]
    - `label` string, required
    - `count` integer, required
  - `streamed` boolean

## Response `200`

Saved, or refused

- object
  - `data` object, required
    - `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)