> ## Documentation Index > Fetch the complete documentation index at: https://docs.revcenter.ai/llms.txt > Use this file to discover all available pages before exploring further. # Extract criteria > Turns a job description or plain-language brief into structured criteria, without running a search. Use the returned `criteria` as the body of `POST /api/scans` once a human has reviewed it. ## OpenAPI ````yaml /openapi.json post /api/intake openapi: 3.1.0 info: title: Revcenter API description: >- Search, enrich, and activate people and companies. Two authentication surfaces share one host: the bearer-token API under `/v1` for server-to-server and agent use, and the workspace-session API under `/api` that the Revcenter app itself runs on. version: '2026-08-12' servers: - url: https://api.revcenter.ai description: Production security: - bearerAuth: [] tags: - name: Search description: Web search, search runs, results, exports, and shareable shortlists. - name: People description: Person search, profile enrichment, and the workspace contact pool. - name: Companies description: Company search, company enrichment, and org-chart people. - name: Campaigns description: Plan, publish, and launch outbound sequences on Smartlead and HeyReach. - name: Account description: Health, usage totals, and cost events. paths: /api/intake: post: tags: - Search summary: Extract criteria description: >- Turns a job description or plain-language brief into structured criteria, without running a search. Use the returned `criteria` as the body of `POST /api/scans` once a human has reviewed it. operationId: extractCriteria requestBody: required: true content: application/json: schema: type: object required: - rawInput properties: rawInput: type: string description: The job description or brief. examples: - >- Clinic manager in Lévis, Québec. French required. 5+ years managing a multi-site clinic. Find 25. mode: $ref: '#/components/schemas/ScanMode' model: $ref: '#/components/schemas/ExtractModel' responses: '200': description: Structured criteria plus coverage diagnostics. content: application/json: schema: type: object properties: criteria: $ref: '#/components/schemas/Criteria' entityCoverage: type: object description: >- Which criteria dimensions the input actually pinned down — drives the confirmation chips in the app. additionalProperties: true familyUnresolved: type: boolean description: >- True when the role sits outside the known role-family taxonomy. The role name is preserved as a title variant. familySuggestions: type: array items: type: string ontologyPlan: type: - object - 'null' additionalProperties: true rawToolInput: type: object additionalProperties: true '400': $ref: '#/components/responses/AppBadRequest' '401': $ref: '#/components/responses/AppUnauthorized' '424': $ref: '#/components/responses/AppProviderUnavailable' '502': $ref: '#/components/responses/AppUpstreamError' security: - sessionCookie: [] components: schemas: ScanMode: type: string enum: - candidate - client default: candidate description: >- `candidate` searches for people against a role. `client` discovers target companies first, then their decision-makers. ExtractModel: type: string enum: - claude-haiku-4-5 - claude-sonnet-5 - claude-opus-5 description: >- Which model extracts criteria. Anything outside this allowlist is rejected. Omit to use the workspace default. Criteria: type: object description: >- The structured brief a search runs on. Every field is optional, but a search with no signal finds nothing useful. The distinction that matters: `exclude_*` fields are hard and disqualify, while `avoid_*` fields are soft and only rank down. A great person at a firm you'd rather avoid still shows up; a person at an excluded firm never does. properties: family: type: string description: >- Role family from the taxonomy. Off-taxonomy roles are kept as a title variant instead. title_variants: type: array items: type: string description: >- Acceptable job titles. A quoted `title: "X"` in the brief always survives extraction and leads this list. seniority: type: string enum: - c_suite - vp - director - manager - ic allowed_seniority: type: array items: type: string enum: - c_suite - vp - director - manager - ic must_have: type: array items: type: string industries: type: array items: type: string metro: type: string examples: - San Jose, CA geo_radius_mi: type: number exclusiveMinimum: 0 description: >- Commute radius. Dropped automatically on country-level searches, where it is meaningless. remote_ok: type: boolean exclude_titles: type: array items: type: string description: Hard exclusion. exclude_industries: type: array items: type: string description: Hard exclusion. exclude_companies: type: array items: type: string description: >- Hard exclusion. Evaluated against search text too, so excluded people never reach paid enrichment. avoid_titles: type: array items: type: string description: Soft negative — ranks down, never rejects. avoid_industries: type: array items: type: string description: Soft negative. avoid_companies: type: array items: type: string description: Soft negative. comp_band: type: array items: type: number minItems: 2 maxItems: 2 years_experience: type: object properties: min: type: number max: type: number min_avg_tenure_years: type: number exclusiveMinimum: 0 skills: type: array items: type: string skills_required: type: array items: type: string languages_required: type: array items: type: string description: >- Hard requirement, kept separate from skills: holding a job title implies its competencies, but never implies a language. target_company_profile: type: object properties: sector: type: string employee_range: type: array items: type: number minItems: 2 maxItems: 2 pe_backed_preferred: type: boolean rubric_weights: type: object description: >- Relative emphasis per scoring dimension, compiled from what this brief stresses and locked to the run. The scorer clamps and renormalizes. properties: title: type: number years: type: number skills: type: number geo: type: number industry: type: number seniority: type: number AppError: type: object description: >- The error shape used by every `/api` endpoint. Flatter than the `/v1` shape, and `code` appears only where the UI branches on it. properties: error: type: string code: type: string examples: - search_unavailable responses: AppBadRequest: description: Missing or invalid input. content: application/json: schema: $ref: '#/components/schemas/AppError' examples: missing: value: error: criteria (CriteriaV2) is required AppUnauthorized: description: >- Not signed in, no active workspace, or the account lacks the role this action needs. A frozen account gets `403` with code `frozen`. content: application/json: schema: $ref: '#/components/schemas/AppError' examples: signIn: value: error: Sign in required AppProviderUnavailable: description: >- A capability this action needs is not connected for the workspace. The `code` names which one. content: application/json: schema: $ref: '#/components/schemas/AppError' examples: search: value: error: Search is unavailable for this workspace. code: search_unavailable scoring: value: error: AI scoring is unavailable for this workspace. code: ai_scoring_unavailable heyreach: value: error: No HeyReach API key configured — add one in Credentials. code: heyreach_not_configured AppUpstreamError: description: A downstream service or the database failed. content: application/json: schema: $ref: '#/components/schemas/AppError' examples: upstream: value: error: Spec extraction failed securitySchemes: bearerAuth: type: http scheme: bearer description: >- A Revcenter API key: `Authorization: Bearer rvc_live_...`. Keys are scoped, rate limited per key, and metered per workspace. sessionCookie: type: apiKey in: cookie name: session description: >- A signed-in workspace session, sent as a browser cookie. Requests must include credentials, and act on the session's active workspace. ````