NextGen APIs

PATCH /workforce/tools/r1/categories/{categoryId}

Http Verb

PATCH

Url

/workforce/tools/r1/categories/{categoryId}

Permissions required

Tool Edit Configuration Permission:

fsm.core.tool.configuration.edit

Personally Identifiable Information (PII)

No

Sensitive Information

No

Last Modified Version

r1

Released since

2026 W3 (FSM 24.0)

Deprecated since

 

Removed since

 

Tech Tags

 

Business Logic

This API updates an existing tool category record.
It enforces these rules before update. If any check fails, it returns a domain validation error.
Field validation checks:

  1. code is mandatory.

  2. active is mandatory.

  3. code must be unique among existing tool categories, excluding the same tool category being updated (same id).

Path Parameters

Field

Note

categoryId

The tool category Id to update

Query String Parameters

None

Header Parameters

Default.

Request Body

Field

Validations

Note

code

Optional


description

Optional


active

Optional


order

Optional


Response documentation

Response payload fields

No content.

Response error codes

BASE_0001, BASE_0010