---
name: "fakturownia-recurrings"
description: "Fakturownia CLI recurrings: list, create, update, and delete recurring invoice definitions with README-backed request and output discovery."
metadata:
  bundle: "fakturownia"
  category: "api-area"
  prerequisite: "fakturownia-shared"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-invoices"
    - "fakturownia-schema"
    - "fakturownia-doctor"
  command_refs:
    - "recurring list"
    - "recurring create"
    - "recurring update"
    - "recurring delete"
  cli_help: "fakturownia recurring --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Use `fakturownia schema recurring list --json` and `fakturownia schema recurring create --json` before building selectors or payloads, and `recurring delete --dry-run --json` before destructive cleanup."
---

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

# Recurrings

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

## Use This Skill When

- The task is about recurring invoice definitions rather than concrete invoice documents.
- You need README-backed `request_body_schema` guidance for recurring creation or next-date updates.

## Covered Commands

- `fakturownia recurring list` — List recurring invoice definitions
- `fakturownia recurring create` — Create a recurring invoice definition
- `fakturownia recurring update` — Update a recurring invoice definition
- `fakturownia recurring delete` — Delete a recurring invoice definition

## Notable Flags

- `--input` (required): Recurring JSON input as inline JSON, @file, or - for stdin
- `--id` (required): Recurring definition ID
- `--yes` (required, default `false`): Confirm recurring definition 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 recurring list --json` to inspect README-backed recurring output fields such as `name`, `every`, and `next_invoice_date`.
- Use `fakturownia schema recurring create --json` and `fakturownia schema recurring 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 `recurring` envelope.

## Recipes

- [fakturownia-recurring-definition](../../recipes/recurring-definition/SKILL.md): Manage recurring invoice definitions through the dedicated recurring noun.

## Examples

```bash
fakturownia recurring list --json
fakturownia recurring list --columns id,name,every,next_invoice_date,send_email
fakturownia recurring list --raw
fakturownia recurring create --input '{"name":"Nazwa cyklicznosci","invoice_id":1,"start_date":"2016-01-01","every":"1m","send_email":true}' --json
fakturownia recurring create --input '{"name":"Nazwa cyklicznosci","invoice_id":1,"every":"1m"}' --dry-run --json
fakturownia recurring update --id 111 --input '{"next_invoice_date":"2016-02-01"}' --json
fakturownia recurring update --id 111 --input '{"next_invoice_date":"2016-02-01"}' --dry-run --json
fakturownia recurring delete --id 111 --yes --json
fakturownia recurring delete --id 111 --yes --dry-run --json
```

## Related Skills

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