# Search companies' job boards for a drafting run's ticked Targets

Moves a drafting run with at least one ticked Target to searching and starts a search of the public ATS job boards (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Workable and more) of every company in Hiresweep's directory for the ticked Targets, under the run's filters. LinkedIn and Indeed are never searched. Returns once the search has started; jobs arrive as Matches while it runs. Only one search per resume runs at a time. Holds one discoveries credit, spent only if the search finds a job; refused with DISCOVERY_LIMIT_REACHED (the reason and when it refills) when the plan has none left, today's cap is reached, or too many searches run at once. Requires authentication.

```http
POST https://hiresweep.com/api/openapi/discovery/runs/{id}/search
x-api-key: YOUR_API_KEY
```

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | Yes |  |

## Request body

```json
{
  "type": "object",
  "properties": {
    "clientId": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "description": "The client whose data this is, for an operator applying on behalf of clients. Omit for your own."
    }
  }
}
```

## Responses

- `200`: The run, now searching (or failed, with the reason, when the search could not start).
- `402`: 402