API
Workforces
Botyard REST API endpoints for workforces.
30 endpoints in this group. Every request authenticates with an API key; see the API reference for the other groups.
- List Workforces:
GET /v1/orgs/{org_id}/workforces - Create Workforce:
POST /v1/orgs/{org_id}/workforces - Get Workforce Task Counts:
GET /v1/orgs/{org_id}/workforces/task-counts - Get Workforce:
GET /v1/orgs/{org_id}/workforces/{workforce_slug} - Update Workforce:
PATCH /v1/orgs/{org_id}/workforces/{workforce_slug} - Delete Workforce:
DELETE /v1/orgs/{org_id}/workforces/{workforce_slug} - List Workforce Views:
GET /v1/orgs/{org_id}/workforces/{workforce_slug}/views - Create Workforce View:
POST /v1/orgs/{org_id}/workforces/{workforce_slug}/views - Update Workforce View:
PATCH /v1/orgs/{org_id}/workforces/{workforce_slug}/views/{view_id} - Delete Workforce View:
DELETE /v1/orgs/{org_id}/workforces/{workforce_slug}/views/{view_id} - List Workforce Members:
GET /v1/orgs/{org_id}/workforces/{workforce_slug}/members - Add Workforce Members:
POST /v1/orgs/{org_id}/workforces/{workforce_slug}/members - Set Workforce Members:
PUT /v1/orgs/{org_id}/workforces/{workforce_slug}/members - Remove Workforce Members:
POST /v1/orgs/{org_id}/workforces/{workforce_slug}/members/delete - Set Workforce Access:
PUT /v1/orgs/{org_id}/workforces/{workforce_slug}/access - List Workforce Bots:
GET /v1/orgs/{org_id}/workforces/{workforce_slug}/bots - Add Bot To Workforce:
POST /v1/orgs/{org_id}/workforces/{workforce_slug}/bots/{bot_id} - Remove Bot From Workforce:
DELETE /v1/orgs/{org_id}/workforces/{workforce_slug}/bots/{bot_id} - List Tasks:
GET /v1/orgs/{org_id}/workforces/{workforce_slug}/tasks - Create Task:
POST /v1/orgs/{org_id}/workforces/{workforce_slug}/tasks - Search Tasks:
POST /v1/orgs/{org_id}/workforces/{workforce_slug}/tasks/search - List Task Tags:
GET /v1/orgs/{org_id}/workforces/{workforce_slug}/tasks/tags - Reassign Column Tasks:
POST /v1/orgs/{org_id}/workforces/{workforce_slug}/columns/{column_id}/reassign-tasks - Get Task By Number:
GET /v1/orgs/{org_id}/workforces/{workforce_slug}/tasks/by-number/{task_number} - Get Task:
GET /v1/orgs/{org_id}/workforces/{workforce_slug}/tasks/{task_id} - Update Task:
PATCH /v1/orgs/{org_id}/workforces/{workforce_slug}/tasks/{task_id} - Delete Task:
DELETE /v1/orgs/{org_id}/workforces/{workforce_slug}/tasks/{task_id} - Create Task Links:
POST /v1/orgs/{org_id}/workforces/{workforce_slug}/tasks/{task_number}/links - Delete Task Links:
POST /v1/orgs/{org_id}/workforces/{workforce_slug}/tasks/{task_number}/links/delete - List Bot Workforces:
GET /v1/orgs/{org_id}/bots/{bot_id}/workforces
Update Task File
Update file metadata (rename/move, or content hash after re-upload).
List Workforces
List the workforces in an organization the caller may view. One query, narrowed by the board listing rule (epic #4482 U2b): every ``open`` board, plus the restricted boards the caller is a member of, or every board for a holder of ``workforce:board.manage``. Users, bots and API keys get the same answer for the same authority — the bot-only filter of #3443 is subsumed (and, for open boards, deliberately widened: decision D8).