Skip to main content
GET
Get a worker
Returns one worker seat by id: name, type (EMPLOYEE, CONTRACTOR or AGENT), status, person ID, current position and its team and department. It never returns the owner’s email, metadata, agent configuration, budget or spend. Requires workforce:read at the platform scope; a key or app whose grant covers only some org units receives 403. A worker with any current or upcoming assignment in a customer organization or an org unit under one, and every other seat of that worker’s person, returns 404, exactly as a missing worker.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

workerId
string
required
Minimum string length: 1

Response

Success

data
object
required
meta
object
required