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.3

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.3
File Size Uploaded
agentdrive_sdk-0.0.3.tar.gz 122.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agentdrive-sdk 0.0.3
File Interpreter ABI Platform
agentdrive_sdk-0.0.3-py3-none-any.whl Python 3 none any Details

Total release size: 379.2 kB

Release files / agentdrive_sdk-0.0.3.tar.gz

Download URL agentdrive_sdk-0.0.3.tar.gz
Size 122.0 kB
Tags Source
SHA-256 checksum
How to use checksums
5efc3cbdecbb39ee831b380e482d80040d4d3215672fb64521eb39983a545dbb
BLAKE2b-256 checksum
How to use checksums
eff7683f6b079e778c79f3090cd596b562a775b7e52ee0403de484000df7029e
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 Aug 28, 2026.

Transparency log

Release files / agentdrive_sdk-0.0.3-py3-none-any.whl

Download URL agentdrive_sdk-0.0.3-py3-none-any.whl
Size 257.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e5451aabb8c2f7ae6d9374f1c0088de22122c030ef8e1c06978c0ef9c5c3d5df
BLAKE2b-256 checksum
How to use checksums
a64098893618f1fd8714a56a07f0db87d5a5fdbacd2e931dcb27d770eca65203
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 Aug 28, 2026.

Transparency log

Release history Release notifications | RSS feed

0.0.4

2 release files

This release

0.0.3 This release

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