---
title: "Replace the licence key (the old one stops working)"
method: POST
path: "/editor/key"
tags: ["Dashboard"]
---

# Replace the licence key (the old one stops working)

`POST /editor/key`

## Request

- Base URL: `https://api.eu.doconda.com/v1`
- URL: `https://api.eu.doconda.com/v1/editor/key`
- Auth: HTTP bearer

## Response `200`

Editor licence.

- object
  - `plan` 'monthly' | 'yearly' | 'perpetual', nullable, required: monthly: charged every month. yearly: charged once a year. perpetual: one payment, the licence never expires.
  - `plans` object[], required: What each plan costs, VAT included.
    - `plan` 'monthly' | 'yearly' | 'perpetual', required: monthly: charged every month. yearly: charged once a year. perpetual: one payment, the licence never expires.
    - `price_eur` number, required
  - `status` 'none' | 'active' | 'past_due' | 'canceled', required: past_due: the last charge failed; it keeps working 7 days.
  - `key` string, nullable, required: The licence key for `<DocondaEditor licenseKey>`. Public: it only works on `domains`.
  - `domains` string[], required
  - `download_token` string, nullable, required: Secret: installs the plugin with `npm install <api>/v1/editor/package/<download_token>.tgz`. Each download carries a mark of the organization.
  - `renews_at` string, date-time, nullable, required
  - `trial_available` boolean, required: true: the monthly or yearly plan starts with 7 free days (one free trial per organization).
  - `trial_ends_at` string, date-time, nullable, required: While in the free trial: when it ends and the first charge is made, unless cancelled before.
  - `assistant` object, required: AI edits made with the editor's assistant this calendar month: `included` are free, each one above costs `extra_cents` from the balance.
    - `included` integer, required
    - `used` integer, required
    - `extra_cents` integer, required
    - `cap` boolean, required: true: stop at the included edits instead of paying for more.

## Other responses

- `401`: unauthorized (missing, unknown or revoked key; expired session).
- `403`: session_required: dashboard only.
- `409`: editor_inactive

---

[API](https://skmtc.dev/doconda/apis/doconda-api.md) · [All operations](https://skmtc.dev/doconda/apis/doconda-api/llms.txt) · [OpenAPI document](https://skmtc.dev/doconda/apis/doconda-api/revisions/27d29a7e8902?raw)