Read roles
readJobRead the company's roles. list: optional lifecycle. Every role with its jobId, position, lifecycle, workplaceType, isComplete. Call it whenever the user names a role or asks how many jobs they have; only open roles accept intro requests. Candidate counts per role come from listPipeline. Refer to roles by position, never show the id. get: jobId. A role's full state: basic fields incl. example profiles (goodFitLinkedinUrls), sourcing brief, active requirements, interview stages, locations with ids, job memory. Read before any edit, especially before set_brief, set_stages or set_requirements. list_questions: jobId. The role's screening questions with ids, text, explanation, type, priority, optional and hidden flags. list_locations: jobId. Current locations with ids. get, list_questions and list_locations need a jobId from list.
Clera privately records this tool's inputs and results for usage tracking and support.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"command": "<command>"
},
"name": "readJob"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobId | No | Every command except list and create (required): the job's UUID. Resolve it with list. | |
| orgId | No | Organization to act as. Only needed when you belong to more than one organization. | |
| command | Yes | Which operation to run: list | get | list_questions | list_locations. The tool description explains each. | |
| lifecycle | No | list (optional): only roles in this lifecycle. create (optional, default draft): set 'open' when the role details are ready for sourcing. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | ||
| jobs | No | ||
| brief | No | ||
| jobId | No | ||
| stages | No | ||
| command | Yes | ||
| entries | No | ||
| message | Yes | ||
| diffBlock | No | ||
| locations | No | ||
| questions | No | ||
| stageCount | No | ||
| requirements | No | ||
| assignedRoles | No | ||
| fieldsUpdated | No | ||
| alreadyExisted | No |