File Coverage

lib/Net/Upwork/API/Routers/Activities/Engagement.pm

Criterion	Covered	Total	%
statement	12	27	44.4
branch			n/a
condition			n/a
subroutine	4	8	50.0
pod	4	4	100.0
total	20	39	51.2

# Licensed under the Upwork's API Terms of Use;
# you may not use this file except in compliance with the Terms.
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# Author::    Maksym Novozhylov ([e-mail])
# Copyright:: Copyright 2015(c) Upwork.com
# License::   See LICENSE.txt and TOS - https://developers.upwork.com/api-tos.html

package Net::Upwork::API::Routers::Activities::Engagement;

use strict;
use warnings;
use parent "Net::Upwork::API";

use constant ENTRY_POINT => Net::Upwork::API::Client::ENTRY_POINT_API;

=pod

=head1 NAME

Auth

=head1 FUNCTIONS

=over 4

=item new($api)

Create a new object for accessing Auth API

B

$api

    API object

=cut

sub new {
    my ($class, $api) = @_;
    return Net::Upwork::API::init_router($class, $api, ENTRY_POINT);
}

=item get_specific

    List activities for specific engagement

B

$engagement_ref

    Engagement reference

B

    JSON response as a string

=cut

sub get_specific {
    my $self = shift;
    my $engagement_ref = shift;

    return $self->client()->get("/tasks/v2/tasks/contracts/" . $engagement_ref);
}

=item assign

    Assign engagements to the list of activities

B

$company

    Company ID

$team

    Team ID

$engagement

    Engagement

$params

    Hash of parameters

B

    JSON response as a string

=cut

sub assign {
    my $self = shift;
    my $company = shift;
    my $team = shift;
    my $engagement = shift;
    my %params = @_;

    return $self->client()->put("/otask/v1/tasks/companies/" . $company . "/" . $team . "/engagements/" . $engagement, %params);
}

=item assign_to_engagement

    Assign to specific engagement the list of activities

B

$engagement_ref

    Engagement

$params

    Hash of parameters

B

    JSON response as a string

=cut

sub assign_to_engagement {
    my $self = shift;
    my $engagement_ref = shift;
    my %params = @_;

    return $self->client()->put("/tasks/v2/tasks/contracts/" . $engagement_ref, %params);
}

=back

=head1 AUTHOR

Maksym Novozhylov C<<  >>

=head1 COPYRIGHT

Copyright E Upwork Global Corp., 2015

=cut

1;