Create a tagging category
An admin creates a tagging type (category) with typed fields. The category and field keys are stable slugs (immutable). Access and approvers are configured through separate endpoints.
curl -X POST "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/operation-categories" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"key": "virt_asset_sale",
"name": "John Doe",
"description": "example_string",
"emoji": "example_string",
"color": "example_string",
"appliesTo": "transfer",
"viewScope": "owner_only",
"assignScope": "owner_only",
"editScope": "owner_only",
"approvalScope": "none",
"approvalThreshold": 42,
"allowInitiatorApproval": true,
"fields": [
{
"key": "sale_rate",
"label": "example_string",
"type": "text",
"required": true,
"optionsJson": [
{
"value": "example_string",
"label": "example_string"
}
],
"scale": 42,
"currencyFieldKey": "ticker",
"unit": "example_string",
"defaultJson": "null",
"helpText": "example_string",
"sensitive": true,
"orderIndex": 42
}
]
}'
import requests
import json
url = "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/operation-categories"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
"key": "virt_asset_sale",
"name": "John Doe",
"description": "example_string",
"emoji": "example_string",
"color": "example_string",
"appliesTo": "transfer",
"viewScope": "owner_only",
"assignScope": "owner_only",
"editScope": "owner_only",
"approvalScope": "none",
"approvalThreshold": 42,
"allowInitiatorApproval": true,
"fields": [
{
"key": "sale_rate",
"label": "example_string",
"type": "text",
"required": true,
"optionsJson": [
{
"value": "example_string",
"label": "example_string"
}
],
"scale": 42,
"currencyFieldKey": "ticker",
"unit": "example_string",
"defaultJson": "null",
"helpText": "example_string",
"sensitive": true,
"orderIndex": 42
}
]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/operation-categories", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
},
body: JSON.stringify({
"key": "virt_asset_sale",
"name": "John Doe",
"description": "example_string",
"emoji": "example_string",
"color": "example_string",
"appliesTo": "transfer",
"viewScope": "owner_only",
"assignScope": "owner_only",
"editScope": "owner_only",
"approvalScope": "none",
"approvalThreshold": 42,
"allowInitiatorApproval": true,
"fields": [
{
"key": "sale_rate",
"label": "example_string",
"type": "text",
"required": true,
"optionsJson": [
{
"value": "example_string",
"label": "example_string"
}
],
"scale": 42,
"currencyFieldKey": "ticker",
"unit": "example_string",
"defaultJson": "null",
"helpText": "example_string",
"sensitive": true,
"orderIndex": 42
}
]
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"key": "virt_asset_sale",
"name": "John Doe",
"description": "example_string",
"emoji": "example_string",
"color": "example_string",
"appliesTo": "transfer",
"viewScope": "owner_only",
"assignScope": "owner_only",
"editScope": "owner_only",
"approvalScope": "none",
"approvalThreshold": 42,
"allowInitiatorApproval": true,
"fields": [
{
"key": "sale_rate",
"label": "example_string",
"type": "text",
"required": true,
"optionsJson": [
{
"value": "example_string",
"label": "example_string"
}
],
"scale": 42,
"currencyFieldKey": "ticker",
"unit": "example_string",
"defaultJson": "null",
"helpText": "example_string",
"sensitive": true,
"orderIndex": 42
}
]
}`)
req, err := http.NewRequest("POST", "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/operation-categories", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/operation-categories')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request.body = '{
"key": "virt_asset_sale",
"name": "John Doe",
"description": "example_string",
"emoji": "example_string",
"color": "example_string",
"appliesTo": "transfer",
"viewScope": "owner_only",
"assignScope": "owner_only",
"editScope": "owner_only",
"approvalScope": "none",
"approvalThreshold": 42,
"allowInitiatorApproval": true,
"fields": [
{
"key": "sale_rate",
"label": "example_string",
"type": "text",
"required": true,
"optionsJson": [
{
"value": "example_string",
"label": "example_string"
}
],
"scale": 42,
"currencyFieldKey": "ticker",
"unit": "example_string",
"defaultJson": "null",
"helpText": "example_string",
"sensitive": true,
"orderIndex": 42
}
]
}'
response = http.request(request)
puts response.body
{
"id": "cmr3f41z20001psp7phmyapw3",
"vaultId": "example_string",
"key": "example_string",
"name": "John Doe",
"description": "example_string",
"emoji": "example_string",
"color": "example_string",
"appliesTo": "transfer",
"viewScope": "owner_only",
"assignScope": "owner_only",
"editScope": "owner_only",
"approvalScope": "none",
"approvalThreshold": 42,
"allowInitiatorApproval": true,
"isSystem": true,
"archived": true,
"version": 42,
"createdById": "example_string",
"updatedById": "example_string",
"createdAt": "2026-07-02T11:25:15.134000Z",
"updatedAt": "2026-07-02T11:25:15.134000Z",
"fields": [
{
"id": "cmr3f41z20001psp7phmyapw3",
"categoryId": "example_string",
"key": "example_string",
"label": "example_string",
"type": "text",
"required": true,
"optionsJson": [
{
"value": "example_string",
"label": "example_string"
}
],
"scale": 42,
"currencyFieldKey": "example_string",
"unit": "example_string",
"defaultJson": "null",
"helpText": "example_string",
"sensitive": true,
"orderIndex": 42,
"archived": true,
"createdAt": "2026-07-02T11:25:15.134000Z",
"updatedAt": "2026-07-02T11:25:15.134000Z"
}
],
"grants": [
{
"id": "cmr3f41z20001psp7phmyapw3",
"vaultId": "example_string",
"categoryId": "example_string",
"subjectType": "user",
"subjectUserId": "example_string",
"subjectGroupId": "example_string",
"canView": true,
"canAssign": true,
"canEdit": true,
"grantorId": "example_string",
"status": "example_string",
"createdAt": "2026-07-02T11:25:15.134000Z"
}
],
"approvers": [
{
"id": "cmr3f41z20001psp7phmyapw3",
"categoryId": "example_string",
"kind": "user",
"userId": "example_string",
"groupId": "example_string",
"createdAt": "2026-07-02T11:25:15.134000Z"
}
]
}
{
"error": "Bad Request",
"message": "The request contains invalid parameters or malformed data",
"code": 400,
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
{
"error": "Conflict",
"message": "The request conflicts with the current state of the resource",
"code": 409,
"details": "Resource already exists"
}
{
"error": "Internal Server Error",
"message": "An unexpected error occurred on the server",
"code": 500,
"requestId": "req_1234567890"
}
/api/v1/vaults/{code}/operation-categoriesTarget server for requests. Edit to use your own host.
Session token. Mobile/services. The web uses a cookie.
API key (sent in cookie)
Unique Vault code (slug)
The media type of the request body
Stable category slug (immutable)
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Session token. Mobile/services. The web uses a cookie.
API Key for authentication. Provide your API key in the cookie.
Path Parameters
Body
transferdepositbothowner_onlyvault_membersrestrictedowner_onlyvault_membersrestrictedowner_onlyvault_membersrestrictednoneeditassign_and_edit