Skip to content

times

Accessed as client.repos.times; the async client mirrors it.

ReposTimes

The repos.times namespace.

get

get(owner: str, repo: str, user: str) -> list[TrackedTime]

List a user's tracked times in a repo.

Parameters:

Name Type Description Default
owner str

owner of the repo

required
repo str

name of the repo

required
user str

username of user

required

Returns:

Type Description
list[TrackedTime]

TrackedTimeListWithoutPagination - Tracked times for a specific user (no pagination headers).

Raises:

Type Description
BadRequestError
  1. APIError is error format response.
ForbiddenError
  1. APIForbiddenError is a forbidden error response.
NotFoundError
  1. APINotFound is a not found error response.
Deprecated

Deprecated in the vendored Spec; generated for compatibility.

Operation ID: userTrackedTimes

list

list(
    owner: str,
    repo: str,
    *,
    user: str | None = None,
    since: datetime | None = None,
    before: datetime | None = None,
    page: int | None = None,
    limit: int | None = None,
) -> Paginated[TrackedTime]

List a repo's tracked times.

Parameters:

Name Type Description Default
owner str

owner of the repo

required
repo str

name of the repo

required
user str | None

optional filter by user (available for issue managers)

None
since datetime | None

Only show times updated after the given time. This is a timestamp in RFC 3339 format

None
before datetime | None

Only show times updated before the given time. This is a timestamp in RFC 3339 format

None
page int | None

1-based page to start iteration at.

None
limit int | None

Page size; the instance caps it server-side.

None

Returns:

Type Description
Paginated[TrackedTime]

TrackedTimeList.

Raises:

Type Description
BadRequestError
  1. APIError is error format response.
ForbiddenError
  1. APIForbiddenError is a forbidden error response.
NotFoundError
  1. APINotFound is a not found error response.
UnprocessableEntityError
  1. APIValidationError is error format response related to input validation.

Operation ID: repoTrackedTimes

AsyncReposTimes

The repos.times namespace.

get

get(owner: str, repo: str, user: str) -> list[TrackedTime]

List a user's tracked times in a repo.

Parameters:

Name Type Description Default
owner str

owner of the repo

required
repo str

name of the repo

required
user str

username of user

required

Returns:

Type Description
list[TrackedTime]

TrackedTimeListWithoutPagination - Tracked times for a specific user (no pagination headers).

Raises:

Type Description
BadRequestError
  1. APIError is error format response.
ForbiddenError
  1. APIForbiddenError is a forbidden error response.
NotFoundError
  1. APINotFound is a not found error response.
Deprecated

Deprecated in the vendored Spec; generated for compatibility.

Operation ID: userTrackedTimes

list

list(
    owner: str,
    repo: str,
    *,
    user: str | None = None,
    since: datetime | None = None,
    before: datetime | None = None,
    page: int | None = None,
    limit: int | None = None,
) -> AsyncPaginated[TrackedTime]

List a repo's tracked times.

Parameters:

Name Type Description Default
owner str

owner of the repo

required
repo str

name of the repo

required
user str | None

optional filter by user (available for issue managers)

None
since datetime | None

Only show times updated after the given time. This is a timestamp in RFC 3339 format

None
before datetime | None

Only show times updated before the given time. This is a timestamp in RFC 3339 format

None
page int | None

1-based page to start iteration at.

None
limit int | None

Page size; the instance caps it server-side.

None

Returns:

Type Description
AsyncPaginated[TrackedTime]

TrackedTimeList.

Raises:

Type Description
BadRequestError
  1. APIError is error format response.
ForbiddenError
  1. APIForbiddenError is a forbidden error response.
NotFoundError
  1. APINotFound is a not found error response.
UnprocessableEntityError
  1. APIValidationError is error format response related to input validation.

Operation ID: repoTrackedTimes