NextGen APIs

PATCH /work-orders/permits/r1/types/{permitTypeId}

Http Verb

PATCH

Url

/work-orders/permits/r1/types/{permitTypeId}

Permissions required

Permits Edit Configuration Permission:

fsm.core.wopermit.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 permit type 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. description must include required multi-language values.

  4. code must be unique among existing permit types, excluding the same permit type being updated (same id).

  5. If blocker is not provided, it is defaulted to false.

When all validations pass, the permit type is updated in persistence.

Path Parameters

Field

Note

permitTypeId

The permit type Id to update

Query String Parameters

None

Header Parameters

Default.

Request Body

Field

Validations

Note

code

Optional


description

Optional


institute

Optional


blocker

Optional


active

Optional


Response documentation

Response payload fields

No content.

Response error codes

BASE_0001, BASE_0007, BASE_0010