XPipe LogoXPipe Documentation
HTTP API

Add new category

Creates a new empty category in the vault. New categories always need a parent as it's not allowed to create root categories.

POST
/category/add

Authorization

AuthorizationRequiredBearer <token>

The bearer token used is the session token that you receive from the handshake exchange.

In: header

Request Body

application/jsonRequired
nameRequiredstring

The category name

parentRequiredstring

The parent category uuid to put the new category in

curl -X POST "http://localhost:21721/category/add" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my category",
    "parent": "97458c07-75c0-4f9d-a06e-92d8cdf67c40"
  }'

The request was successful. The category was added.

{
  "summary": "Category information",
  "value": {
    "category": "36ad9716-a209-4f7f-9814-078d3349280c"
  }
}

Edit on GitHub

Previous

HTTP API

Next

Add new connection