Workboard Create Objective Tool
workboard_create_objective_toolCreate Team or Individual objectives with owners, dates, and optional key results and targets. Use it to set up new OKRs in WorkBoard, since objectives cannot be updated or deleted later via API.
Instructions
Create a new objective with optional key results.
Creates Team or Individual objectives. The API has no update or delete for objectives — those are UI-only, so a name or date that is wrong at creation stays wrong until someone fixes it in the web UI.
This used to say Data-Admin was required and that instant JWT tokens cannot
create objectives. That is wrong: an instant token carrying
isSuperUser: false creates objectives and checks in progress against
their key results. Data-Admin does gate other calls, scope="org" on
workboard_list_users_tool among them, so do not generalise from that to
every write; test the specific call instead of assuming either way.
Team objectives must be tied to a team: pass team (a team ID from
workboard_get_teams_tool). Provide the objective name, owner, dates, and
optionally key results with targets. Each key result has a name and optional
start_value, target_value, and unit_type (e.g. "Number", "Currency", "Percent").
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": {
"name": "<name>",
"owner": "<owner>",
"start_date": "<start_date>",
"target_date": "<target_date>"
},
"name": "workboard_create_objective_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Objective name (e.g. "Increase customer retention") | |
| team | No | Team ID (or name) — required for team objectives, ignored for individual | |
| owner | Yes | Owner's email address or user ID | |
| narrative | No | Optional description/narrative for the objective | |
| permission | No | Visibility, comma-separated. Team objectives accept team/report/internal/any; personal objectives accept owner/manager. Defaults by type when omitted (team → "internal,team", individual → "owner"). | |
| start_date | Yes | Start date in YYYY-MM-DD format | |
| key_results | No | Optional list of key results, each with a name and optional start_value, target_value, and unit_type | |
| target_date | Yes | Target completion date in YYYY-MM-DD format | |
| objective_type | No | "team" (default) or "individual" | team |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||