---
title: "Create Post"
method: POST
path: "/api/v1/community/posts"
tags: ["community"]
---

# Create Post

`POST /api/v1/community/posts`

## 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/community/posts`
- Auth: OAuth 2 (password, token URL `/api/v1/auth/oauth/token`)

发帖。已上传简历的候选人可发，可附带自己的名片。

正文里可以内嵌自己的名片（发帖框输入 #个人名片 选中后插入 [[card:token]]）。
为防止冒用他人身份，此处把不属于自己的 token 从正文中剔除，
而不是直接报错——用户可能从别处粘贴了含标记的文本，报错会让人莫名其妙。

## Request body

- PostCreate
  - `content` string, required
  - `topic` string, nullable
  - `images` string[], nullable
  - `include_card` boolean
  - `task_title` string, nullable
  - `bounty_per_winner` number, nullable: 悬赏贝壳数量，最低 1 贝壳，最大不限，支持 8 位小数
  - `max_winners` integer, nullable: 最大获奖名额，默认 1 人
  - `completion_guide` string, nullable: 完成说明/交付标准
  - `completion_guide_images` string[], nullable: 完成说明参考配图

## Response `201`

Successful Response

- unknown

## 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)