---
name: "fakturownia-accounts"
description: "Fakturownia CLI accounts: create, inspect, delete, and unlink system accounts using the README-backed account contract, with sanitized structured output and optional profile persistence."
metadata:
  bundle: "fakturownia"
  category: "core"
  prerequisite: "fakturownia-shared"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-auth"
    - "fakturownia-schema"
    - "fakturownia-doctor"
  command_refs:
    - "account create"
    - "account get"
    - "account delete"
    - "account unlink"
  cli_help: "fakturownia account --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Use `fakturownia schema account create --json` before building full account request objects, and prefer structured output unless you explicitly need `--raw` to inspect returned secrets."
---

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

# Accounts

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

## Use This Skill When

- The task is about system-account creation, inspection, deletion, or unlinking partner-linked accounts.
- You need to work with the full top-level `account` request shape rather than the CLI's usual inner-object `--input` contract.

## Covered Commands

- `fakturownia account create` — Create a system account from the full upstream request object
- `fakturownia account get` — Fetch current system-account metadata
- `fakturownia account delete` — Request deletion of the current system account
- `fakturownia account unlink` — Unlink system accounts from a partner integration

## Notable Flags

- `--input` (required): Full account request JSON as inline JSON, @file, or - for stdin
- `--save-as`: Persist the returned credentials under this profile name
- `--integration-token`: Integration token used when requesting the current api_token
- `--yes` (required, default `false`): Confirm account deletion request
- `--prefix` (required): Account prefix to unlink; may be repeated or comma-separated

## 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 account get --json` to inspect sanitized account output fields such as `prefix`, `url`, `login`, `email`, and `api_token_present`.
- Use `fakturownia schema account create --json` before building the full top-level account request object.
- Unlike most CRUD nouns, `account create` accepts the full upstream request object, including top-level `account`, `user`, `company`, and optional `integration_token`.
- Structured output is sanitized and omits the raw returned API token; use `--raw` only when you explicitly need the exact upstream response.

## Examples

```bash
fakturownia account create --input '{"account":{"prefix":"acme"},"user":{"login":"owner","email":"owner@example.com","password":"secret"},"company":{"name":"Acme"}}' --json
fakturownia account create --input @account-create.json --save-as acme
fakturownia account create --input @account-create.json --dry-run --json
fakturownia account get --json
fakturownia account get --integration-token PARTNER_TOKEN
fakturownia account get --raw
fakturownia account delete --yes --json
fakturownia account delete --yes --dry-run --json
fakturownia account unlink --prefix acme --json
fakturownia account unlink --prefix acme --prefix beta --integration-token PARTNER_TOKEN
fakturownia account unlink --prefix acme,beta --dry-run --json
```

## Related Skills

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