---
name: "Pithub::Repos::Statuses"
section: "3pm"
platform: "linux"
package: "libpithub-perl"
version: "0.01043-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Pithub::Repos::Statuses"
---

# Pithub::Repos::Statuses(3pm)

Github v3 repos / statuses API

## NAME

Pithub::Repos::Statuses - Github v3 repos / statuses API

## VERSION

version 0.01043

## METHODS

### list

Extra arguments

- •

  ref

  The SHA, branch, or tag-name to get statuses for

List statuses for a ref

```
    GET /repos/:user/:repo/statuses/:ref
```

Examples:

```
    my $statuses = Pithub::Repos::Statuses->new;
    my $result   = $statuses->list( ref => 'master' );
```

### create

Extra arguments

- state (required)

  The state of the status. Can be one of 'pending', 'success', 'error' or 'failure'.

- target\_url

  This URL will be used to link from the status to some related page, for instance the build result for this specific SHA.

- description

  A short description of the status

Add a status to a SHA.

```
    POST /repos/:user/:repo/statuses/:sha
```

Examples:

```
    my $statuses = Pithub::Repos::Statuses->new;
    my $result   = $statuses->create( user => 'plu', repo => 'Pithub',
        sha => '0123456',
        data => {
            state => 'error',
            description => 'Build failed',
            target_url => 'https://travis-ci.org/some/url/0123456',
        },
    );
```

## AUTHOR

Johannes Plunien \<plu@cpan.org\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Johannes Plunien.

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