Skip to main content

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

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)

Source distribution for agentdrive-sdk 0.0.4
File Size Uploaded
agentdrive_sdk-0.0.4.tar.gz 123.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agentdrive-sdk 0.0.4
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

0.0.4 This release

2 release files

0.0.3

2 release files

0.0.1

2 release files

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