/ 
WWW-Gitea-0.001
/ WWW::Gitea::API::Orgs

NAME

WWW::Gitea::API::Orgs - Gitea organizations API

VERSION

version 0.001

SYNOPSIS

my $org   = $gitea->orgs->get('perl-modules');
my $repos = $gitea->orgs->repos('perl-modules');
my $mine  = $gitea->orgs->list;          # authenticated user's orgs

DESCRIPTION

Controller for the Gitea organizations API. Reached via $gitea->orgs. Organizations are addressed by their org name.

client

The parent WWW::Gitea client providing HTTP transport.

openapi_operations

Pre-computed operation table (operationId → {method, path}).

get

my $org = $gitea->orgs->get('perl-modules');

Fetches an organization by name. Returns a WWW::Gitea::Org.

create

my $org = $gitea->orgs->create(
    username => 'my-org', full_name => 'My Organization',
    visibility => 'public',
);

Creates an organization. username (the org name) is required; other arguments are passed through as the JSON body. Returns a WWW::Gitea::Org.

edit

$gitea->orgs->edit('my-org', description => 'Now with more Perl');

Edits an organization. Arguments are passed through as the JSON body. Returns the updated WWW::Gitea::Org.

delete

$gitea->orgs->delete('my-org');

Deletes an organization. Returns a true value on success.

repos

my $repos = $gitea->orgs->repos('perl-modules');

Lists an organization's repositories. Accepts pagination query parameters (page, limit). Returns an ArrayRef of WWW::Gitea::Repo.

list

my $orgs = $gitea->orgs->list;

Lists the organizations the authenticated user belongs to (GET /user/orgs). Returns an ArrayRef of WWW::Gitea::Org.

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://codeberg.org/getty/p5-www-gitea/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.