Get position
One position with its workflow steps, hiring team and openings.
GET https://cotlet.dev/api/v1/comeet/positions/{position_id}
read
Returns the position details, its workflow in order with each step type (go_no_go, interview, administrative, offer, send_notification), the hiring team with position roles, and the openings with their status. A candidate cannot be marked hired unless an opening is open. Positions you cannot see return APP_PERMISSION_DENIED.
Parameters
| Name | Type | Description |
|---|---|---|
| position_id string required | string | Position from list_positions. |
Request
curl https://cotlet.dev/api/v1/comeet/positions/position_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("comeet", "get_position", {"position_id":"position_8c41d2"})const result = await cotlet.call('comeet', 'get_position', {"position_id":"position_8c41d2"});cotlet call comeet get_position --data '{"position_id":"position_8c41d2"}'Example response
{
"position_id": "pos_21c4",
"name": "Senior Product Designer",
"status": "open",
"workflow": [
{
"step": "Application review",
"type": "administrative"
},
{
"step": "Hiring manager screen",
"type": "go_no_go"
},
{
"step": "Interview with hiring manager",
"type": "interview"
}
],
"hiring_team": [
{
"name": "Dana Cho",
"role": "hiring_manager"
},
{
"name": "Ravi Shah",
"role": "recruiter"
}
],
"openings": [
{
"status": "open"
}
]
}