# system.kanoa.tooling.setPositionRetired(toolingPositionId, isRetired, userId)

Retires a position (out of service for good, e.g. a cavity welded shut) or brings it back into service. Unlike a blocked position, a retired one leaves the standard rate: while the tool is mounted, the change takes effect from now and a new run starts if it changes the machine's rate. The position keeps its history. A pocket holding a tool can't be retired.

---

### Parameters

**toolingPositionId** `Integer`: The position<br />

**isRetired** `Boolean`: True to retire, False to bring it back into service<br />

**userId** `Integer`: The user making the change<br />

---

### Returns

**(1 if it changed or 0 if it was already so, message)**<br />

---

### Example

```python
toolingPositionId = 1
isRetired = True
userId = 5
result1, result2 = system.kanoa.tooling.setPositionRetired(toolingPositionId, isRetired, userId)
```
