Leadline DocsToolsPositions
searchPositionsTiny
Generated from the Rover tool catalog. Do not edit by hand.
Read. This tool reads Leadline data and does not change it.
Lightweight position search (id, title, status). Use for title or id lookup, including published jobs. Pass published: 1 for published or live jobs and published: 0 for drafts or unpublished. Pass active: 1 for open hiring and 0 for closed. Pass archived: 1 only when the user asked for archived positions. The first call must include the status the user named. Default limit is 20 — do not set limit to 100 to scan the catalog. Omit workflowId unless the user named a workflow (never send 0). Do not send empty query strings.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | no | Free-text search on title/fields |
| ids | array | no | Filter by Leadline position entity ids |
| positionsIds | array | no | Filter by position UUIDs |
| active | 0 | 1 | no | 0 = closed, 1 = open |
| published | 0 | 1 | no | 0 = unpublished, 1 = published |
| archived | 0 | 1 | no | 0 = not archived (default), 1 = archived |
| workflowId | unknown | no | Filter by hiring workflow id; omit unless the user named a workflow |
| skip | integer | no | Pagination offset (default 0) |
| limit | integer | no | Page size (default 20) |