agentdrive-sdk
AgentDrive is an agent-focused artifact store: drive-scoped folders, artifacts, and immutable versions, with local grants, possession-based share links, drive-scoped search, and a cursor-resumable change feed. Bearer-authenticated with Hub-issued product tokens (see /.well-known/oauth-protected-resource); every mutation takes an Idempotency-Key, and existing-state mutations take If-Match.
This Python package is automatically generated by the OpenAPI Generator project:
- API version: <PINNED>
- Package version: 0.0.1
- Generator version: 7.16.0
- Build package: org.openapitools.codegen.languages.PythonClientCodegen
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/tokencanopy/agentdrive-sdk.git
(you may need to run pip with root permission: sudo pip install git+https://github.com/tokencanopy/agentdrive-sdk.git)
Then import the package:
import agentdrive_sdk
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 agentdrive_sdk
Tests
Execute pytest to run the tests.
Getting Started
Please follow the installation procedure and then run the following:
import agentdrive_sdk
from agentdrive_sdk.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://drive.tokencanopy.com
# See configuration.py for a list of all supported configuration parameters.
configuration = agentdrive_sdk.Configuration(
host = "https://drive.tokencanopy.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): bearerAuth
configuration = agentdrive_sdk.Configuration(
access_token = os.environ["BEARER_TOKEN"]
)
# Enter a context with an instance of the API client
with agentdrive_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = agentdrive_sdk.ArtifactsApi(api_client)
drive_id = 'drive_id_example' # str |
artifact_id = 'artifact_id_example' # str |
if_none_match = 'if_none_match_example' # str | (optional)
authorization = 'authorization_example' # str | Deprecated: redundant with the operation's `bearerAuth` security requirement, which is how a generated client should learn to authenticate. Scheduled for removal. (optional)
try:
# Read Artifact Content
api_response = api_instance.artifacts_content(drive_id, artifact_id, if_none_match=if_none_match, authorization=authorization)
print("The response of ArtifactsApi->artifacts_content:\n")
pprint(api_response)
except ApiException as e:
print("Exception when calling ArtifactsApi->artifacts_content: %s\n" % e)
Documentation for API Endpoints
All URIs are relative to https://drive.tokencanopy.com
| Class | Method | HTTP request | Description |
|---|---|---|---|
| ArtifactsApi | artifacts_content | GET /v0/drives/{drive_id}/artifacts/{artifact_id}/content | Read Artifact Content |
| ArtifactsApi | artifacts_copy | POST /v0/drives/{drive_id}/artifacts/{artifact_id}/copy | Copy Artifact |
| ArtifactsApi | artifacts_create | POST /v0/drives/{drive_id}/artifacts | Create Artifact |
| ArtifactsApi | artifacts_delete | DELETE /v0/drives/{drive_id}/artifacts/{artifact_id} | Delete Artifact |
| ArtifactsApi | artifacts_list | GET /v0/drives/{drive_id}/artifacts | List Artifacts |
| ArtifactsApi | artifacts_read | GET /v0/drives/{drive_id}/artifacts/{artifact_id} | Read Artifact |
| ArtifactsApi | artifacts_restore | POST /v0/drives/{drive_id}/artifacts/{artifact_id}/restore | Restore Artifact |
| ArtifactsApi | artifacts_update | PATCH /v0/drives/{drive_id}/artifacts/{artifact_id} | Update Artifact |
| ChangesApi | changes_list | GET /v0/drives/{drive_id}/changes | List Changes |
| DefaultApi | health | GET /health | Health |
| DiscoveryApi | oauth_protected_resource | GET /.well-known/oauth-protected-resource | Protected-resource metadata (RFC 9728) |
| DownloadsApi | download_capabilities_create | POST /v0/drives/{drive_id}/download-capabilities | Create Download Capability |
| DrivesApi | drives_create | POST /v0/drives | Create Drive |
| DrivesApi | drives_delete | DELETE /v0/drives/{drive_id} | Delete Drive |
| DrivesApi | drives_list | GET /v0/drives | List Drives |
| DrivesApi | drives_read | GET /v0/drives/{drive_id} | Read Drive |
| DrivesApi | drives_restore | POST /v0/drives/{drive_id}/restore | Restore Drive |
| DrivesApi | drives_update | PATCH /v0/drives/{drive_id} | Update Drive |
| DrivesApi | drives_usage | GET /v0/drives/{drive_id}/usage | Drive Usage |
| FoldersApi | folders_copy | POST /v0/drives/{drive_id}/folders/{folder_id}/copy | Copy Folder |
| FoldersApi | folders_create | POST /v0/drives/{drive_id}/folders | Create Folder |
| FoldersApi | folders_delete | DELETE /v0/drives/{drive_id}/folders/{folder_id} | Delete Folder |
| FoldersApi | folders_list | GET /v0/drives/{drive_id}/folders | List Folders |
| FoldersApi | folders_read | GET /v0/drives/{drive_id}/folders/{folder_id} | Read Folder |
| FoldersApi | folders_restore | POST /v0/drives/{drive_id}/folders/{folder_id}/restore | Restore Folder |
| FoldersApi | folders_update | PATCH /v0/drives/{drive_id}/folders/{folder_id} | Update Folder |
| GrantsApi | grants_create | POST /v0/drives/{drive_id}/grants | Create Grant |
| GrantsApi | grants_list | GET /v0/drives/{drive_id}/grants | List Grants |
| GrantsApi | grants_read | GET /v0/drives/{drive_id}/grants/{grant_id} | Read Grant |
| GrantsApi | grants_revoke | DELETE /v0/drives/{drive_id}/grants/{grant_id} | Revoke Grant |
| GrantsApi | grants_update | PATCH /v0/drives/{drive_id}/grants/{grant_id} | Update Grant |
| NavigationApi | entries_list | GET /v0/drives/{drive_id}/entries | List Entries |
| NavigationApi | lookup | GET /v0/drives/{drive_id}/lookup | Lookup |
| SearchApi | drive_search | GET /v0/drives/{drive_id}/search | Drive Search |
| SharesApi | shares_create | POST /v0/drives/{drive_id}/shares | Create Share |
| SharesApi | shares_list | GET /v0/drives/{drive_id}/shares | List Shares |
| SharesApi | shares_read | GET /v0/drives/{drive_id}/shares/{share_id} | Read Share |
| SharesApi | shares_revoke | DELETE /v0/drives/{drive_id}/shares/{share_id} | Revoke Share |
| SharesApi | shares_rotate | POST /v0/drives/{drive_id}/shares/{share_id}/rotate | Rotate Share |
| SharesRedemptionApi | shares_redeem | GET /s/{share_key} | Redeem Share |
| UploadsApi | uploads_complete | POST /v0/drives/{drive_id}/uploads/{upload_id}/complete | Complete Upload |
| UploadsApi | uploads_create | POST /v0/drives/{drive_id}/uploads | Begin Upload |
| UploadsApi | uploads_delete | DELETE /v0/drives/{drive_id}/uploads/{upload_id} | Cancel Upload |
| UploadsApi | uploads_read | GET /v0/drives/{drive_id}/uploads/{upload_id} | Read Upload |
| VersionsApi | versions_append | POST /v0/drives/{drive_id}/artifacts/{artifact_id}/versions | Append Version |
| VersionsApi | versions_content | GET /v0/drives/{drive_id}/artifacts/{artifact_id}/versions/{version_id}/content | Read Version Content |
| VersionsApi | versions_list | GET /v0/drives/{drive_id}/artifacts/{artifact_id}/versions | List Versions |
| VersionsApi | versions_read | GET /v0/drives/{drive_id}/artifacts/{artifact_id}/versions/{version_id} | Read Version |
| VersionsApi | versions_restore | POST /v0/drives/{drive_id}/artifacts/{artifact_id}/versions/{version_id}/restore | Restore Version |
| ViewerSessionsApi | viewer_sessions_create | POST /v0/drives/{drive_id}/artifacts/{artifact_id}/viewer-sessions | Create Viewer Session |
Documentation For Models
- ArtifactCopyIn
- ArtifactEntryOut
- ArtifactListOut
- ArtifactOut
- ArtifactUpdateIn
- ChangeActorOut
- ChangeOut
- ChangePageOut
- ChangeResourceOut
- DownloadCapabilitiesCreateRequest
- DownloadCapabilitiesCreateRequestTarget
- DownloadCapabilitiesCreateRequestTargetOneOf
- DownloadCapabilitiesCreateRequestTargetOneOf1
- DownloadCapabilityOut
- DownloadOut
- DownloadTargetOut
- DriveCreateIn
- DriveListOut
- DriveOut
- DriveUpdateIn
- DriveUsageOut
- EntriesInner
- EntryListOut
- ErrorResponse
- ErrorResponseError
- FolderCascadeOut
- FolderCopyIn
- FolderCreateIn
- FolderEntryOut
- FolderListOut
- FolderOut
- FolderUpdateIn
- GrantCreateIn
- GrantListOut
- GrantOut
- GrantUpdateIn
- HealthDegradedDetail
- HealthDegradedResponse
- HealthOut
- LookupOut
- SearchHitOut
- SearchPageOut
- ShareCreateIn
- ShareCreateOut
- ShareListOut
- ShareOut
- Target
- UploadBeginOut
- UploadChecksumOut
- UploadChunksOut
- UploadCleanupOut
- UploadContentOut
- UploadFailureOut
- UploadInitiationOut
- UploadOut
- UploadResultOut
- UploadSessionOut
- UploadTargetArtifactOut
- UploadTargetVersionOut
- UploadTransferOut
- UploadWithTransferOut
- UploadsCreateRequest
- UploadsCreateRequestContent
- UploadsCreateRequestContentChecksum
- UploadsCreateRequestTarget
- UploadsCreateRequestTargetOneOf
- UploadsCreateRequestTargetOneOf1
- V0ErrorEnvelope
- ValidationErrorResponse
- ValidationErrorResponseError
- ValidationErrorResponseErrorDetails
- ValidationErrorResponseErrorDetailsFieldsInner
- VersionCreatedOut
- VersionListOut
- VersionOut
- ViewerSessionCreateIn
- ViewerSessionCreateOut
Documentation For Authorization
Authentication schemes defined for the API:
bearerAuth
- Type: Bearer authentication (JWT)
Author
Release files for agentdrive-sdk 0.0.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agentdrive_sdk-0.0.4.tar.gz | 123.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agentdrive_sdk-0.0.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 386.6 kB
Release files / agentdrive_sdk-0.0.4.tar.gz
| Download URL | agentdrive_sdk-0.0.4.tar.gz |
|---|---|
| Size | 123.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d9926f1a10b7b9c756cd098bd5423a2f9861e23a5ee42fb4c4f55a455484c309
|
|
BLAKE2b-256 checksum How to use checksums |
b815e47c6dbd04c8d39d9c6d754e87c070b1f46da5cd070091189ddaf77b047c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 11, 2026.
Transparency logRelease files / agentdrive_sdk-0.0.4-py3-none-any.whl
| Download URL | agentdrive_sdk-0.0.4-py3-none-any.whl |
|---|---|
| Size | 262.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5a9f39d71253c66a5c2a02e6f1393908daf716540c59dcf64dc9d706bd4d6a8f
|
|
BLAKE2b-256 checksum How to use checksums |
1f2fa6610c6e30395184698b5cc401fa09ad925ff3181e2487b460aa5c3a289c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 11, 2026.
Transparency log