# plnnrly > plnnrly is your whole agency in one system: projects, work items, time tracking, planning, leave, billing and reporting. This file indexes the developer documentation: the MCP server for AI assistants and the REST API v2. The REST API lives on your organisation's own address, `https:///api/v2`. `` is the host you sign in to plnnrly on, such as `acme.plnnrly.com`, or your organisation's own domain if it has one. There is no shared API host. Send `Authorization: Bearer ` with a personal access token, or with an access token your app got through OAuth sign-in (authorization code with PKCE). `Accept` is optional, and the API answers in JSON. A token holds abilities such as `api:read:projects`, and the user behind it still needs each operation's permission. Both are listed per operation below. The MCP server is at `https:///mcp/v1` (streamable HTTP). AI assistants connect by signing in, and through three general tools (`search_api`, `api_read`, `api_write`) they reach every REST API operation except file uploads. Machine-readable forms of this documentation: - `https://developers.plnnrly.com/openapi.json`: the OpenAPI 3.1 document (5.2 MB), the authority for every shape. - `https://developers.plnnrly.com/llms-full.txt`: every API guide, operation and schema page as Markdown, in one file. - `https://developers.plnnrly.com/md/api/v2/.md`: one operation as Markdown, such as `/md/api/v2/work-items/update.md`. - `https://developers.plnnrly.com/md//docs/.md`: any other documentation page as Markdown, such as `/md/en/docs/mcp.md`. ## Documentation - [Start here](https://developers.plnnrly.com/en/docs/): Connect an AI assistant to plnnrly over MCP, or build your own integration on the REST API. - [For administrators](https://developers.plnnrly.com/en/docs/administration/): Switch MCP and the REST API on or off for your organisation, and decide who may create API tokens and connect apps. - [MCP](https://developers.plnnrly.com/en/docs/mcp/): Connect AI assistants to your plnnrly organisation. - Connect a client: Step-by-step guides for adding plnnrly to an AI client. - [claude.ai](https://developers.plnnrly.com/en/docs/mcp/install/claude-ai/): Add plnnrly to Claude on the web as a custom connector and sign in once, without a token. - [Claude Desktop](https://developers.plnnrly.com/en/docs/mcp/install/claude-desktop/): Add plnnrly to the Claude Desktop app as a custom connector and sign in once, without a token. - [Claude Code](https://developers.plnnrly.com/en/docs/mcp/install/claude-code/): Add plnnrly to Claude Code with one command and sign in from your browser, without a token. - [ChatGPT](https://developers.plnnrly.com/en/docs/mcp/install/chatgpt/): Add plnnrly to ChatGPT as a custom MCP server plugin and sign in once, without a token. - [Cursor](https://developers.plnnrly.com/en/docs/mcp/install/cursor/): Add plnnrly to the Cursor desktop app and sign in from your browser, without a token. - [Gemini CLI](https://developers.plnnrly.com/en/docs/mcp/install/gemini/): Add plnnrly to Google's Gemini CLI with one command and sign in from your browser, without a token. - [Other clients](https://developers.plnnrly.com/en/docs/mcp/install/other-clients/): What an AI client needs to connect to plnnrly, the settings to use, and which clients cannot sign in yet. - [What you can ask](https://developers.plnnrly.com/en/docs/mcp/examples/): Example questions for an AI assistant connected to plnnrly, per area, with the REST API operation each one uses. - [Tools](https://developers.plnnrly.com/en/docs/mcp/tools/): The four tools of the plnnrly MCP server, what each one accepts and returns, and the limits that apply. - [Permissions and safety](https://developers.plnnrly.com/en/docs/mcp/permissions-and-safety/): What an AI assistant connected to plnnrly can and cannot do, the two locks on deleting, and how to stop its access. - [Troubleshooting](https://developers.plnnrly.com/en/docs/mcp/troubleshooting/): What to do when an AI client cannot connect to plnnrly, cannot sign in, or has a request refused. - [REST API](https://developers.plnnrly.com/en/docs/api/): Read and change your plnnrly data from your own code, with a personal token or OAuth sign-in. - [Reference](https://developers.plnnrly.com/en/docs/api/v2/): Version 2 of the REST API, with its guides, every operation and every schema. - [Guides](https://developers.plnnrly.com/en/docs/api/v2/guides/): How the REST API behaves across every operation, written once. - [Getting started](https://developers.plnnrly.com/en/docs/api/v2/guides/getting-started/): Create a token, find your address, then make your first reads and your first write, one step at a time. - [Authentication](https://developers.plnnrly.com/en/docs/api/v2/guides/authentication/): Every request carries a bearer token, sent to your organisation's own address and acting as one user. Here is how it works and how it fails. - [Sign in with OAuth](https://developers.plnnrly.com/en/docs/api/v2/guides/oauth-apps/): Let people sign in to your desktop or command-line app with their plnnrly account, instead of pasting a token. OAuth 2.0 with PKCE, step by step. - [API tokens](https://developers.plnnrly.com/en/docs/api/v2/guides/tokens/): Create the personal access tokens your scripts and integrations use, narrow them to what they need, and roll or revoke them in time. - [Scopes and permissions](https://developers.plnnrly.com/en/docs/api/v2/guides/scopes/): Every operation needs a token scope and a permission on the user's role. How both are built, what each covers and which one to fix when a call is refused. - [How the data fits together](https://developers.plnnrly.com/en/docs/api/v2/guides/data-model/): A map of the resources behind the API, how they relate, and which areas exist only when your organisation has them. - [Data formats](https://developers.plnnrly.com/en/docs/api/v2/guides/data-formats/): How the API writes dates, times, durations, money, ids, enums and empty values, and the forms it accepts back. - [Pagination](https://developers.plnnrly.com/en/docs/api/v2/guides/pagination/): Cursor paging by default, page numbers on collections that count their rows, page sizes, totals, and how to walk a whole collection. - [Filtering and sorting](https://developers.plnnrly.com/en/docs/api/v2/guides/filtering-and-sorting/): Narrow a collection with bracket filters and operators, search it with q, order it with sort, and read soft-deleted rows. - [Views and includes](https://developers.plnnrly.com/en/docs/api/v2/guides/views-and-includes/): Choose a field set with view, inline related records and on-demand fields with include, and read meta.actions and warnings. - [Concurrency and ETags](https://developers.plnnrly.com/en/docs/api/v2/guides/concurrency-and-etags/): Use ETags to skip re-reading data that has not changed, and to stop a write from overwriting a change you have not seen. - [Idempotency](https://developers.plnnrly.com/en/docs/api/v2/guides/idempotency/): Send an Idempotency-Key with a POST, so that a retry after a lost response returns the first result instead of writing twice. - [Actions and state changes](https://developers.plnnrly.com/en/docs/api/v2/guides/actions/): How the action endpoints work, which ones you may call on a record, how to make them safe to retry, and what each outcome means. - [Deleting and restoring](https://developers.plnnrly.com/en/docs/api/v2/guides/deleting-and-restoring/): What a DELETE does to each resource, how to read and restore archived records, what can block a delete and who may delete. - [Files: upload and download](https://developers.plnnrly.com/en/docs/api/v2/guides/uploads/): Attach a file to a work item or a Drive item in three steps, and download attached files through a signed link. - [Rate limits](https://developers.plnnrly.com/en/docs/api/v2/guides/rate-limits/): What each request costs, the ceilings per token and per organisation, and the headers that tell you how much budget is left. - [Errors and retries](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/): Every failure is a problem document. Switch on the problem type, never on the status code alone, and retry only what is safe to retry. - [Limits at a glance](https://developers.plnnrly.com/en/docs/api/v2/guides/limits/): Every numeric limit of the REST API and the MCP server in one place, with a link to the guide that explains each one. - [Keeping a copy in sync](https://developers.plnnrly.com/en/docs/api/v2/guides/syncing-data/): plnnrly has no webhooks. Poll each collection from a high-water mark on updated_at, re-check cheaply, and catch deleted records. - [Headers and versioning](https://developers.plnnrly.com/en/docs/api/v2/guides/headers-and-versioning/): The request headers you may send, the response headers you get back, and how the API changes within v2. - [What the API cannot do](https://developers.plnnrly.com/en/docs/api/v2/guides/known-limitations/): The things the REST API does not offer today, each with the page that explains it or the way around it. - [Generating a client](https://developers.plnnrly.com/en/docs/api/v2/guides/client-generation/): Generate a client or import the API into an API tool from /openapi.json, and avoid the traps that break generated clients. - [Recipes](https://developers.plnnrly.com/en/docs/api/v2/guides/recipes/): Worked examples that combine several requests into one task. - [Log time from a script](https://developers.plnnrly.com/en/docs/api/v2/guides/recipes/log-time/): Book hours against a project from your own code, check the week, correct an entry and use timers, with retries that never book anything twice. - [Move work items through the workflow](https://developers.plnnrly.com/en/docs/api/v2/guides/recipes/work-item-workflow/): Read a work item by its key, find the statuses it can move to, change its status, place it on the board and leave a comment. - [Schemas](https://developers.plnnrly.com/en/docs/api/v2/schemas/): Every resource object, and the shared collection envelope and error documents. - Shared - [Problems](https://developers.plnnrly.com/en/docs/api/v2/schemas/problems/): Every error document /api/v2 returns, with its type URI, its extra members and a real example. - [Pagination](https://developers.plnnrly.com/en/docs/api/v2/schemas/pagination/): The envelope, the page and link shapes, the advisory warnings and the shared Ref. - Resources - [Absence](https://developers.plnnrly.com/en/docs/api/v2/schemas/absence/): An absence: the period an employee was away from work, booked for them by HR. - [Budget](https://developers.plnnrly.com/en/docs/api/v2/schemas/budget/): A budget: a named pot of minutes on a project that tasks are filed under and time is logged against, optionally filed in an organisation-wide budget group. - [BudgetGroup](https://developers.plnnrly.com/en/docs/api/v2/schemas/budget-group/): A budget group: the organisation-wide category budgets are filed under, carrying the icon plnnrly shows beside them. - [Checkin](https://developers.plnnrly.com/en/docs/api/v2/schemas/checkin/): A checkin: one attendance record for one employee, opened when they clock in and closed when they clock out. - [Comment](https://developers.plnnrly.com/en/docs/api/v2/schemas/comment/): A comment on a work item or on a drive item: the rich-text body one user posted to a thread, with its author and its timestamps. - [CompanyBranch](https://developers.plnnrly.com/en/docs/api/v2/schemas/company-branch/): A company branch: one of the organisation's own locations, used to group the customers a branch is responsible for. - [Contact](https://developers.plnnrly.com/en/docs/api/v2/schemas/contact/): A contact person: either a customer's contact (the CRM address book) or an employee's emergency contact, distinguished by `contactable_type`. - [ContactRole](https://developers.plnnrly.com/en/docs/api/v2/schemas/contact-role/): A contact role: the organisation-wide list a contact's function is picked from, e.g. - [Customer](https://developers.plnnrly.com/en/docs/api/v2/schemas/customer/): A customer: the CRM record every project, contact, subscription and sales invoice hangs off. - [CustomerCategory](https://developers.plnnrly.com/en/docs/api/v2/schemas/customer-category/): A customer category: the hand-maintained taxonomy customers are grouped by, used for segmentation and reporting. - [CustomerSubscription](https://developers.plnnrly.com/en/docs/api/v2/schemas/customer-subscription/): A recurring agreement with one customer: what it covers, the interval it is billed at, when it started and when it is next invoiced. - [DiscoveryEntry](https://developers.plnnrly.com/en/docs/api/v2/schemas/discovery-entry/): One resource this API exposes: where it lives, what it is called in the permission system, which schemas describe it and which operations it registers. - [DriveDocument](https://developers.plnnrly.com/en/docs/api/v2/schemas/drive-document/): The body of a drive item of kind `document`: the rich-editor content plnnrly opens when you click a document in the file browser. - [DriveFolder](https://developers.plnnrly.com/en/docs/api/v2/schemas/drive-folder/): A folder in a drive: the tree plnnrly's file browser draws under a project, a customer, the organisation drive or a user's personal drive. - [DriveItem](https://developers.plnnrly.com/en/docs/api/v2/schemas/drive-item/): A file or document in a drive: the rows plnnrly's file browser lists under a project, a customer, the organisation drive or a user's personal drive. - [Event](https://developers.plnnrly.com/en/docs/api/v2/schemas/event/): A planning event: one block on a user's agenda, optionally linked to a kanban task so time can be logged against it. - [FreeDay](https://developers.plnnrly.com/en/docs/api/v2/schemas/free-day/): A free day: one calendar date on which the organisation is closed, either instantiated from a recurring holiday or added by hand. - [FurloughBalanceMutation](https://developers.plnnrly.com/en/docs/api/v2/schemas/furlough-balance-mutation/): A furlough balance mutation: one signed ledger entry against an employee's leave balance for a `year` and a leave `type`. - [Holiday](https://developers.plnnrly.com/en/docs/api/v2/schemas/holiday/): A holiday: a recurring named day off, such as Nieuwjaarsdag. - [Invoice](https://developers.plnnrly.com/en/docs/api/v2/schemas/invoice/): A legacy invoice header: the description, date and hourly rate a project was billed at before sales invoices replaced it. - [Label](https://developers.plnnrly.com/en/docs/api/v2/schemas/label/): A label: a per-project tag work items are marked with, carrying the colour and the optional icon the backlog chips and the work item detail view show beside its name. - [Media](https://developers.plnnrly.com/en/docs/api/v2/schemas/media/): A file attached to a record: the metadata of one upload (its name, type, size and the collection it belongs to) plus an on-demand signed download URL. - [Note](https://developers.plnnrly.com/en/docs/api/v2/schemas/note/): A free-text note attached to a project, a customer or a work item: the running commentary plnnrly shows in a record's Notes sub-page. - [Project](https://developers.plnnrly.com/en/docs/api/v2/schemas/project/): A project: the unit customers are billed against. - [ProjectLink](https://developers.plnnrly.com/en/docs/api/v2/schemas/project-link/): A named external URL pinned to a project, such as a staging environment, a design file or a repository. - [SalesInvoice](https://developers.plnnrly.com/en/docs/api/v2/schemas/sales-invoice/): A sales invoice header: what a customer is billed, when it is due, and how far it has got through the accounting sync. - [SalesInvoiceRow](https://developers.plnnrly.com/en/docs/api/v2/schemas/sales-invoice-row/): One line on a sales invoice: a label, a quantity, a unit price and a VAT percentage. - [Sprint](https://developers.plnnrly.com/en/docs/api/v2/schemas/sprint/): A sprint: a time-boxed slice of a project's backlog. - [SubscriptionItem](https://developers.plnnrly.com/en/docs/api/v2/schemas/subscription-item/): One line on a customer subscription: what is being sold, how many, at what purchase and sales price, and at what VAT percentage. - [SubscriptionProduct](https://developers.plnnrly.com/en/docs/api/v2/schemas/subscription-product/): A sellable subscription product: the organisation's hand-maintained catalogue of what a customer subscription or a subscription type can bill for. - [SubscriptionType](https://developers.plnnrly.com/en/docs/api/v2/schemas/subscription-type/): A subscription type: the organisation's hand-maintained template a customer subscription is instanced from, carrying the default billing interval and renewal behaviour new subscriptions start with. - [SubscriptionTypeItem](https://developers.plnnrly.com/en/docs/api/v2/schemas/subscription-type-item/): One template line on a subscription type: what is sold, how many, at what purchase and sales price, and at what VAT percentage. - [Subtask](https://developers.plnnrly.com/en/docs/api/v2/schemas/subtask/): A checklist subtask on a work item: a title, an optional rich-text note and a ticked-off flag, held in the work item's own checklist order. - [Task](https://developers.plnnrly.com/en/docs/api/v2/schemas/task/): A kanban task: one card on an employee's board, filed under a budget of a project, carrying an estimate in minutes that time is logged against. - [Time](https://developers.plnnrly.com/en/docs/api/v2/schemas/time/): A worklog: minutes of work booked by one employee against one project on one calendar day, optionally attached to a task and a work item. - [Timer](https://developers.plnnrly.com/en/docs/api/v2/schemas/timer/): A running stopwatch: one row per employee per timed record, created when the timer starts and deleted when it is discarded or its minutes are booked. - [Upload](https://developers.plnnrly.com/en/docs/api/v2/schemas/upload/): An upload ticket: the server's permission for you to place one file's bytes in storage, and the record of what arrived. - [User](https://developers.plnnrly.com/en/docs/api/v2/schemas/user/): A user: one member of the organisation, as plnnrly's people list shows them. - [UserTodo](https://developers.plnnrly.com/en/docs/api/v2/schemas/user-todo/): A todo: one unchecked task-list line in a drive document that mentions you. - [WorkItem](https://developers.plnnrly.com/en/docs/api/v2/schemas/work-item/): A work item: the unit of work a project's backlog and board are made of, addressed by numeric id or by its human-readable issue key (ACM-123) on the same path. - [WorkItemLink](https://developers.plnnrly.com/en/docs/api/v2/schemas/work-item-link/): A directed link between two work items (`blocks`, `duplicates`, `relates_to` and four more), the rows the linked items section in plnnrly is built from. - [WorkType](https://developers.plnnrly.com/en/docs/api/v2/schemas/work-type/): A work-item type: the organisation-wide categories work items are filed under (bug, task, story, …), carrying the colour and icon the backlog, board and Gantt render beside them. - [Workflow](https://developers.plnnrly.com/en/docs/api/v2/schemas/workflow/): A workflow: the named set of statuses a work item moves through, plus the transitions allowed between them. - [WorkflowStatus](https://developers.plnnrly.com/en/docs/api/v2/schemas/workflow-status/): One status in a workflow: the column a work item sits in, with the colour the badge is drawn in and whether reaching it resolves the item. - [WorkflowTransition](https://developers.plnnrly.com/en/docs/api/v2/schemas/workflow-transition/): One legal edge of a workflow: the move a work item may make from one status to another, with the label the transition button carries. - [Changelog](https://developers.plnnrly.com/en/docs/changelog/): What changed in the plnnrly REST API and MCP server in each release, newest first. - [v2.8.0](https://developers.plnnrly.com/en/docs/changelog/v2-8-0/): Desktop and command-line apps sign in with OAuth, /me returns the user a token acts as, work items move to the board or the backlog, and emergency contacts are private to each employee. - [v2.7.3](https://developers.plnnrly.com/en/docs/changelog/v2-7-3/): AI assistants that connected by signing in now get the same access as their user. - [v2.7.2](https://developers.plnnrly.com/en/docs/changelog/v2-7-2/): AI assistants connect by signing in instead of with a token, three general tools reach every REST API operation, and new organisations start with MCP off. - [v2.7.0](https://developers.plnnrly.com/en/docs/changelog/v2-7-0/): The REST API v2 opens with personal API tokens, and administrators can switch the REST API and MCP off. ## API reference v2 ### Start here - [GET /](https://developers.plnnrly.com/en/docs/api/v2/discovery/): List the resources this API exposes. Scope api:read, permission none, cost 1 unit, read bucket. - [GET /me](https://developers.plnnrly.com/en/docs/api/v2/me/get/): Read the token owner. Scope api:read, permission none, cost 1 unit, read bucket. - [GET /uploads/{upload}](https://developers.plnnrly.com/en/docs/api/v2/uploads/get/): Read an upload ticket. Scope api:read:project_management or api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission none, cost 1 unit, read bucket. - [DELETE /uploads/{upload}](https://developers.plnnrly.com/en/docs/api/v2/uploads/delete/): Delete an upload ticket. Scope api:destroy:project_management or api:destroy:project_drive or api:destroy:customer_drive or api:destroy:organization_drive or api:destroy:user_drive, permission none, cost 1 unit, write bucket. ### Projects Projects, budgets and the customers they are billed to. - [GET /projects](https://developers.plnnrly.com/en/docs/api/v2/projects/list/): List projects. Scope api:read:projects, permission projects::read, cost 1 unit, read bucket. - [POST /projects](https://developers.plnnrly.com/en/docs/api/v2/projects/create/): Create a project. Scope api:write:projects, permission projects::create, cost 1 unit, write bucket. - [GET /projects/{project}](https://developers.plnnrly.com/en/docs/api/v2/projects/get/): Read a project. Scope api:read:projects, permission projects::read, cost 1 unit, read bucket. - [PATCH /projects/{project}](https://developers.plnnrly.com/en/docs/api/v2/projects/update/): Update a project. Scope api:write:projects, permission projects::update, cost 1 unit, write bucket. - [DELETE /projects/{project}](https://developers.plnnrly.com/en/docs/api/v2/projects/delete/): Delete a project. Scope api:destroy:projects, permission projects::delete, cost 1 unit, write bucket. - [POST /projects/{project}/actions/restore](https://developers.plnnrly.com/en/docs/api/v2/projects/restore/): Restore a deleted project. Scope api:write:projects, permission projects::create, cost 1 unit, write bucket. - [GET /budget-groups](https://developers.plnnrly.com/en/docs/api/v2/budget-groups/list/): List budget groups. Scope api:read:budget_groups, permission budget_groups::read, cost 1 unit, read bucket. - [POST /budget-groups](https://developers.plnnrly.com/en/docs/api/v2/budget-groups/create/): Create a budget group. Scope api:write:budget_groups, permission budget_groups::create, cost 1 unit, write bucket. - [GET /budget-groups/{budget_group}](https://developers.plnnrly.com/en/docs/api/v2/budget-groups/get/): Read a budget group. Scope api:read:budget_groups, permission budget_groups::read, cost 1 unit, read bucket. - [PATCH /budget-groups/{budget_group}](https://developers.plnnrly.com/en/docs/api/v2/budget-groups/update/): Update a budget group. Scope api:write:budget_groups, permission budget_groups::update, cost 1 unit, write bucket. - [DELETE /budget-groups/{budget_group}](https://developers.plnnrly.com/en/docs/api/v2/budget-groups/delete/): Delete a budget group. Scope api:destroy:budget_groups, permission budget_groups::delete, cost 1 unit, write bucket. - [GET /budgets](https://developers.plnnrly.com/en/docs/api/v2/budgets/list/): List budgets. Scope api:read:budgets, permission budgets::read, cost 1 unit, read bucket. - [POST /budgets](https://developers.plnnrly.com/en/docs/api/v2/budgets/create/): Create a budget. Scope api:write:budgets, permission budgets::create, cost 1 unit, write bucket. - [GET /budgets/{budget}](https://developers.plnnrly.com/en/docs/api/v2/budgets/get/): Read a budget. Scope api:read:budgets, permission budgets::read, cost 1 unit, read bucket. - [PATCH /budgets/{budget}](https://developers.plnnrly.com/en/docs/api/v2/budgets/update/): Update a budget. Scope api:write:budgets, permission budgets::update, cost 1 unit, write bucket. - [DELETE /budgets/{budget}](https://developers.plnnrly.com/en/docs/api/v2/budgets/delete/): Delete a budget. Scope api:destroy:budgets, permission budgets::delete, cost 1 unit, write bucket. - [GET /project-links](https://developers.plnnrly.com/en/docs/api/v2/project-links/list/): List project links. Scope api:read:projects, permission projects::links, cost 1 unit, read bucket. - [POST /project-links](https://developers.plnnrly.com/en/docs/api/v2/project-links/create/): Create a project link. Scope api:write:projects, permission projects::links, cost 1 unit, write bucket. - [GET /project-links/{project_link}](https://developers.plnnrly.com/en/docs/api/v2/project-links/get/): Read a project link. Scope api:read:projects, permission projects::links, cost 1 unit, read bucket. - [PATCH /project-links/{project_link}](https://developers.plnnrly.com/en/docs/api/v2/project-links/update/): Update a project link. Scope api:write:projects, permission projects::links, cost 1 unit, write bucket. - [DELETE /project-links/{project_link}](https://developers.plnnrly.com/en/docs/api/v2/project-links/delete/): Delete a project link. Scope api:destroy:projects, permission projects::links, cost 1 unit, write bucket. - [GET /projects/{project}/tasks](https://developers.plnnrly.com/en/docs/api/v2/projects/tasks/list/): List a project's tasks. Scope api:read:kanban, permission kanban::manage_self, cost 1 unit, read bucket. - [POST /projects/{project}/tasks](https://developers.plnnrly.com/en/docs/api/v2/projects/tasks/create/): Create a task on a project. Scope api:write:kanban, permission kanban::manage_self, cost 1 unit, write bucket. - [GET /tasks/{task}](https://developers.plnnrly.com/en/docs/api/v2/tasks/get/): Read a task. Scope api:read:kanban, permission kanban::manage_self, cost 1 unit, read bucket. - [PATCH /tasks/{task}](https://developers.plnnrly.com/en/docs/api/v2/tasks/update/): Update a task. Scope api:write:kanban, permission kanban::manage_self, cost 1 unit, write bucket. - [DELETE /tasks/{task}](https://developers.plnnrly.com/en/docs/api/v2/tasks/delete/): Delete a task. Scope api:destroy:kanban, permission kanban::manage_self, cost 1 unit, write bucket. ### Work items The backlog: work items, subtasks, links, comments and attachments. - [GET /work-items](https://developers.plnnrly.com/en/docs/api/v2/work-items/list/): List work items. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [POST /work-items](https://developers.plnnrly.com/en/docs/api/v2/work-items/create/): Create a work item. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [GET /work-items/{work_item}](https://developers.plnnrly.com/en/docs/api/v2/work-items/get/): Read a work item. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [PATCH /work-items/{work_item}](https://developers.plnnrly.com/en/docs/api/v2/work-items/update/): Update a work item. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [DELETE /work-items/{work_item}](https://developers.plnnrly.com/en/docs/api/v2/work-items/delete/): Delete a work item. Scope api:destroy:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [POST /work-items/{work_item}/actions/move](https://developers.plnnrly.com/en/docs/api/v2/work-items/move/): Move a work item to a position. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [POST /work-items/{work_item}/actions/transition](https://developers.plnnrly.com/en/docs/api/v2/work-items/transition/): Transition a work item. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [GET /work-items/{work_item}/attachments](https://developers.plnnrly.com/en/docs/api/v2/work-items/attachments/list/): List a work item's attachments. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [POST /work-items/{work_item}/attachments](https://developers.plnnrly.com/en/docs/api/v2/work-items/attachments/create/): Attach an uploaded file to a work item. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [GET /work-items/{work_item}/comments](https://developers.plnnrly.com/en/docs/api/v2/work-items/comments/list/): List a work item's comments. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [POST /work-items/{work_item}/comments](https://developers.plnnrly.com/en/docs/api/v2/work-items/comments/create/): Post a comment on a work item. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [GET /comments/{comment}](https://developers.plnnrly.com/en/docs/api/v2/comments/get/): Read a comment. Scope api:read:project_management or api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission project_management::view_backlog, cost 1 unit, read bucket. - [PATCH /comments/{comment}](https://developers.plnnrly.com/en/docs/api/v2/comments/update/): Edit a comment. Scope api:write:project_management or api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_management::manage_work_items, cost 1 unit, write bucket. - [DELETE /comments/{comment}](https://developers.plnnrly.com/en/docs/api/v2/comments/delete/): Delete a comment. Scope api:destroy:project_management or api:destroy:project_drive or api:destroy:customer_drive or api:destroy:organization_drive or api:destroy:user_drive, permission project_management::manage_work_items, cost 1 unit, write bucket. - [GET /work-items/{work_item}/subtasks](https://developers.plnnrly.com/en/docs/api/v2/work-items/subtasks/list/): List a work item's subtasks. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [POST /work-items/{work_item}/subtasks](https://developers.plnnrly.com/en/docs/api/v2/work-items/subtasks/create/): Add a subtask to a work item. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [GET /subtasks/{subtask}](https://developers.plnnrly.com/en/docs/api/v2/subtasks/get/): Read a subtask. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [PATCH /subtasks/{subtask}](https://developers.plnnrly.com/en/docs/api/v2/subtasks/update/): Update a subtask. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [DELETE /subtasks/{subtask}](https://developers.plnnrly.com/en/docs/api/v2/subtasks/delete/): Delete a subtask. Scope api:destroy:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [POST /work-items/{work_item}/uploads](https://developers.plnnrly.com/en/docs/api/v2/work-items/uploads/create/): Start a file upload on a work item. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [GET /work-items/{work_item}/links](https://developers.plnnrly.com/en/docs/api/v2/work-items/links/list/): List a work item's links. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [POST /work-items/{work_item}/links](https://developers.plnnrly.com/en/docs/api/v2/work-items/links/create/): Link a work item to another. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [GET /work-item-links/{work_item_link}](https://developers.plnnrly.com/en/docs/api/v2/work-item-links/get/): Read a work item link. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [DELETE /work-item-links/{work_item_link}](https://developers.plnnrly.com/en/docs/api/v2/work-item-links/delete/): Delete a work item link. Scope api:destroy:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. ### Sprints Sprint planning and the sprint state machine. - [GET /sprints](https://developers.plnnrly.com/en/docs/api/v2/sprints/list/): List sprints. Scope api:read:project_management, permission project_management::view_active_sprint, cost 1 unit, read bucket. - [POST /sprints](https://developers.plnnrly.com/en/docs/api/v2/sprints/create/): Create a sprint. Scope api:write:project_management, permission project_management::manage_sprints, cost 1 unit, write bucket. - [GET /sprints/{sprint}](https://developers.plnnrly.com/en/docs/api/v2/sprints/get/): Read a sprint. Scope api:read:project_management, permission project_management::view_active_sprint, cost 1 unit, read bucket. - [PATCH /sprints/{sprint}](https://developers.plnnrly.com/en/docs/api/v2/sprints/update/): Update a sprint. Scope api:write:project_management, permission project_management::manage_sprints, cost 1 unit, write bucket. - [DELETE /sprints/{sprint}](https://developers.plnnrly.com/en/docs/api/v2/sprints/delete/): Delete a sprint. Scope api:destroy:project_management, permission project_management::manage_sprints, cost 1 unit, write bucket. - [POST /sprints/{sprint}/actions/complete](https://developers.plnnrly.com/en/docs/api/v2/sprints/complete/): Complete a sprint. Scope api:write:project_management, permission project_management::manage_sprints, cost 1 unit, write bucket. - [POST /sprints/{sprint}/actions/start](https://developers.plnnrly.com/en/docs/api/v2/sprints/start/): Start a sprint. Scope api:write:project_management, permission project_management::manage_sprints, cost 1 unit, write bucket. ### Time Worklogs and timers. - [GET /timers](https://developers.plnnrly.com/en/docs/api/v2/timers/list/): List running timers. Scope api:read:hours, permission hours::read, cost 1 unit, read bucket. - [POST /timers](https://developers.plnnrly.com/en/docs/api/v2/timers/create/): Start a timer. Scope api:write:hours, permission none, cost 1 unit, write bucket. - [GET /timers/{timer}](https://developers.plnnrly.com/en/docs/api/v2/timers/get/): Read a timer. Scope api:read:hours, permission hours::read, cost 1 unit, read bucket. - [PATCH /timers/{timer}](https://developers.plnnrly.com/en/docs/api/v2/timers/update/): Correct a timer. Scope api:write:hours, permission none, cost 1 unit, write bucket. - [DELETE /timers/{timer}](https://developers.plnnrly.com/en/docs/api/v2/timers/delete/): Discard a timer. Scope api:destroy:hours, permission none, cost 1 unit, write bucket. - [GET /worklogs](https://developers.plnnrly.com/en/docs/api/v2/worklogs/list/): List worklogs. Scope api:read:times, permission hours::read, cost 1 unit, read bucket. - [POST /worklogs](https://developers.plnnrly.com/en/docs/api/v2/worklogs/create/): Log time. Scope api:write:times, permission none, cost 1 unit, write bucket. - [GET /worklogs/{worklog}](https://developers.plnnrly.com/en/docs/api/v2/worklogs/get/): Read a worklog. Scope api:read:times, permission hours::read, cost 1 unit, read bucket. - [PATCH /worklogs/{worklog}](https://developers.plnnrly.com/en/docs/api/v2/worklogs/update/): Correct a worklog. Scope api:write:times, permission none, cost 1 unit, write bucket. - [DELETE /worklogs/{worklog}](https://developers.plnnrly.com/en/docs/api/v2/worklogs/delete/): Delete a worklog. Scope api:destroy:times, permission none, cost 1 unit, write bucket. ### Drive Drive items, documents, folders, notes and todos, and the comments and files on a drive item. - [GET /drive-items/{drive_item}/comments](https://developers.plnnrly.com/en/docs/api/v2/drive-items/comments/list/): List a drive item's comments. Scope api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission project_drive::access, cost 1 unit, read bucket. - [POST /drive-items/{drive_item}/comments](https://developers.plnnrly.com/en/docs/api/v2/drive-items/comments/create/): Post a comment on a drive item. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [GET /drive-documents](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/list/): List document bodies. Scope api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission project_drive::access, cost 1 unit, read bucket. - [POST /drive-documents](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/create/): Create a document body. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [GET /drive-documents/{drive_document}](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/get/): Read a document body. Scope api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission project_drive::access, cost 1 unit, read bucket. - [PATCH /drive-documents/{drive_document}](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/update/): Write a document body. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [DELETE /drive-documents/{drive_document}](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/delete/): Delete a document body. Scope api:destroy:project_drive or api:destroy:customer_drive or api:destroy:organization_drive or api:destroy:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [GET /drive-folders](https://developers.plnnrly.com/en/docs/api/v2/drive-folders/list/): List drive folders. Scope api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission project_drive::access, cost 1 unit, read bucket. - [POST /drive-folders](https://developers.plnnrly.com/en/docs/api/v2/drive-folders/create/): Create a drive folder. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [GET /drive-folders/{drive_folder}](https://developers.plnnrly.com/en/docs/api/v2/drive-folders/get/): Read a drive folder. Scope api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission project_drive::access, cost 1 unit, read bucket. - [PATCH /drive-folders/{drive_folder}](https://developers.plnnrly.com/en/docs/api/v2/drive-folders/update/): Update a drive folder. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [DELETE /drive-folders/{drive_folder}](https://developers.plnnrly.com/en/docs/api/v2/drive-folders/delete/): Delete a drive folder. Scope api:destroy:project_drive or api:destroy:customer_drive or api:destroy:organization_drive or api:destroy:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [GET /drive-items](https://developers.plnnrly.com/en/docs/api/v2/drive-items/list/): List drive items. Scope api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission project_drive::access, cost 1 unit, read bucket. - [POST /drive-items](https://developers.plnnrly.com/en/docs/api/v2/drive-items/create/): Create a drive item. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [GET /drive-items/{drive_item}](https://developers.plnnrly.com/en/docs/api/v2/drive-items/get/): Read a drive item. Scope api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission project_drive::access, cost 1 unit, read bucket. - [PATCH /drive-items/{drive_item}](https://developers.plnnrly.com/en/docs/api/v2/drive-items/update/): Update a drive item. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [DELETE /drive-items/{drive_item}](https://developers.plnnrly.com/en/docs/api/v2/drive-items/delete/): Archive a drive item. Scope api:destroy:project_drive or api:destroy:customer_drive or api:destroy:organization_drive or api:destroy:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [POST /drive-items/{drive_item}/actions/restore](https://developers.plnnrly.com/en/docs/api/v2/drive-items/restore/): Restore an archived drive item. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [GET /drive-items/{drive_item}/files](https://developers.plnnrly.com/en/docs/api/v2/drive-items/files/list/): List a drive item's files. Scope api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission project_drive::access, cost 1 unit, read bucket. - [POST /drive-items/{drive_item}/files](https://developers.plnnrly.com/en/docs/api/v2/drive-items/files/create/): Attach an uploaded file to a drive item. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [GET /notes](https://developers.plnnrly.com/en/docs/api/v2/notes/list/): List notes. Scope api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission project_drive::access, cost 1 unit, read bucket. - [POST /notes](https://developers.plnnrly.com/en/docs/api/v2/notes/create/): Create a note. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [GET /notes/{note}](https://developers.plnnrly.com/en/docs/api/v2/notes/get/): Read a note. Scope api:read:project_drive or api:read:customer_drive or api:read:organization_drive or api:read:user_drive, permission project_drive::access, cost 1 unit, read bucket. - [PATCH /notes/{note}](https://developers.plnnrly.com/en/docs/api/v2/notes/update/): Update a note. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [DELETE /notes/{note}](https://developers.plnnrly.com/en/docs/api/v2/notes/delete/): Delete a note. Scope api:destroy:project_drive or api:destroy:customer_drive or api:destroy:organization_drive or api:destroy:user_drive, permission project_drive::create, cost 1 unit, write bucket. - [GET /todos](https://developers.plnnrly.com/en/docs/api/v2/todos/list/): List your todos. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [POST /todos](https://developers.plnnrly.com/en/docs/api/v2/todos/create/): Create a todo. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [GET /todos/{todo}](https://developers.plnnrly.com/en/docs/api/v2/todos/get/): Read a todo. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [PATCH /todos/{todo}](https://developers.plnnrly.com/en/docs/api/v2/todos/update/): Update a todo. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [DELETE /todos/{todo}](https://developers.plnnrly.com/en/docs/api/v2/todos/delete/): Delete a todo. Scope api:destroy:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [POST /drive-items/{drive_item}/uploads](https://developers.plnnrly.com/en/docs/api/v2/drive-items/uploads/create/): Start a file upload on a drive item. Scope api:write:project_drive or api:write:customer_drive or api:write:organization_drive or api:write:user_drive, permission project_drive::create, cost 1 unit, write bucket. ### Customers Customers, contacts and categories. - [GET /customers](https://developers.plnnrly.com/en/docs/api/v2/customers/list/): List customers. Scope api:read:customers, permission customers::read, cost 1 unit, read bucket. - [POST /customers](https://developers.plnnrly.com/en/docs/api/v2/customers/create/): Create a customer. Scope api:write:customers, permission customers::create, cost 1 unit, write bucket. - [GET /customers/{customer}](https://developers.plnnrly.com/en/docs/api/v2/customers/get/): Read a customer. Scope api:read:customers, permission customers::read, cost 1 unit, read bucket. - [PATCH /customers/{customer}](https://developers.plnnrly.com/en/docs/api/v2/customers/update/): Update a customer. Scope api:write:customers, permission customers::update, cost 1 unit, write bucket. - [DELETE /customers/{customer}](https://developers.plnnrly.com/en/docs/api/v2/customers/delete/): Delete a customer. Scope api:destroy:customers, permission customers::delete, cost 1 unit, write bucket. - [POST /customers/{customer}/actions/restore](https://developers.plnnrly.com/en/docs/api/v2/customers/restore/): Restore a deleted customer. Scope api:write:customers, permission customers::create, cost 1 unit, write bucket. - [GET /contact-roles](https://developers.plnnrly.com/en/docs/api/v2/contact-roles/list/): List contact roles. Scope api:read:customers, permission customers::read, cost 1 unit, read bucket. - [POST /contact-roles](https://developers.plnnrly.com/en/docs/api/v2/contact-roles/create/): Create a contact role. Scope api:write:customers, permission customers::create, cost 1 unit, write bucket. - [GET /contact-roles/{contact_role}](https://developers.plnnrly.com/en/docs/api/v2/contact-roles/get/): Read a contact role. Scope api:read:customers, permission customers::read, cost 1 unit, read bucket. - [PATCH /contact-roles/{contact_role}](https://developers.plnnrly.com/en/docs/api/v2/contact-roles/update/): Update a contact role. Scope api:write:customers, permission customers::update, cost 1 unit, write bucket. - [DELETE /contact-roles/{contact_role}](https://developers.plnnrly.com/en/docs/api/v2/contact-roles/delete/): Delete a contact role. Scope api:destroy:customers, permission customers::delete, cost 1 unit, write bucket. - [GET /contacts](https://developers.plnnrly.com/en/docs/api/v2/contacts/list/): List contacts. Scope api:read:customers, permission customers::read, cost 1 unit, read bucket. - [POST /contacts](https://developers.plnnrly.com/en/docs/api/v2/contacts/create/): Create a contact. Scope api:write:customers, permission customers::create, cost 1 unit, write bucket. - [GET /contacts/{contact}](https://developers.plnnrly.com/en/docs/api/v2/contacts/get/): Read a contact. Scope api:read:customers, permission customers::read, cost 1 unit, read bucket. - [PATCH /contacts/{contact}](https://developers.plnnrly.com/en/docs/api/v2/contacts/update/): Update a contact. Scope api:write:customers, permission customers::update, cost 1 unit, write bucket. - [DELETE /contacts/{contact}](https://developers.plnnrly.com/en/docs/api/v2/contacts/delete/): Delete a contact. Scope api:destroy:customers, permission customers::delete, cost 1 unit, write bucket. - [GET /customer-categories](https://developers.plnnrly.com/en/docs/api/v2/customer-categories/list/): List customer categories. Scope api:read:customer_categories, permission customer_categories::read, cost 1 unit, read bucket. - [POST /customer-categories](https://developers.plnnrly.com/en/docs/api/v2/customer-categories/create/): Create a customer category. Scope api:write:customer_categories, permission customer_categories::create, cost 1 unit, write bucket. - [GET /customer-categories/{customer_category}](https://developers.plnnrly.com/en/docs/api/v2/customer-categories/get/): Read a customer category. Scope api:read:customer_categories, permission customer_categories::read, cost 1 unit, read bucket. - [PATCH /customer-categories/{customer_category}](https://developers.plnnrly.com/en/docs/api/v2/customer-categories/update/): Update a customer category. Scope api:write:customer_categories, permission customer_categories::update, cost 1 unit, write bucket. - [DELETE /customer-categories/{customer_category}](https://developers.plnnrly.com/en/docs/api/v2/customer-categories/delete/): Delete a customer category. Scope api:destroy:customer_categories, permission customer_categories::delete, cost 1 unit, write bucket. ### Billing Sales invoices, subscriptions and invoice lines. - [GET /customer-subscriptions](https://developers.plnnrly.com/en/docs/api/v2/customer-subscriptions/list/): List customer subscriptions. Scope api:read:customer_subscriptions, permission customer_subscriptions::read, cost 1 unit, read bucket. - [POST /customer-subscriptions](https://developers.plnnrly.com/en/docs/api/v2/customer-subscriptions/create/): Create a customer subscription. Scope api:write:customer_subscriptions, permission customer_subscriptions::create, cost 1 unit, write bucket. - [GET /customer-subscriptions/{customer_subscription}](https://developers.plnnrly.com/en/docs/api/v2/customer-subscriptions/get/): Read a customer subscription. Scope api:read:customer_subscriptions, permission customer_subscriptions::read, cost 1 unit, read bucket. - [PATCH /customer-subscriptions/{customer_subscription}](https://developers.plnnrly.com/en/docs/api/v2/customer-subscriptions/update/): Update a customer subscription. Scope api:write:customer_subscriptions, permission customer_subscriptions::update, cost 1 unit, write bucket. - [DELETE /customer-subscriptions/{customer_subscription}](https://developers.plnnrly.com/en/docs/api/v2/customer-subscriptions/delete/): Delete a customer subscription. Scope api:destroy:customer_subscriptions, permission customer_subscriptions::delete, cost 1 unit, write bucket. - [POST /customer-subscriptions/{customer_subscription}/actions/restore](https://developers.plnnrly.com/en/docs/api/v2/customer-subscriptions/restore/): Restore a deleted customer subscription. Scope api:write:customer_subscriptions, permission customer_subscriptions::create, cost 1 unit, write bucket. - [GET /invoices](https://developers.plnnrly.com/en/docs/api/v2/invoices/list/): List invoices. Scope api:read:invoices, permission invoices::read, cost 1 unit, read bucket. - [POST /invoices](https://developers.plnnrly.com/en/docs/api/v2/invoices/create/): Create an invoice. Scope api:write:invoices, permission invoices::create, cost 1 unit, write bucket. - [GET /invoices/{invoice}](https://developers.plnnrly.com/en/docs/api/v2/invoices/get/): Read an invoice. Scope api:read:invoices, permission invoices::read, cost 1 unit, read bucket. - [GET /sales-invoices/{sales_invoice}/rows](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/rows/list/): List an invoice's lines. Scope api:read:sales_invoices, permission sales_invoices::read, cost 1 unit, read bucket. - [POST /sales-invoices/{sales_invoice}/rows](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/rows/create/): Add a line to an invoice. Scope api:write:sales_invoices, permission sales_invoices::create, cost 1 unit, write bucket. - [GET /sales-invoice-rows/{sales_invoice_row}](https://developers.plnnrly.com/en/docs/api/v2/sales-invoice-rows/get/): Read an invoice line. Scope api:read:sales_invoices, permission sales_invoices::read, cost 1 unit, read bucket. - [PATCH /sales-invoice-rows/{sales_invoice_row}](https://developers.plnnrly.com/en/docs/api/v2/sales-invoice-rows/update/): Update an invoice line. Scope api:write:sales_invoices, permission sales_invoices::update, cost 1 unit, write bucket. - [DELETE /sales-invoice-rows/{sales_invoice_row}](https://developers.plnnrly.com/en/docs/api/v2/sales-invoice-rows/delete/): Delete an invoice line. Scope api:destroy:sales_invoices, permission sales_invoices::delete, cost 1 unit, write bucket. - [GET /sales-invoices](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/list/): List sales invoices. Scope api:read:sales_invoices, permission sales_invoices::read, cost 1 unit, read bucket. - [POST /sales-invoices](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/create/): Create a sales invoice. Scope api:write:sales_invoices, permission sales_invoices::create, cost 1 unit, write bucket. - [GET /sales-invoices/{sales_invoice}](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/get/): Read a sales invoice. Scope api:read:sales_invoices, permission sales_invoices::read, cost 1 unit, read bucket. - [PATCH /sales-invoices/{sales_invoice}](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/update/): Update a sales invoice. Scope api:write:sales_invoices, permission sales_invoices::update, cost 1 unit, write bucket. - [DELETE /sales-invoices/{sales_invoice}](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/delete/): Delete a sales invoice. Scope api:destroy:sales_invoices, permission sales_invoices::delete, cost 1 unit, write bucket. - [POST /sales-invoices/{sales_invoice}/actions/restore](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/restore/): Restore a deleted sales invoice. Scope api:write:sales_invoices, permission sales_invoices::create, cost 1 unit, write bucket. - [GET /customer-subscriptions/{customer_subscription}/items](https://developers.plnnrly.com/en/docs/api/v2/customer-subscriptions/items/list/): List a subscription's lines. Scope api:read:customer_subscriptions, permission customer_subscriptions::read, cost 1 unit, read bucket. - [POST /customer-subscriptions/{customer_subscription}/items](https://developers.plnnrly.com/en/docs/api/v2/customer-subscriptions/items/create/): Add a line to a subscription. Scope api:write:customer_subscriptions, permission customer_subscriptions::create, cost 1 unit, write bucket. - [GET /subscription-items/{subscription_item}](https://developers.plnnrly.com/en/docs/api/v2/subscription-items/get/): Read a subscription line. Scope api:read:customer_subscriptions, permission customer_subscriptions::read, cost 1 unit, read bucket. - [PATCH /subscription-items/{subscription_item}](https://developers.plnnrly.com/en/docs/api/v2/subscription-items/update/): Update a subscription line. Scope api:write:customer_subscriptions, permission customer_subscriptions::update, cost 1 unit, write bucket. - [DELETE /subscription-items/{subscription_item}](https://developers.plnnrly.com/en/docs/api/v2/subscription-items/delete/): Delete a subscription line. Scope api:destroy:customer_subscriptions, permission customer_subscriptions::delete, cost 1 unit, write bucket. - [GET /subscription-products](https://developers.plnnrly.com/en/docs/api/v2/subscription-products/list/): List subscription products. Scope api:read:subscription_products, permission subscription_products::read, cost 1 unit, read bucket. - [POST /subscription-products](https://developers.plnnrly.com/en/docs/api/v2/subscription-products/create/): Create a subscription product. Scope api:write:subscription_products, permission subscription_products::create, cost 1 unit, write bucket. - [GET /subscription-products/{subscription_product}](https://developers.plnnrly.com/en/docs/api/v2/subscription-products/get/): Read a subscription product. Scope api:read:subscription_products, permission subscription_products::read, cost 1 unit, read bucket. - [PATCH /subscription-products/{subscription_product}](https://developers.plnnrly.com/en/docs/api/v2/subscription-products/update/): Update a subscription product. Scope api:write:subscription_products, permission subscription_products::update, cost 1 unit, write bucket. - [DELETE /subscription-products/{subscription_product}](https://developers.plnnrly.com/en/docs/api/v2/subscription-products/delete/): Delete a subscription product. Scope api:destroy:subscription_products, permission subscription_products::delete, cost 1 unit, write bucket. - [POST /subscription-products/{subscription_product}/actions/restore](https://developers.plnnrly.com/en/docs/api/v2/subscription-products/restore/): Restore a deleted subscription product. Scope api:write:subscription_products, permission subscription_products::create, cost 1 unit, write bucket. - [GET /subscription-types/{subscription_type}/items](https://developers.plnnrly.com/en/docs/api/v2/subscription-types/items/list/): List a subscription type's template lines. Scope api:read:subscription_types, permission subscription_types::read, cost 1 unit, read bucket. - [POST /subscription-types/{subscription_type}/items](https://developers.plnnrly.com/en/docs/api/v2/subscription-types/items/create/): Add a template line to a subscription type. Scope api:write:subscription_types, permission subscription_types::create, cost 1 unit, write bucket. - [GET /subscription-type-items/{subscription_type_item}](https://developers.plnnrly.com/en/docs/api/v2/subscription-type-items/get/): Read a template line. Scope api:read:subscription_types, permission subscription_types::read, cost 1 unit, read bucket. - [PATCH /subscription-type-items/{subscription_type_item}](https://developers.plnnrly.com/en/docs/api/v2/subscription-type-items/update/): Update a template line. Scope api:write:subscription_types, permission subscription_types::update, cost 1 unit, write bucket. - [DELETE /subscription-type-items/{subscription_type_item}](https://developers.plnnrly.com/en/docs/api/v2/subscription-type-items/delete/): Delete a template line. Scope api:destroy:subscription_types, permission subscription_types::delete, cost 1 unit, write bucket. - [GET /subscription-types](https://developers.plnnrly.com/en/docs/api/v2/subscription-types/list/): List subscription types. Scope api:read:subscription_types, permission subscription_types::read, cost 1 unit, read bucket. - [POST /subscription-types](https://developers.plnnrly.com/en/docs/api/v2/subscription-types/create/): Create a subscription type. Scope api:write:subscription_types, permission subscription_types::create, cost 1 unit, write bucket. - [GET /subscription-types/{subscription_type}](https://developers.plnnrly.com/en/docs/api/v2/subscription-types/get/): Read a subscription type. Scope api:read:subscription_types, permission subscription_types::read, cost 1 unit, read bucket. - [PATCH /subscription-types/{subscription_type}](https://developers.plnnrly.com/en/docs/api/v2/subscription-types/update/): Update a subscription type. Scope api:write:subscription_types, permission subscription_types::update, cost 1 unit, write bucket. - [DELETE /subscription-types/{subscription_type}](https://developers.plnnrly.com/en/docs/api/v2/subscription-types/delete/): Delete a subscription type. Scope api:destroy:subscription_types, permission subscription_types::delete, cost 1 unit, write bucket. - [POST /subscription-types/{subscription_type}/actions/restore](https://developers.plnnrly.com/en/docs/api/v2/subscription-types/restore/): Restore a deleted subscription type. Scope api:write:subscription_types, permission subscription_types::create, cost 1 unit, write bucket. ### Leave Absences, holidays, free days, check-ins and furlough balances. - [GET /absences](https://developers.plnnrly.com/en/docs/api/v2/absences/list/): List absences. Scope api:read:absences, permission absences::manage, cost 1 unit, read bucket. - [POST /absences](https://developers.plnnrly.com/en/docs/api/v2/absences/create/): Book an absence. Scope api:write:absences, permission absences::manage, cost 1 unit, write bucket. - [GET /absences/{absence}](https://developers.plnnrly.com/en/docs/api/v2/absences/get/): Read an absence. Scope api:read:absences, permission absences::manage, cost 1 unit, read bucket. - [PATCH /absences/{absence}](https://developers.plnnrly.com/en/docs/api/v2/absences/update/): Update an absence. Scope api:write:absences, permission absences::manage, cost 1 unit, write bucket. - [DELETE /absences/{absence}](https://developers.plnnrly.com/en/docs/api/v2/absences/delete/): Delete an absence. Scope api:destroy:absences, permission absences::manage, cost 1 unit, write bucket. - [GET /checkins](https://developers.plnnrly.com/en/docs/api/v2/checkins/list/): List checkins. Scope api:read:checkins, permission checkins::read, cost 1 unit, read bucket. - [POST /checkins](https://developers.plnnrly.com/en/docs/api/v2/checkins/create/): Check in. Scope api:write:checkins, permission none, cost 1 unit, write bucket. - [GET /checkins/{checkin}](https://developers.plnnrly.com/en/docs/api/v2/checkins/get/): Read a checkin. Scope api:read:checkins, permission checkins::read, cost 1 unit, read bucket. - [PATCH /checkins/{checkin}](https://developers.plnnrly.com/en/docs/api/v2/checkins/update/): Check out, or correct a checkin. Scope api:write:checkins, permission none, cost 1 unit, write bucket. - [DELETE /checkins/{checkin}](https://developers.plnnrly.com/en/docs/api/v2/checkins/delete/): Delete a checkin. Scope api:destroy:checkins, permission none, cost 1 unit, write bucket. - [GET /free-days](https://developers.plnnrly.com/en/docs/api/v2/free-days/list/): List free days. Scope api:read:free_days, permission free_days::manage, cost 1 unit, read bucket. - [POST /free-days](https://developers.plnnrly.com/en/docs/api/v2/free-days/create/): Create a free day. Scope api:write:free_days, permission free_days::manage, cost 1 unit, write bucket. - [GET /free-days/{free_day}](https://developers.plnnrly.com/en/docs/api/v2/free-days/get/): Read a free day. Scope api:read:free_days, permission free_days::manage, cost 1 unit, read bucket. - [PATCH /free-days/{free_day}](https://developers.plnnrly.com/en/docs/api/v2/free-days/update/): Update a free day. Scope api:write:free_days, permission free_days::manage, cost 1 unit, write bucket. - [DELETE /free-days/{free_day}](https://developers.plnnrly.com/en/docs/api/v2/free-days/delete/): Delete a free day. Scope api:destroy:free_days, permission free_days::manage, cost 1 unit, write bucket. - [GET /furlough-balance-mutations](https://developers.plnnrly.com/en/docs/api/v2/furlough-balance-mutations/list/): List furlough balance mutations. Scope api:read:furlough, permission none, cost 1 unit, read bucket. - [POST /furlough-balance-mutations](https://developers.plnnrly.com/en/docs/api/v2/furlough-balance-mutations/create/): Create a furlough balance mutation. Scope api:write:furlough, permission furlough::create_for_yourself, cost 1 unit, write bucket. - [GET /furlough-balance-mutations/{furlough_balance_mutation}](https://developers.plnnrly.com/en/docs/api/v2/furlough-balance-mutations/get/): Read a furlough balance mutation. Scope api:read:furlough, permission none, cost 1 unit, read bucket. - [PATCH /furlough-balance-mutations/{furlough_balance_mutation}](https://developers.plnnrly.com/en/docs/api/v2/furlough-balance-mutations/update/): Update a furlough balance mutation. Scope api:write:furlough, permission furlough::manage, cost 1 unit, write bucket. - [DELETE /furlough-balance-mutations/{furlough_balance_mutation}](https://developers.plnnrly.com/en/docs/api/v2/furlough-balance-mutations/delete/): Delete a furlough balance mutation. Scope api:destroy:furlough, permission furlough::manage, cost 1 unit, write bucket. - [GET /holidays](https://developers.plnnrly.com/en/docs/api/v2/holidays/list/): List holidays. Scope api:read:holidays, permission holidays::manage, cost 1 unit, read bucket. - [POST /holidays](https://developers.plnnrly.com/en/docs/api/v2/holidays/create/): Create a holiday. Scope api:write:holidays, permission holidays::manage, cost 1 unit, write bucket. - [GET /holidays/{holiday}](https://developers.plnnrly.com/en/docs/api/v2/holidays/get/): Read a holiday. Scope api:read:holidays, permission holidays::manage, cost 1 unit, read bucket. - [PATCH /holidays/{holiday}](https://developers.plnnrly.com/en/docs/api/v2/holidays/update/): Update a holiday. Scope api:write:holidays, permission holidays::manage, cost 1 unit, write bucket. - [DELETE /holidays/{holiday}](https://developers.plnnrly.com/en/docs/api/v2/holidays/delete/): Delete a holiday. Scope api:destroy:holidays, permission holidays::manage, cost 1 unit, write bucket. ### Planning Calendar events. - [GET /events](https://developers.plnnrly.com/en/docs/api/v2/events/list/): List events. Scope api:read:events, permission events::manage_self, cost 1 unit, read bucket. - [POST /events](https://developers.plnnrly.com/en/docs/api/v2/events/create/): Create an event. Scope api:write:events, permission events::manage_self, cost 1 unit, write bucket. - [GET /events/{event}](https://developers.plnnrly.com/en/docs/api/v2/events/get/): Read an event. Scope api:read:events, permission events::manage_self, cost 1 unit, read bucket. - [PATCH /events/{event}](https://developers.plnnrly.com/en/docs/api/v2/events/update/): Update an event. Scope api:write:events, permission events::manage_self, cost 1 unit, write bucket. - [DELETE /events/{event}](https://developers.plnnrly.com/en/docs/api/v2/events/delete/): Delete an event. Scope api:destroy:events, permission events::manage_self, cost 1 unit, write bucket. - [POST /events/{event}/actions/restore](https://developers.plnnrly.com/en/docs/api/v2/events/restore/): Restore a deleted event. Scope api:write:events, permission events::manage_self, cost 1 unit, write bucket. ### Organization Users and company branches. - [GET /company-branches](https://developers.plnnrly.com/en/docs/api/v2/company-branches/list/): List company branches. Scope api:read:company_branches, permission company_branches::read, cost 1 unit, read bucket. - [POST /company-branches](https://developers.plnnrly.com/en/docs/api/v2/company-branches/create/): Create a company branch. Scope api:write:company_branches, permission company_branches::create, cost 1 unit, write bucket. - [GET /company-branches/{company_branch}](https://developers.plnnrly.com/en/docs/api/v2/company-branches/get/): Read a company branch. Scope api:read:company_branches, permission company_branches::read, cost 1 unit, read bucket. - [PATCH /company-branches/{company_branch}](https://developers.plnnrly.com/en/docs/api/v2/company-branches/update/): Update a company branch. Scope api:write:company_branches, permission company_branches::update, cost 1 unit, write bucket. - [DELETE /company-branches/{company_branch}](https://developers.plnnrly.com/en/docs/api/v2/company-branches/delete/): Delete a company branch. Scope api:destroy:company_branches, permission company_branches::delete, cost 1 unit, write bucket. - [GET /users](https://developers.plnnrly.com/en/docs/api/v2/users/list/): List users. Scope api:read:users, permission users::read, cost 1 unit, read bucket. - [GET /users/{user}](https://developers.plnnrly.com/en/docs/api/v2/users/get/): Read a user. Scope api:read:users, permission users::read, cost 1 unit, read bucket. ### Configuration Workflows, statuses, work types and labels. - [GET /labels](https://developers.plnnrly.com/en/docs/api/v2/labels/list/): List labels. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [POST /labels](https://developers.plnnrly.com/en/docs/api/v2/labels/create/): Create a label. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [GET /labels/{label}](https://developers.plnnrly.com/en/docs/api/v2/labels/get/): Read a label. Scope api:read:project_management, permission project_management::view_backlog, cost 1 unit, read bucket. - [PATCH /labels/{label}](https://developers.plnnrly.com/en/docs/api/v2/labels/update/): Update a label. Scope api:write:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [DELETE /labels/{label}](https://developers.plnnrly.com/en/docs/api/v2/labels/delete/): Delete a label. Scope api:destroy:project_management, permission project_management::manage_work_items, cost 1 unit, write bucket. - [GET /work-types](https://developers.plnnrly.com/en/docs/api/v2/work-types/list/): List work types. Scope api:read:work_types, permission work_types::read, cost 1 unit, read bucket. - [POST /work-types](https://developers.plnnrly.com/en/docs/api/v2/work-types/create/): Create a work type. Scope api:write:work_types, permission work_types::create, cost 1 unit, write bucket. - [GET /work-types/{work_type}](https://developers.plnnrly.com/en/docs/api/v2/work-types/get/): Read a work type. Scope api:read:work_types, permission work_types::read, cost 1 unit, read bucket. - [PATCH /work-types/{work_type}](https://developers.plnnrly.com/en/docs/api/v2/work-types/update/): Update a work type. Scope api:write:work_types, permission work_types::update, cost 1 unit, write bucket. - [DELETE /work-types/{work_type}](https://developers.plnnrly.com/en/docs/api/v2/work-types/delete/): Delete a work type. Scope api:destroy:work_types, permission work_types::delete, cost 1 unit, write bucket. - [GET /workflow-statuses](https://developers.plnnrly.com/en/docs/api/v2/workflow-statuses/list/): List workflow statuses. Scope api:read:workflows, permission workflows::read, cost 1 unit, read bucket. - [POST /workflow-statuses](https://developers.plnnrly.com/en/docs/api/v2/workflow-statuses/create/): Create a workflow status. Scope api:write:workflows, permission workflows::create, cost 1 unit, write bucket. - [GET /workflow-statuses/{workflow_status}](https://developers.plnnrly.com/en/docs/api/v2/workflow-statuses/get/): Read a workflow status. Scope api:read:workflows, permission workflows::read, cost 1 unit, read bucket. - [PATCH /workflow-statuses/{workflow_status}](https://developers.plnnrly.com/en/docs/api/v2/workflow-statuses/update/): Update a workflow status. Scope api:write:workflows, permission workflows::update, cost 1 unit, write bucket. - [DELETE /workflow-statuses/{workflow_status}](https://developers.plnnrly.com/en/docs/api/v2/workflow-statuses/delete/): Delete a workflow status. Scope api:destroy:workflows, permission workflows::delete, cost 1 unit, write bucket. - [GET /workflow-transitions](https://developers.plnnrly.com/en/docs/api/v2/workflow-transitions/list/): List workflow transitions. Scope api:read:workflows, permission workflows::read, cost 1 unit, read bucket. - [POST /workflow-transitions](https://developers.plnnrly.com/en/docs/api/v2/workflow-transitions/create/): Create a workflow transition. Scope api:write:workflows, permission workflows::create, cost 1 unit, write bucket. - [GET /workflow-transitions/{workflow_transition}](https://developers.plnnrly.com/en/docs/api/v2/workflow-transitions/get/): Read a workflow transition. Scope api:read:workflows, permission workflows::read, cost 1 unit, read bucket. - [PATCH /workflow-transitions/{workflow_transition}](https://developers.plnnrly.com/en/docs/api/v2/workflow-transitions/update/): Update a workflow transition. Scope api:write:workflows, permission workflows::update, cost 1 unit, write bucket. - [DELETE /workflow-transitions/{workflow_transition}](https://developers.plnnrly.com/en/docs/api/v2/workflow-transitions/delete/): Delete a workflow transition. Scope api:destroy:workflows, permission workflows::delete, cost 1 unit, write bucket. - [GET /workflows](https://developers.plnnrly.com/en/docs/api/v2/workflows/list/): List workflows. Scope api:read:workflows, permission workflows::read, cost 1 unit, read bucket. - [POST /workflows](https://developers.plnnrly.com/en/docs/api/v2/workflows/create/): Create a workflow. Scope api:write:workflows, permission workflows::create, cost 1 unit, write bucket. - [GET /workflows/{workflow}](https://developers.plnnrly.com/en/docs/api/v2/workflows/get/): Read a workflow. Scope api:read:workflows, permission workflows::read, cost 1 unit, read bucket. - [PATCH /workflows/{workflow}](https://developers.plnnrly.com/en/docs/api/v2/workflows/update/): Update a workflow. Scope api:write:workflows, permission workflows::update, cost 1 unit, write bucket. - [DELETE /workflows/{workflow}](https://developers.plnnrly.com/en/docs/api/v2/workflows/delete/): Delete a workflow. Scope api:destroy:workflows, permission workflows::delete, cost 1 unit, write bucket. ## Translations The documentation outside the API section, in the other languages. The API section is English only. ### Nederlands (nl) - [Begin hier](https://developers.plnnrly.com/nl/docs/): Koppel een AI-assistent via MCP aan plnnrly, of bouw je eigen koppeling op de REST API. - [Voor beheerders](https://developers.plnnrly.com/nl/docs/administration/): Zet MCP en de REST API aan of uit voor je organisatie, en bepaal wie API-tokens mag aanmaken en apps mag koppelen. - [MCP](https://developers.plnnrly.com/nl/docs/mcp/): Koppel AI-assistenten aan je plnnrly-organisatie. - Een client koppelen: Handleidingen per AI-client om plnnrly toe te voegen, stap voor stap. - [claude.ai](https://developers.plnnrly.com/nl/docs/mcp/install/claude-ai/): Voeg plnnrly als aangepaste connector toe aan Claude op het web en log één keer in, zonder token. - [Claude Desktop](https://developers.plnnrly.com/nl/docs/mcp/install/claude-desktop/): Voeg plnnrly als aangepaste connector toe aan de desktop-app van Claude en log één keer in, zonder token. - [Claude Code](https://developers.plnnrly.com/nl/docs/mcp/install/claude-code/): Voeg plnnrly met één commando toe aan Claude Code en log in via je browser, zonder token. - [ChatGPT](https://developers.plnnrly.com/nl/docs/mcp/install/chatgpt/): Voeg plnnrly als plug-in met een aangepaste MCP-server toe aan ChatGPT en log één keer in, zonder token. - [Cursor](https://developers.plnnrly.com/nl/docs/mcp/install/cursor/): Voeg plnnrly toe aan de desktop-app van Cursor en log in via je browser, zonder token. - [Gemini CLI](https://developers.plnnrly.com/nl/docs/mcp/install/gemini/): Voeg plnnrly met één commando toe aan Gemini CLI van Google en log in via je browser, zonder token. - [Andere clients](https://developers.plnnrly.com/nl/docs/mcp/install/other-clients/): Wat een AI-client nodig heeft om met plnnrly te koppelen, welke instellingen je gebruikt, en welke clients nog niet kunnen inloggen. - [Wat je kunt vragen](https://developers.plnnrly.com/nl/docs/mcp/examples/): Voorbeeldvragen per onderdeel voor een AI-assistent die aan plnnrly is gekoppeld, met de operatie van de REST API die elke vraag gebruikt. - [Tools](https://developers.plnnrly.com/nl/docs/mcp/tools/): De vier tools van de MCP-server van plnnrly, wat elke tool accepteert en teruggeeft, en welke limieten er gelden. - [Rechten en veiligheid](https://developers.plnnrly.com/nl/docs/mcp/permissions-and-safety/): Wat een AI-assistent die aan plnnrly is gekoppeld wel en niet kan, de twee sloten op verwijderen, en hoe je de toegang stopt. - [Problemen oplossen](https://developers.plnnrly.com/nl/docs/mcp/troubleshooting/): Wat je doet als een AI-client geen verbinding krijgt met plnnrly, niet kan inloggen, of een verzoek geweigerd krijgt. - [REST API](https://developers.plnnrly.com/nl/docs/api/): Lees en wijzig je plnnrly-gegevens vanuit je eigen code, met een persoonlijk token of inloggen via OAuth. - [Wijzigingen](https://developers.plnnrly.com/nl/docs/changelog/): Wat er in elke release van plnnrly is veranderd aan de REST API en de MCP-server, nieuwste eerst. - [v2.8.0](https://developers.plnnrly.com/nl/docs/changelog/v2-8-0/): Desktop- en commandoregelapps laten mensen inloggen via OAuth, /me geeft de gebruiker namens wie een token handelt, werkitems verplaats je naar het board of de backlog, en noodcontacten ziet alleen de medewerker zelf. - [v2.7.3](https://developers.plnnrly.com/nl/docs/changelog/v2-7-3/): AI-assistenten die door in te loggen zijn gekoppeld, krijgen nu dezelfde toegang als hun gebruiker. - [v2.7.2](https://developers.plnnrly.com/nl/docs/changelog/v2-7-2/): AI-assistenten koppel je door in te loggen in plaats van met een token, drie algemene tools bereiken elke operatie van de REST API, en nieuwe organisaties beginnen met MCP uit. - [v2.7.0](https://developers.plnnrly.com/nl/docs/changelog/v2-7-0/): De REST API v2 gaat open met persoonlijke API-tokens, en een beheerder kan de REST API en MCP uitzetten. ### Deutsch (de) - [Erste Schritte](https://developers.plnnrly.com/de/docs/): Verbinden Sie einen KI-Assistenten über MCP mit plnnrly, oder bauen Sie Ihre eigene Integration auf der REST-API. - [Für Administratoren](https://developers.plnnrly.com/de/docs/administration/): Schalten Sie MCP und die REST-API für Ihre Organisation ein oder aus, und legen Sie fest, wer API-Tokens erstellen und Apps verbinden darf. - [MCP](https://developers.plnnrly.com/de/docs/mcp/): Verbinden Sie KI-Assistenten mit Ihrer plnnrly-Organisation. - Client verbinden: Schritt-für-Schritt-Anleitungen, mit denen Sie plnnrly in einem KI-Client hinzufügen. - [claude.ai](https://developers.plnnrly.com/de/docs/mcp/install/claude-ai/): Fügen Sie plnnrly in Claude im Web als benutzerdefinierten Connector hinzu und melden Sie sich einmal an, ohne Token. - [Claude Desktop](https://developers.plnnrly.com/de/docs/mcp/install/claude-desktop/): Fügen Sie plnnrly in der Desktop-App Claude Desktop als benutzerdefinierten Connector hinzu und melden Sie sich einmal an, ohne Token. - [Claude Code](https://developers.plnnrly.com/de/docs/mcp/install/claude-code/): Fügen Sie plnnrly mit einem Befehl in Claude Code hinzu und melden Sie sich im Browser an, ohne Token. - [ChatGPT](https://developers.plnnrly.com/de/docs/mcp/install/chatgpt/): Fügen Sie plnnrly in ChatGPT als Plugin mit einem eigenen MCP-Server hinzu und melden Sie sich einmal an, ohne Token. - [Cursor](https://developers.plnnrly.com/de/docs/mcp/install/cursor/): Fügen Sie plnnrly in der Desktop-App von Cursor hinzu und melden Sie sich im Browser an, ohne Token. - [Gemini CLI](https://developers.plnnrly.com/de/docs/mcp/install/gemini/): Fügen Sie plnnrly mit einem Befehl in Gemini CLI von Google hinzu und melden Sie sich im Browser an, ohne Token. - [Andere Clients](https://developers.plnnrly.com/de/docs/mcp/install/other-clients/): Was ein KI-Client braucht, um sich mit plnnrly zu verbinden, welche Einstellungen gelten und welche Clients sich noch nicht anmelden können. - [Was Sie fragen können](https://developers.plnnrly.com/de/docs/mcp/examples/): Beispielfragen für einen mit plnnrly verbundenen KI-Assistenten, nach Bereich, jeweils mit der Operation der REST-API, die er nutzt. - [Tools](https://developers.plnnrly.com/de/docs/mcp/tools/): Die vier Tools des MCP-Servers von plnnrly: was jedes annimmt und zurückgibt und welche Limits gelten. - [Rechte und Sicherheit](https://developers.plnnrly.com/de/docs/mcp/permissions-and-safety/): Was ein mit plnnrly verbundener KI-Assistent kann und was nicht, die zwei Sperren für das Löschen und wie Sie seinen Zugriff beenden. - [Fehlerbehebung](https://developers.plnnrly.com/de/docs/mcp/troubleshooting/): Was Sie tun können, wenn sich ein KI-Client nicht mit plnnrly verbindet, sich nicht anmelden kann oder eine Anfrage abgelehnt wird. - [REST-API](https://developers.plnnrly.com/de/docs/api/): Lesen und ändern Sie Ihre plnnrly-Daten aus Ihrem eigenen Code, mit einem persönlichen Token oder einer Anmeldung per OAuth. - [Änderungen](https://developers.plnnrly.com/de/docs/changelog/): Was sich in jeder Version an der REST-API und am MCP-Server von plnnrly geändert hat, die neueste Version zuerst. - [v2.8.0](https://developers.plnnrly.com/de/docs/changelog/v2-8-0/): Desktop- und Kommandozeilen-Apps melden Personen per OAuth an, /me liefert den Benutzer, in dessen Namen ein Token handelt, Arbeitselemente lassen sich auf das Board oder in die Aufgabenliste legen, und Notfallkontakte sieht nur noch der Mitarbeiter selbst. - [v2.7.3](https://developers.plnnrly.com/de/docs/changelog/v2-7-3/): KI-Assistenten, die sich per Anmeldung verbunden haben, erhalten jetzt denselben Zugriff wie ihr Benutzer. - [v2.7.2](https://developers.plnnrly.com/de/docs/changelog/v2-7-2/): KI-Assistenten verbinden sich per Anmeldung statt mit einem Token, drei allgemeine Tools erreichen jede Operation der REST-API, und neue Organisationen starten mit ausgeschaltetem MCP. - [v2.7.0](https://developers.plnnrly.com/de/docs/changelog/v2-7-0/): Die REST-API v2 startet mit persönlichen API-Tokens, und ein Administrator kann die REST-API und MCP ausschalten. ### Français (fr) - [Commencer ici](https://developers.plnnrly.com/fr/docs/): Connectez un assistant IA à plnnrly via MCP, ou créez votre propre intégration avec l'API REST. - [Pour les administrateurs](https://developers.plnnrly.com/fr/docs/administration/): Activez ou désactivez MCP et l'API REST pour votre organisation, et décidez qui peut créer des tokens API et connecter des applications. - [MCP](https://developers.plnnrly.com/fr/docs/mcp/): Connectez des assistants IA à votre organisation plnnrly. - Connecter un client: Des guides pas à pas pour ajouter plnnrly à un client IA. - [claude.ai](https://developers.plnnrly.com/fr/docs/mcp/install/claude-ai/): Ajoutez plnnrly à Claude sur le web comme connecteur personnalisé et identifiez-vous une seule fois, sans token. - [Claude Desktop](https://developers.plnnrly.com/fr/docs/mcp/install/claude-desktop/): Ajoutez plnnrly à l'application Claude Desktop comme connecteur personnalisé et identifiez-vous une seule fois, sans token. - [Claude Code](https://developers.plnnrly.com/fr/docs/mcp/install/claude-code/): Ajoutez plnnrly à Claude Code avec une seule commande et identifiez-vous depuis votre navigateur, sans token. - [ChatGPT](https://developers.plnnrly.com/fr/docs/mcp/install/chatgpt/): Ajoutez plnnrly à ChatGPT comme plugin de serveur MCP personnalisé et identifiez-vous une seule fois, sans token. - [Cursor](https://developers.plnnrly.com/fr/docs/mcp/install/cursor/): Ajoutez plnnrly à l'application de bureau Cursor et identifiez-vous depuis votre navigateur, sans token. - [Gemini CLI](https://developers.plnnrly.com/fr/docs/mcp/install/gemini/): Ajoutez plnnrly à Gemini CLI de Google avec une seule commande et identifiez-vous depuis votre navigateur, sans token. - [Autres clients](https://developers.plnnrly.com/fr/docs/mcp/install/other-clients/): Ce dont un client IA a besoin pour se connecter à plnnrly, les paramètres à utiliser, et les clients qui ne peuvent pas encore s'identifier. - [Ce que vous pouvez demander](https://developers.plnnrly.com/fr/docs/mcp/examples/): Des exemples de questions pour un assistant IA connecté à plnnrly, regroupés par thème, avec l'opération de l'API REST que chacune utilise. - [Outils](https://developers.plnnrly.com/fr/docs/mcp/tools/): Les quatre outils du serveur MCP de plnnrly, ce que chacun accepte et renvoie, et les limites qui s'appliquent. - [Droits et sécurité](https://developers.plnnrly.com/fr/docs/mcp/permissions-and-safety/): Ce qu'un assistant IA connecté à plnnrly peut et ne peut pas faire, les deux verrous sur la suppression, et comment couper son accès. - [Dépannage](https://developers.plnnrly.com/fr/docs/mcp/troubleshooting/): Que faire quand un client IA ne parvient pas à se connecter à plnnrly ou à s'identifier, ou quand une requête est refusée. - [API REST](https://developers.plnnrly.com/fr/docs/api/): Lisez et modifiez vos données plnnrly depuis votre propre code, avec un token personnel ou une identification OAuth. - [Journal des modifications](https://developers.plnnrly.com/fr/docs/changelog/): Ce qui a changé dans l'API REST et le serveur MCP de plnnrly à chaque version, de la plus récente à la plus ancienne. - [v2.8.0](https://developers.plnnrly.com/fr/docs/changelog/v2-8-0/): Les applications de bureau et en ligne de commande identifient leurs utilisateurs via OAuth, /me renvoie l'utilisateur au nom duquel un token agit, les éléments de travail se placent sur le tableau ou dans l'arriéré, et les contacts d'urgence ne sont visibles que par l'employé concerné. - [v2.7.3](https://developers.plnnrly.com/fr/docs/changelog/v2-7-3/): Les assistants IA connectés en s'identifiant obtiennent désormais le même accès que leur utilisateur. - [v2.7.2](https://developers.plnnrly.com/fr/docs/changelog/v2-7-2/): Les assistants IA se connectent en s'identifiant plutôt qu'avec un token, trois outils généraux accèdent à toutes les opérations de l'API REST, et les nouvelles organisations démarrent avec MCP désactivé. - [v2.7.0](https://developers.plnnrly.com/fr/docs/changelog/v2-7-0/): L'API REST v2 ouvre avec des tokens API personnels, et un administrateur peut désactiver l'API REST et MCP. ### Español (es) - [Empieza aquí](https://developers.plnnrly.com/es/docs/): Conecta un asistente de IA a plnnrly mediante MCP o crea tu propia integración con la API REST. - [Para administradores](https://developers.plnnrly.com/es/docs/administration/): Activa o desactiva MCP y la API REST para tu organización, y decide quién puede crear tokens de API y conectar aplicaciones. - [MCP](https://developers.plnnrly.com/es/docs/mcp/): Conecta asistentes de IA a tu organización de plnnrly. - Conectar un cliente: Guías paso a paso para añadir plnnrly a un cliente de IA. - [claude.ai](https://developers.plnnrly.com/es/docs/mcp/install/claude-ai/): Añade plnnrly a Claude en la web como conector personalizado e inicia sesión una vez, sin token. - [Claude Desktop](https://developers.plnnrly.com/es/docs/mcp/install/claude-desktop/): Añade plnnrly a la aplicación Claude Desktop como conector personalizado e inicia sesión una vez, sin token. - [Claude Code](https://developers.plnnrly.com/es/docs/mcp/install/claude-code/): Añade plnnrly a Claude Code con un comando e inicia sesión desde tu navegador, sin token. - [ChatGPT](https://developers.plnnrly.com/es/docs/mcp/install/chatgpt/): Añade plnnrly a ChatGPT como plugin de servidor MCP personalizado e inicia sesión una vez, sin token. - [Cursor](https://developers.plnnrly.com/es/docs/mcp/install/cursor/): Añade plnnrly a la aplicación de escritorio de Cursor e inicia sesión desde tu navegador, sin token. - [Gemini CLI](https://developers.plnnrly.com/es/docs/mcp/install/gemini/): Añade plnnrly a Gemini CLI de Google con un comando e inicia sesión desde tu navegador, sin token. - [Otros clientes](https://developers.plnnrly.com/es/docs/mcp/install/other-clients/): Qué necesita un cliente de IA para conectarse a plnnrly, qué ajustes usar y qué clientes aún no pueden iniciar sesión. - [Qué puedes pedir](https://developers.plnnrly.com/es/docs/mcp/examples/): Preguntas de ejemplo para un asistente de IA conectado a plnnrly, por área, con la operación de la API REST que usa cada una. - [Herramientas](https://developers.plnnrly.com/es/docs/mcp/tools/): Las cuatro herramientas del servidor MCP de plnnrly, qué acepta y qué devuelve cada una, y los límites que se aplican. - [Permisos y seguridad](https://developers.plnnrly.com/es/docs/mcp/permissions-and-safety/): Qué puede y qué no puede hacer un asistente de IA conectado a plnnrly, los dos bloqueos para eliminar y cómo cortar su acceso. - [Solución de problemas](https://developers.plnnrly.com/es/docs/mcp/troubleshooting/): Qué hacer cuando un cliente de IA no puede conectarse a plnnrly, no puede iniciar sesión o ve rechazada una petición. - [API REST](https://developers.plnnrly.com/es/docs/api/): Lee y cambia tus datos de plnnrly desde tu propio código, con un token personal o con inicio de sesión OAuth. - [Registro de cambios](https://developers.plnnrly.com/es/docs/changelog/): Qué ha cambiado en la API REST y en el servidor MCP de plnnrly en cada versión, de la más reciente a la más antigua. - [v2.8.0](https://developers.plnnrly.com/es/docs/changelog/v2-8-0/): Las aplicaciones de escritorio y de línea de comandos inician sesión con OAuth, /me devuelve el usuario en cuyo nombre actúa un token, los elementos de trabajo se mueven al tablero o a la lista de pendientes, y los contactos de emergencia solo los ve el propio empleado. - [v2.7.3](https://developers.plnnrly.com/es/docs/changelog/v2-7-3/): Los asistentes de IA que se conectaron iniciando sesión ahora tienen el mismo acceso que su usuario. - [v2.7.2](https://developers.plnnrly.com/es/docs/changelog/v2-7-2/): Los asistentes de IA se conectan iniciando sesión en lugar de con un token, tres herramientas generales llegan a todas las operaciones de la API REST y las organizaciones nuevas empiezan con MCP desactivado. - [v2.7.0](https://developers.plnnrly.com/es/docs/changelog/v2-7-0/): La API REST v2 se abre con tokens personales de API, y un administrador puede desactivar la API REST y MCP.