Skip to content

POST /position

Create Position

POST
/position

Create a new warehouse position.

Inserts a new Position document and links it to its parent via the
is_in_position edge collection within a single ArangoDB transaction.
Auto-generates a positional code from the system counter if code is omitted.

Emits: (direct transaction — no event class)
Required scope: inventory:position:create

Authorizations

OAuth2PasswordBearer
password Flow
Token URL"/api/auth"
Scopes:
  • "admin"User can access and edit users and system settings
  • "library"User can access and edit products
  • "production"User can access and edit production plans
  • "operator"User can access the operator panel and make production declarations

Request Body

application/json
JSON
{
  
"parent_position_key": "IN",
  
"code": "LOCATION-A1-01",
  
"owned": true,
  
"available": true,
  
"fixed": true,
  
"disposable": false,
  
"allow_consumption": true,
  
"extra": "string"
}

Responses

Successful Response

application/json
JSON
{
  
"status": 200,
  
"message": "string",
  
"detail": "string"
}

Samples

Powered by VitePress OpenAPI

Released under the Apache 2.0 License.