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
- AgenticModeAccessResponse
- ApiSearchResponse
- ApiSearchResponseAffectedComponentVersion
- ApiSearchResponseComponentDetailDocument
- ApiSearchResponseComponentDocument
- ApiSearchResponseVulnerabilityDocument
- BillingDTO
- BulkOnboardRequest
- BulkOnboardResponse
- BulkRemoveMembersRequest
- ComponentDetailDocument
- ComponentDocument
- ComponentReportGet
- ComponentReportPost
- CreateTokenRequest
- CumulativeCreditUsage
- DailyCreditUsage
- DashboardPageResponse
- DashboardRowResponse
- DtsDimensions
- EffectiveConfigYamlResponse
- FromVersion
- GovernanceWriteResponse
- InviteUsersRequest
- Invoice
- ItemProgress
- JobProgress
- LatestVersionRequest
- MethodSignature
- OnboardingAccessResponse
- OnboardingBannerStatusDTO
- OrgActivityLogEntry
- OrgActivityLogResponse
- OrgConfigRequest
- OrgGovernanceView
- OrgOnboardingActivity
- OrganizationDTO
- OrganizationMembersResponse
- OssiMonthlyUsage
- OssiUsageDataRange
- OssiUsageHistoryDTO
- OssiUsageSummary
- OssiVulnerabilityGet
- OssiVulnerabilityPost
- PeriodDTO
- PlanDTO
- PolicyCompliance
- PolicyConditionResult
- PurlRequestPost
- RecommendationRequest
- RecommendationResponse
- RecommendationVulnerableMethod
- RecommendedVersion
- Reference
- RemovalPrResult
- RepoConfigRequest
- RepoGovernanceView
- RotateTokenRequest
- SecurityEventDetailDocument
- UpdateOrganizationRequest
- UsageDTO
- UserTokenDTO
- UserTokenWithPlaintextDTO
- VulnerabilityDetailDocument
- VulnerabilityDocument
- VulnerableMethod
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
Metadata
Release files for sonatype-guide-api-client 1.202609.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sonatype_guide_api_client-1.202609.1.tar.gz | 89.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sonatype_guide_api_client-1.202609.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 258.7 kB
Release files / sonatype_guide_api_client-1.202609.1.tar.gz
| Download URL | sonatype_guide_api_client-1.202609.1.tar.gz |
|---|---|
| Size | 89.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
684cd4ea715bc31afad2d7161767977b9d0db82b3bc1cdf08838b6a63eec5a60
|
|
BLAKE2b-256 checksum How to use checksums |
f0f2272712025b350ebcb1485746f8f5ae85df8901c2258e374ace49134b1eda
|
| 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 14, 2026.
Transparency logRelease files / sonatype_guide_api_client-1.202609.1-py3-none-any.whl
| Download URL | sonatype_guide_api_client-1.202609.1-py3-none-any.whl |
|---|---|
| Size | 169.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9afe30bc0f395c85dcc8d1160d25978672f4571876287e575fb99be854eee710
|
|
BLAKE2b-256 checksum How to use checksums |
0fac4a10d292ca5bd00007b1b9c3bdae532156dda9ccdb8c122a1e76bf754873
|
| 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 14, 2026.
Transparency log