Skip to main content

sonatype-guide-api-client

REST API into Sonatype Guide.

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 202609
  • Package version: 1.0.0
  • Generator version: 7.16.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://github.com/sonatype-nexus-community

Requirements.

Python 3.9+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/sonatype-nexus-community/sonatype-guide-api-client.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/sonatype-nexus-community/sonatype-guide-api-client.git)

Then import the package:

import sonatype_guide_api_client

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import sonatype_guide_api_client

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import sonatype_guide_api_client
from sonatype_guide_api_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.guide.sonatype.com
# See configuration.py for a list of all supported configuration parameters.
configuration = sonatype_guide_api_client.Configuration(
    host = "https://api.guide.sonatype.com"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization (JWT): bearer-jwt
configuration = sonatype_guide_api_client.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)


# Enter a context with an instance of the API client
with sonatype_guide_api_client.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = sonatype_guide_api_client.AGPBulkOnboardingApi(api_client)

    try:
        # Get the caller's currently-running bulk onboarding job, if any
        api_response = api_instance.active()
        print("The response of AGPBulkOnboardingApi->active:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling AGPBulkOnboardingApi->active: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.guide.sonatype.com

Class Method HTTP request Description
AGPBulkOnboardingApi active GET /api/agp/onboarding/bulk/active Get the caller's currently-running bulk onboarding job, if any
AGPBulkOnboardingApi org_activity GET /api/agp/onboarding/bulk/org-activity Whether another org member currently has a bulk onboarding job in flight
AGPBulkOnboardingApi progress GET /api/agp/onboarding/bulk/{jobId} Get bulk onboarding job progress
AGPBulkOnboardingApi start POST /api/agp/onboarding/bulk Start bulk onboarding for selected repositories
AGPDashboardApi candidate_ids GET /api/agp/dashboard/candidate-ids Ids of all onboarding-candidate repositories matching the name filter
AGPDashboardApi dashboard GET /api/agp/dashboard List connected repositories with status (search, filter & paging)
AGPDashboardApi onboarding_access GET /api/agp/dashboard/onboarding-access Whether the caller may onboard repositories
AGPGovernanceApi agentic_mode_access GET /api/agp/agentic-mode-access Whether the caller's org is registered for AgentP agentic mode (org-scoped; gates the AI Fix toggle + AI agent config in the UI)
AGPGovernanceApi delete_repo_config DELETE /api/agp/repos/{installationRepoId}/config Reset a repo to the Default Configuration by clearing its config overrides (any org member)
AGPGovernanceApi get_org_config GET /api/agp/org/config Get the AgentP Default Configuration (read: any org member)
AGPGovernanceApi get_org_effective_config GET /api/agp/org/effective-config Get the rendered Default Configuration agp.yml (defaults + org) (Owner-only)
AGPGovernanceApi get_repo_config GET /api/agp/repos/{installationRepoId}/config Get a repo's AgentP config overrides + inherited Default Configuration + version (any org member)
AGPGovernanceApi get_repo_effective_config GET /api/agp/repos/{installationRepoId}/effective-config Get the rendered effective agp.yml for a repo (defaults + org + overrides) (any org member)
AGPGovernanceApi open_removal_pr POST /api/agp/repos/{installationRepoId}/removal-pr Open (and optionally merge) a PR removing the AgentP workflow file from a repository (any org member)
AGPGovernanceApi pause POST /api/agp/repos/{installationRepoId}/pause Pause AgentP for a repository (any org member)
AGPGovernanceApi resume POST /api/agp/repos/{installationRepoId}/resume Resume AgentP for a repository (any org member)
AGPGovernanceApi update_org_config PUT /api/agp/org/config Set the AgentP Default Configuration + developer-access flag (Owner-only)
AGPGovernanceApi update_repo_config PUT /api/agp/repos/{installationRepoId}/config Set per-repo AgentP config overrides (any org member)
ActivityLogApi get_activity_log GET /users/me/organization/activity-log Get organization activity log
BillingApi get_billing GET /billing Get billing information
BillingApi get_invoice_pdf GET /billing/invoices/{invoiceId}/pdf Download invoice PDF
BillingApi get_plans GET /billing/plans Get all available plans
BillingApi get_user_invoice_history GET /billing/invoices Get user invoice history
ComponentsApi get_component_dependencies_by_purl_query_param GET /components/dependencies Get dependencies for a component by coordinates (query parameters)
ComponentsApi get_component_detail_by_purl_query_param GET /components/detail Get component detail by coordinates (query parameters)
ComponentsApi get_component_versions_by_purl_query_param GET /components/versions Get all component versions by coordinates (query parameters)
ComponentsApi get_component_vulnerabilities_by_purl_query_param GET /components/vulnerabilities Get vulnerabilities for a component by coordinates (query parameters)
ComponentsApi get_latest_version POST /components/latest-version Get latest version of a component
CurrentUserOrganizationApi accept_invitation POST /users/me/organization/invitations/{invitationToken}/accept Accept organization invitation
CurrentUserOrganizationApi bulk_remove_members_or_invitations DELETE /users/me/organization/members Bulk remove members or invitations from organization
CurrentUserOrganizationApi dismiss_onboarding_banner DELETE /users/me/organization/onboarding-banner Dismiss onboarding banner
CurrentUserOrganizationApi get_current_user_organization GET /users/me/organization Get current user's organization
CurrentUserOrganizationApi get_onboarding_banner_status GET /users/me/organization/onboarding-banner Get onboarding banner status
CurrentUserOrganizationApi invite_users POST /users/me/organization/members/invite Invite users to current user's an organization
CurrentUserOrganizationApi leave_organization DELETE /users/me/organization/membership Leave organization
CurrentUserOrganizationApi remove_member_or_invitation DELETE /users/me/organization/members/{email} Remove member or invitation from organization
CurrentUserOrganizationApi retrieve_organization_members_as_csv GET /users/me/organization/members Retrieve current user's organization members and invitees
CurrentUserOrganizationApi update_organization PUT /users/me/organization Update current user's organization
CurrentUserTokensApi create_token POST /users/me/tokens Create a new Personal Access Token
CurrentUserTokensApi get_token_by_id GET /users/me/tokens/{tokenId} Get a Personal Access Token by ID
CurrentUserTokensApi list_tokens GET /users/me/tokens List all Personal Access Tokens
CurrentUserTokensApi revoke_token DELETE /users/me/tokens/{tokenId} Revoke a Personal Access Token
CurrentUserTokensApi rotate_token POST /users/me/tokens/{tokenId}/rotate Rotate a Personal Access Token
OSSIndexCompatibilityApi get_component_report GET /api/v3/authorized/component-report/** Get component report by PURL
OSSIndexCompatibilityApi get_component_report1 GET /api/v3/component-report/** Get component report by PURL
OSSIndexCompatibilityApi get_component_reports POST /api/v3/component-report Get component reports for multiple PURLs
OSSIndexCompatibilityApi get_component_reports1 POST /api/v3/authorized/component-report Get component reports for multiple PURLs
OSSIndexCompatibilityApi get_version GET /api/v3/version Get API version
RecommendationsApi get_recommendations POST /recommendations Get version upgrade recommendations
SecurityEventsApi get_security_event_affected_components GET /security-events/{id}/affected-components Get affected components for a security event
SecurityEventsApi get_security_event_by_id GET /security-events/{id} Get security event by ID
UsageApi get_credit_periods GET /usage/credit-periods Get credit periods
UsageApi get_cumulative_usage GET /usage/cumulative Get cumulative credit usage for a billing period
UsageApi get_ossi_usage_history GET /usage/ossi-history Get historical OSSI usage
UsageApi get_usage GET /usage Get usage information
VulnerabilitiesApi get_vulnerability_affected_components GET /vulnerabilities/{id}/components Get affected components for a vulnerability
VulnerabilitiesApi get_vulnerability_by_ref_id GET /vulnerabilities/{id} Get vulnerability by ID

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

bearer-jwt

  • Type: Bearer authentication (JWT)

ossi-basic-auth

  • Type: HTTP basic authentication

user-token

  • Type: Bearer authentication

Author

community@sonatype.com

Metadata

Release files for sonatype-guide-api-client 1.202609.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sonatype-guide-api-client 1.202609.0
File Size Uploaded
sonatype_guide_api_client-1.202609.0.tar.gz 89.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sonatype-guide-api-client 1.202609.0
File Interpreter ABI Platform
sonatype_guide_api_client-1.202609.0-py3-none-any.whl Python 3 none any Details

Total release size: 258.2 kB

Release files / sonatype_guide_api_client-1.202609.0.tar.gz

Download URL sonatype_guide_api_client-1.202609.0.tar.gz
Size 89.4 kB
Tags Source
SHA-256 checksum
How to use checksums
b9ad917274b667cc603f59814192339062609c17959ba10de1eccd251f036317
BLAKE2b-256 checksum
How to use checksums
57f9f0b0cfa3bb87ea218a635833563c598b48c8b70a0ecb2f334a54535d5b1f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

Release files / sonatype_guide_api_client-1.202609.0-py3-none-any.whl

Download URL sonatype_guide_api_client-1.202609.0-py3-none-any.whl
Size 168.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
84cd28ea103ff29f5015c27072028a7d6639f5843a3b707dda128eae34099ce3
BLAKE2b-256 checksum
How to use checksums
37ff21b0b3a1b33b55fd5068d6bc4550fa6b0adfde7b2dd883e941768057ebc1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page