About bitrix24-tasks
A server-side task guide for Bitrix24 on-premise developers, covering task reads and writes, members, deadlines, checklists, and access. It emphasizes V2 commands for writes and checking the acting user’s permissions before execution.
Key features
- 01Task creation, update, and deletion guidance
- 02Task list filtering and pagination
- 03Member, deadline, and checklist handling
- 04Access rights and event guidance
- 05V2 commands and fallback approach
Use cases
- 01Create or update tasks in an on-premise portal
- 02Query and filter task lists
- 03Set task members, deadlines, and tags
- 04Check user permissions before write operations
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ bxmaximum/ bitrix-framework-skills --skill bitrix24-tasksAfter installing, type/bitrix24-tasksin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
rules/access-events.mddetails.mdreading.mdwriting.mdDetails
From the project READMEBitrix24 tasks (server side)
Scope: Bitrix24 on-premise · Verified: tasks 26.300.100, main 26.800.0
| Task | Read |
|---|---|
| Pick the API layer; create, update, complete, delete; errors | rules/writing.md |
| One task or lists: filters, sort, paging, dates | rules/reading.md |
| Members, deadlines and time zones, checklists, tags, projects, templates, comments | rules/details.md |
| Access actions, events and their arguments, REST mapping | rules/access-events.md |
Invariants
- Write through the V2 commands (
AddTaskCommand,UpdateTaskCommand…; legacyCTaskItem/CTasksend in the same V2 services). Never writeTaskTableor member/checklist tables: counters, chat, search, events and recycle bin are skipped. - Commands do not check rights. Check
TaskAccessService/TaskAccessControllerfor the acting user beforerun(). - Pass the acting user id explicitly (
userIdin configs). Agents and CLI have no$USER;CTasks::AddwithoutUSER_IDacts as user 1. - Dates in V2 entities are Unix timestamps (
deadlineTs). Never pass site-format strings from background code. - Keep V2 calls in one
/localgateway class: commands takeV2\Internal\…entities and configs that may change between releases. The V2 layer is verified in tasks 26.300.100 only; ifclass_exists(AddTaskCommand::class)is false, useCTaskItem. - New task card: comments are messages in the task chat (see
rules/details.md,bitrix24-im).
Comments
Markdown supported