List positions
Positions you can see, with department, location, status and hiring team.
GET https://cotlet.dev/api/v1/comeet/positions
read
Lists the positions your account can see, 30 to a page; pass next_cursor back as cursor for the next page. status picks open, on_hold or closed positions. Each position carries its department, location, hiring manager and lead recruiter. Use position_id in the other tools.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | open (default), on_hold, closed or all. |
| department string | string | Only positions of this department. |
| limit integer | integer | 1 to 30. Default: 30. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/comeet/positions \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("comeet", "list_positions")const result = await cotlet.call('comeet', 'list_positions');cotlet call comeet list_positionsExample response
{
"positions": [
{
"position_id": "pos_21c4",
"name": "Senior Product Designer",
"department": "Design",
"location": "Remote, EU",
"status": "open",
"hiring_manager": "Dana Cho",
"lead_recruiter": "Ravi Shah"
},
{
"position_id": "pos_21d9",
"name": "Backend Engineer",
"department": "Engineering",
"location": "Berlin",
"status": "open",
"hiring_manager": "Leo Park",
"lead_recruiter": "Ravi Shah"
}
],
"next_cursor": null
}