---
title: "Agent Parse Job"
method: POST
path: "/api/v1/agent/parse-job"
tags: ["Agent 专用"]
---

# Agent Parse Job

`POST /api/v1/agent/parse-job`

## Request

- Base URL: `https://api.hipowork.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.hipowork.com/api/v1/agent/parse-job`
- Auth: OAuth 2 (password, token URL `/api/v1/auth/oauth/token`)

将自然语言岗位描述解析为结构化检索条件（供 Agent 后续调用 match-candidates 或发布岗位）

## Request body

- ParseJobRequest: 自然语言岗位描述 → 结构化条件
  - `raw_text` string
  - `title` string, nullable
  - `required` object[], nullable
  - `preferred` object, nullable
  - `salary_min` integer, nullable
  - `salary_max` integer, nullable
  - `salary_unit` string, nullable
  - `salary_currency` string, nullable
  - `benefits` string[], nullable

## Response `200`

Successful Response

- ParseJobResponse
  - `code` string
  - `location` string, nullable, required
  - `required` object[], required
  - `preferred` object, required
  - `salary_min` integer, nullable, required
  - `salary_max` integer, nullable, required
  - `salary_unit` string, nullable, required
  - `salary_currency` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/hipowork/apis/hipo-work-ai-recruitment-platform.md) · [All operations](https://skmtc.dev/hipowork/apis/hipo-work-ai-recruitment-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/hipowork/apis/hipo-work-ai-recruitment-platform/revisions/de21a6c57062?raw)