A company's first hire in each function

The earliest first-in-function event per function -- detects a new budget line. Sourced from the role-slot recompute aggregate, not a specific board posting; source_board says so honestly rather than being excluded outright. Free-tier reads are history-capped.

An unresolvable function -- anything that is not a function taxonomy id -- is rejected with 422 instead of returning a silently-empty result.

Requires the read scope.

get/v1/companies/{company_id}/first-hire

Request

  • Base URL: https://api.reqbeat.com
  • URL: https://api.reqbeat.com/v1/companies/{company_id}/first-hire
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

company_idinteger required

The plane's company id -- returned as company_id by /v1/reqs/search and by every company motion response.

Query parameters

functionstring nullable

Function whose first hire to look for: its name, e.g. 'Sales & Customer Service', or its taxonomy id, e.g. '3571b52b-ac60-58f9-b769-9affa0174f93'. Ids are the by_function keys this endpoint returns. A name covers every id it leads; an id matches that one id. Anything else is rejected with 422, which lists the names.

Headers

Idempotency-Keystring nullable

Response

Successful Response

by_functionobject required
as_ofstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.