NextGen APIs

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

Http Verb

POST

Url

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

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 insert a obtained permit
It enforces these rules before insertion. 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

None

Query String Parameters

None

Header Parameters

Default.

Request Body

Field

Validations

Note

practiceCode


 

notes

 

 

requestDate

Not null


obtainedDate



dueDate



Response documentation

Response payload fields

Field

Note

id

Id referred to created obtained permit

Response error codes

BASE_0001, BASE_0003, BASE_0006, PERMIT_0015, PERMIT_0029