Planos

O que se assina: preço, periodicidade e a lista de itens que o plano entrega. As operações bulk-* agem sobre vários planos de uma vez.

Comando	HTTP	Descrição
plans list	GET /v1/plans	Listar planos
plans create	POST /v1/plans	Criar plano
plans get	GET /v1/plans/{id}	Obter plano
plans update	PATCH /v1/plans/{id}	Atualizar plano
plans delete	DELETE /v1/plans/{id}	Arquivar ou excluir plano
plans duplicate	POST /v1/plans/{id}/duplicate	Duplicar plano
plans bulk-archive create	POST /v1/plans/bulk-archive	Arquivar planos em lote
plans bulk-delete create	POST /v1/plans/bulk-delete	Excluir planos em lote
plans bulk-move-group create	POST /v1/plans/bulk-move-group	Mover planos para outro grupo em lote
plans items get	GET /v1/plans/{id}/items	Listar itens do plano
plans items update	PUT /v1/plans/{id}/items	Substituir itens do plano

Exemplos

--params carrega parâmetros de query e de caminho (id, página, filtros); --json carrega o corpo da requisição; --fields limita os campos que voltam — vale a pena em todo list/get, para economizar contexto. Veja Flags globais para a referência completa.

# Listar planos
kobana billing plans list \
  --fields "id,public_id,external_id,organization_id,company_id"

# Obter plano
kobana billing plans get --params '{"id": "PLAN_ID"}'

# Criar plano
kobana billing plans create --json '{"name": "NAME", "slug": "SLUG"}'

# Atualizar plano
kobana billing plans update \
  --params '{"id": "PLAN_ID"}' \
  --json '{"external_id": "EXTERNAL_ID", "company_id": "COMPANY_ID", "plan_group_id": "PLAN_GROUP_ID"}'

# Duplicar plano
kobana billing plans duplicate --params '{"id": "PLAN_ID"}'

# Arquivar ou excluir plano
kobana billing plans delete --params '{"id": "PLAN_ID"}' --dry-run

Próximos passos

• Grupos de planos
• Introspecção de schema — todos os parâmetros que este recurso aceita.