NextGen APIs

PATCH /work-orders/permits/r1/required/{permitRequiredId}/obtained/{permitObtainedId}

Http Verb

PATCH

Url

/work-orders/permits/r1/required/{permitRequiredId}/obtained/{permitObtainedId}

Permissions required

Permits View/Edit Permission:

fsm.core.wopermit.view

fsm.core.wopermit.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 logically update a obtained permit
It enforces these rules before update. If any check fails, it returns a domain validation error.

  1. Field validation checks:

    1. Permit required not null

    2. Request date not null

  2. Validates that the permit required associated exists

  3. Work order editability – Rejects the request if:

    1. Work order status is not OPEN, RELEASED, LOCKED, PARTIALLY_ACCOUNTED, or TO_RESCHEDULE

  4. Due date must be after obtained date

Path Parameters

Field

Note

permitObtainedId

The permit obtained Id to update

Query String Parameters

None

Header Parameters

Default.

Request Body

Field

Validations

Note

practiceCode

Optional

 

notes

Optional

 

requestDate

Optional

 

obtainedDate

Optional

 

dueDate

Optional


Response documentation

Response payload fields

No content.

Response error codes

BASE_0001, BASE_0003, BASE_0006, PERMIT_0015, PERMIT_0029