지원자 태그

태그 목록 조회

GET https://api.roundhr.com/v1/candidates/{candidate_code}/tags

지원자에게 부여된 태그 목록을 반환합니다.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Path Parameters

Name	Type	필수	Description
candidate_code	string	required	지원자 고유 코드

응답 예제

200

[
   {
      "id": 1,
      "name": "핵심인재",
      "created_at": "2024-09-02T18:56:37+09:00",
      "updated_at": "2024-09-02T18:56:37+09:00"
   },
   {
      "id": 2,
      "name": "경력3년이상",
      "created_at": "2024-09-03T10:30:00+09:00",
      "updated_at": "2024-09-03T10:30:00+09:00"
   }
]

---

태그 추가

POST https://api.roundhr.com/v1/candidates/{candidate_code}/tags

지원자에게 태그를 추가합니다. 존재하지 않는 태그명인 경우 새로 생성됩니다.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Path Parameters

Name	Type	필수	Description
candidate_code	string	required	지원자 고유 코드

Body Parameters

Name	Type	필수	Description
name	string	required	태그명 (공백은 자동으로 제거됩니다)

요청 예제

{
   "name": "핵심인재"
}

응답 예제

200

{
   "id": 1,
   "name": "핵심인재",
   "created_at": "2024-09-02T18:56:37+09:00",
   "updated_at": "2024-09-02T18:56:37+09:00"
}

---

태그 삭제

DELETE https://api.roundhr.com/v1/candidates/{candidate_code}/tags/{id}

지원자에게서 태그를 제거합니다. 해당 태그가 다른 지원자에게도 사용되지 않는 경우 태그 자체가 삭제됩니다.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Path Parameters

Name	Type	필수	Description
candidate_code	string	required	지원자 고유 코드
id	integer	required	태그 ID

응답 예제

200

{}

404

---

응답 필드 설명

Field	Type	Description
id	integer	태그 고유 ID
name	string	태그명
created_at	string	생성 일시
updated_at	string	수정 일시