# Feature OP-18875 - Rename "Enable REST web service" setting

Project: OpenProject
Status: closed
URL: https://community.openproject.org/work_packages/OP-18875

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 17.2.0 |
| Sprint | 17.2.0 |
| Backlog bucket |  |
| Votes |  |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

_No work packages_

## Bugs and other work packages

_No work packages_

## Technical Details

| Attribute | Value |
| --- | --- |
| Module | Authentication, Authentication / Basic Auth, API |
| Feature Flag |  |
| Requires doc change | Yes |
| Enterprise plan |  |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Feature Lead |  |
| Developers | Jan Sandbrink |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

**As** an administrator  
**I want to** rename the setting "Enable REST web service"  
**so that** I have clarity on what the setting is actually doing.

**Context**

This setting is probably very old and might at some point have meant what's written on the tin, but this is not the case anymore. It's not possible to disable the APIv3 of OpenProject, because it's a core component of OpenProject. Without APIv3, OpenProject would not work properly.

After looking into what this setting actually does, my conclusion is, that it effectively enables or disables the usage of (personal) API tokens. It has **no effect on**:

  - Accessing the APIv3 anonymously

  - Accessing the APIv3 authenticated via Session auth

  - Accessing the APIv3 via OAuth tokens issued by OpenProject

  - Accessing the APIv3 via tokens issued through OpenID Connect providers

**Acceptance criteria**

  - The setting "Enable REST web service" is renamed to "Enable personalized API tokens"

  - The description text explains how and for which APIs (not only APIv3) these tokens can be used

**Technical notes**

  - We should also rename the internal name `rest_api_enabled` accordingly
