---
name: "fakturownia-categories"
description: "Fakturownia CLI categories: list, fetch, create, update, and delete categories, and inspect README-backed category fields and request schemas."
metadata:
  bundle: "fakturownia"
  category: "api-area"
  prerequisite: "fakturownia-shared"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-schema"
    - "fakturownia-doctor"
  command_refs:
    - "category list"
    - "category get"
    - "category create"
    - "category update"
    - "category delete"
  cli_help: "fakturownia category --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Use `fakturownia schema category list --json` for output fields and `fakturownia schema category create --json` or `category update --json` for request-body discovery."
---

> Auto-generated by `go run ./cmd/gen-skills`. Do not edit manually.

# Categories

> **PREREQUISITE:** Read [`fakturownia-shared`](../shared/SKILL.md) first.

## Use This Skill When

- The task is about reading or mutating categories.
- You need to inspect README-backed category fields before creating or updating category payloads.

## Covered Commands

- `fakturownia category list` — List categories
- `fakturownia category get` — Fetch a single category by ID
- `fakturownia category create` — Create a category
- `fakturownia category update` — Update a category
- `fakturownia category delete` — Delete a category

## Notable Flags

- `--page` (default `1`): Requested result page
- `--per-page` (default `25`): Requested result count per page
- `--id` (required): Category ID
- `--input` (required): Category JSON input as inline JSON, @file, or - for stdin
- `--yes` (required, default `false`): Confirm category deletion

## Environment

- `FAKTUROWNIA_PROFILE`: Select a profile unless --profile is provided
- `FAKTUROWNIA_URL`: Override the base account URL from any profile
- `FAKTUROWNIA_API_TOKEN`: Override the API token from any profile

## Output and Request Discovery

- Use `fakturownia schema category list --json` and `fakturownia schema category get --json` before building selectors.
- Read `output.known_fields` to discover README-backed category output fields such as `name` and `description`.
- Use `fakturownia schema category create --json` and `fakturownia schema category update --json` to inspect `request_body_schema` and accepted `--input` modes.
- `--input` accepts inline JSON, `@file`, or `-` for stdin, and the CLI wraps the inner object into the upstream `category` envelope.

## Examples

```bash
fakturownia category list --json
fakturownia category list --columns id,name,description
fakturownia category list --page 2 --per-page 25 --raw
fakturownia category get --id 100
fakturownia category get --id 100 --fields id,name,description --json
fakturownia category get --id 100 --raw
fakturownia category create --input '{"name":"my_category","description":null}' --json
fakturownia category create --input @category.json
printf '%s\n' '{"name":"my_category"}' | fakturownia category create --input - --json
fakturownia category create --input '{"name":"my_category"}' --dry-run --json
fakturownia category update --id 100 --input '{"description":"new_description"}' --json
fakturownia category update --id 100 --input @category-update.json
fakturownia category update --id 100 --input '{"name":"my_category"}' --dry-run --json
fakturownia category delete --id 100 --yes --json
fakturownia category delete --id 100 --yes
fakturownia category delete --id 100 --yes --dry-run --json
```

## Related Skills

- [fakturownia-shared](../shared/SKILL.md)
- [fakturownia-schema](../schema/SKILL.md)
- [fakturownia-doctor](../doctor/SKILL.md)