agentdrive-sdk 0.0.1

AgentDrive

agentdrive-sdk

AgentDrive is an agent-focused artifact store: upload by path, share by rendered URL, address by stable permalink. The REST surface is documented here; the rendered viewer + agent claim flow live under agentdrive.run.

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

• API version: 0.0.1
• Package version: 0.0.1
• Generator version: 7.23.0
• Build package: org.openapitools.codegen.languages.PythonClientCodegen

Requirements.

Python 3.10+

Installation & Usage

pip install

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

pip install git+https://github.com/Mnexa-AI/agentdrive-sdk.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/Mnexa-AI/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://api.agentdrive.run
# See configuration.py for a list of all supported configuration parameters.
configuration = agentdrive_sdk.Configuration(
    host = "https://api.agentdrive.run"
)



# 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.AgentAuthApi(api_client)
    extension_exchange_request = agentdrive_sdk.ExtensionExchangeRequest() # ExtensionExchangeRequest | 

    try:
        # Redeem an extension OAuth ticket for a JWT pair
        api_response = api_instance.extension_exchange_v0_auth_extension_exchange_post(extension_exchange_request)
        print("The response of AgentAuthApi->extension_exchange_v0_auth_extension_exchange_post:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling AgentAuthApi->extension_exchange_v0_auth_extension_exchange_post: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.agentdrive.run

Class	Method	HTTP request	Description
AgentAuthApi	extension_exchange_v0_auth_extension_exchange_post	POST /v0/auth/extension/exchange	Redeem an extension OAuth ticket for a JWT pair
AgentAuthApi	initiate_claim_agent_identity_claim_post	POST /agent/identity/claim	Initiate the human-claim ceremony for an agent identity
AgentAuthApi	jwks_well_known_jwks_json_get	GET /.well-known/jwks.json	JSON Web Key Set — public keys for verifying AgentDrive JWTs
AgentAuthApi	oauth2_token_oauth2_token_post	POST /oauth2/token	Exchange a credential for an access_token
AgentAuthApi	oauth_authorization_server_well_known_oauth_authorization_server_get	GET /.well-known/oauth-authorization-server	Authorization-server metadata (RFC 8414 + auth.md agent_auth block)
AgentAuthApi	oauth_protected_resource_mcp_well_known_oauth_protected_resource_mcp_get	GET /.well-known/oauth-protected-resource/mcp	Protected-resource metadata for the MCP endpoint (RFC 9728 §3.1)
AgentAuthApi	oauth_protected_resource_well_known_oauth_protected_resource_get	GET /.well-known/oauth-protected-resource	Protected-resource metadata (auth.md / RFC 9728-like discovery)
AgentAuthApi	register_agent_identity_agent_identity_post	POST /agent/identity	Register an agent identity (anonymous or ID-JAG)
ClaimUiApi	claim_complete_agent_identity_claim_complete_post	POST /agent/identity/claim/complete	Claim Complete
ClaimUiApi	claim_page_claim_get	GET /claim	Claim Page
DefaultApi	activity_feed_activity_get	GET /activity	Activity Feed
DefaultApi	artifact_detail_preview_preview_artifact_detail_get	GET /preview/artifact-detail	Artifact Detail Preview
DefaultApi	callback_auth_callback_get	GET /auth/callback	Callback
DefaultApi	cancel_job_v0_jobs_job_id_cancel_post	POST /v0/jobs/{job_id}/cancel	Cancel a queued/running job
DefaultApi	collection_detail_collections_slug_get	GET /collections/{slug}	Collection Detail
DefaultApi	connectors_page_connectors_get	GET /connectors	Connectors Page
DefaultApi	copy_artifact_route_v0_artifacts_art_id_copy_post	POST /v0/artifacts/{art_id}/copy	Duplicate an artifact to a new path (CAS-shared, new ID)
DefaultApi	create_folder_by_path_v0_folders_path_post	POST /v0/folders/{path}	Create a folder (idempotent)
DefaultApi	danger_zone_old_dashboard_danger_get	GET /dashboard/danger	Danger Zone Old
DefaultApi	danger_zone_settings_danger_get	GET /settings/danger	Danger Zone
DefaultApi	dashboard_dashboard_get	GET /dashboard	Dashboard
DefaultApi	delete_account_web_account_delete_post	POST /web/account/delete	Delete Account
DefaultApi	delete_artifact_v0_artifacts_path_delete	DELETE /v0/artifacts/{path}	Delete Artifact
DefaultApi	delete_drive_route_v0_drives_drive_id_delete	DELETE /v0/drives/{drive_id}	Soft-delete the authenticated drive
DefaultApi	delete_folder_by_id_v0_folders_fld_id_delete	DELETE /v0/folders/{fld_id}	Soft-delete a folder by stable ID (cascade with ?recursive=true)
DefaultApi	delete_folder_by_path_v0_folders_path_delete	DELETE /v0/folders/{path}	Soft-delete a folder (cascade with ?recursive=true)
DefaultApi	delete_key_web_keys_delete_post	POST /web/keys/delete	Delete Key
DefaultApi	download_artifact_by_id_v0_artifacts_art_id_download_get	GET /v0/artifacts/{art_id}/download	Stream the artifact bytes by stable ID (never rendered HTML)
DefaultApi	download_artifact_version_v0_artifacts_art_id_versions_version_number_download_get	GET /v0/artifacts/{art_id}/versions/{version_number}/download	Stream bytes for a specific version (machine surface)
DefaultApi	edit_artifact_a_art_id_edit_get	GET /a/{art_id}/edit	Edit Artifact
DefaultApi	enqueue_job_v0_projects_fld_id_jobs_post	POST /v0/projects/{fld_id}/jobs	Enqueue a compile job for a project (folder)
DefaultApi	extension_start_auth_extension_start_get	GET /auth/extension/start	Extension Start
DefaultApi	feedback_form_feedback_get	GET /feedback	Feedback Form
DefaultApi	feedback_submit_feedback_post	POST /feedback	Feedback Submit
DefaultApi	find_v0_find_get	GET /v0/find	Hybrid passage retrieval over the full file body
DefaultApi	get_artifact_by_id_meta_v0_artifacts_art_id_meta_get	GET /v0/artifacts/{art_id}/meta	Artifact metadata by stable ID (same shape as path /meta)
DefaultApi	get_artifact_by_id_v0_artifacts_art_id_get	GET /v0/artifacts/{art_id}	Canonical lookup of an artifact by its stable ID
DefaultApi	get_artifact_meta_v0_artifacts_path_meta_get	GET /v0/artifacts/{path}/meta	Get Artifact Meta
DefaultApi	get_artifact_version_v0_artifacts_art_id_versions_version_number_get	GET /v0/artifacts/{art_id}/versions/{version_number}	Metadata for a specific version of an artifact
DefaultApi	get_feedback_status_v0_feedback_fbk_id_get	GET /v0/feedback/{fbk_id}	Get Feedback Status
DefaultApi	get_folder_by_id_meta_v0_folders_fld_id_meta_get	GET /v0/folders/{fld_id}/meta	Folder metadata by stable ID (same shape as the bare id route)
DefaultApi	get_folder_by_id_v0_folders_fld_id_get	GET /v0/folders/{fld_id}	Canonical lookup of a folder by its stable ID
DefaultApi	get_folder_by_path_v0_folders_path_get	GET /v0/folders/{path}	Read folder metadata by path
DefaultApi	get_job_logs_v0_jobs_job_id_logs_get	GET /v0/jobs/{job_id}/logs	Raw compile log (text/plain)
DefaultApi	get_job_v0_jobs_job_id_get	GET /v0/jobs/{job_id}	Poll a job
DefaultApi	get_project_v0_projects_fld_id_get	GET /v0/projects/{fld_id}	Get a project's compile config
DefaultApi	health_health_get	GET /health	Health
DefaultApi	list_artifact_versions_v0_artifacts_art_id_versions_get	GET /v0/artifacts/{art_id}/versions	List versions of an artifact, newest first
DefaultApi	list_artifacts_v0_artifacts_get	GET /v0/artifacts	List artifacts in the drive
DefaultApi	list_events_route_v0_events_get	GET /v0/events	Read the append-only event log for the authenticated drive
DefaultApi	list_project_jobs_v0_projects_fld_id_jobs_get	GET /v0/projects/{fld_id}/jobs	List a project's jobs
DefaultApi	list_trash_route_v0_drives_drive_id_trash_get	GET /v0/drives/{drive_id}/trash	List the authenticated drive's trash
DefaultApi	login_auth_login_get	GET /auth/login	Login
DefaultApi	logout_auth_logout_post	POST /auth/logout	Logout
DefaultApi	marketing_get	GET /	Marketing
DefaultApi	marketplace_browse_marketplace_get	GET /marketplace	Marketplace Browse
DefaultApi	marketplace_detail_marketplace_slug_get	GET /marketplace/{slug}	Marketplace Detail
DefaultApi	me_usage_v0_drives_me_usage_get	GET /v0/drives/me/usage	Current-period usage + caps for the authenticated drive
DefaultApi	me_v0_drives_me_get	GET /v0/drives/me	Me
DefaultApi	move_folder_by_id_v0_folders_fld_id_move_post	POST /v0/folders/{fld_id}/move	Rename / move a folder by stable ID (cascade descendants)
DefaultApi	move_folder_by_path_v0_folders_path_move_post	POST /v0/folders/{path}/move	Rename / move a folder (cascade-update descendants)
DefaultApi	oauth_disconnect_web_oauth_disconnect_post	POST /web/oauth/disconnect	Oauth Disconnect
DefaultApi	patch_folder_by_id_v0_folders_fld_id_patch	PATCH /v0/folders/{fld_id}	Update folder metadata by stable ID
DefaultApi	patch_folder_by_path_v0_folders_path_patch	PATCH /v0/folders/{path}	Update folder metadata by path
DefaultApi	post_feedback_v0_feedback_post	POST /v0/feedback	Post Feedback
DefaultApi	privacy_page_privacy_get	GET /privacy	Privacy Page
DefaultApi	project_preview_page_f_fld_id_preview_get	GET /f/{fld_id}/preview	Project Preview Page
DefaultApi	publisher_profile_publishers_handle_get	GET /publishers/{handle}	Publisher Profile
DefaultApi	put_artifact_v0_artifacts_path_put	PUT /v0/artifacts/{path}	Upload (or overwrite) an artifact
DefaultApi	put_project_v0_projects_fld_id_put	PUT /v0/projects/{fld_id}	Set a project's compile config (entrypoint/engine/auto_compile)
DefaultApi	recovery_new_account_auth_recovery_new_account_post	POST /auth/recovery/new-account	Recovery New Account
DefaultApi	recovery_new_account_expired_auth_recovery_new_account_expired_get	GET /auth/recovery/new-account-expired	Recovery New Account Expired
DefaultApi	recovery_page_auth_recovery_get	GET /auth/recovery	Recovery Page
DefaultApi	recovery_restore_auth_recovery_restore_post	POST /auth/recovery/restore	Recovery Restore
DefaultApi	rename_artifact_route_v0_artifacts_art_id_patch	PATCH /v0/artifacts/{art_id}	Rename / move an artifact to a new path
DefaultApi	restore_artifact_v0_artifacts_art_id_restore_post	POST /v0/artifacts/{art_id}/restore	Restore a soft-deleted artifact
DefaultApi	restore_drive_route_v0_drives_drive_id_restore_post	POST /v0/drives/{drive_id}/restore	Restore a soft-deleted drive
DefaultApi	rotate_key_web_keys_rotate_post	POST /web/keys/rotate	Rotate Key
DefaultApi	search_v0_search_get	GET /v0/search	Full-text search over artifacts in the drive
DefaultApi	settings_account_settings_get	GET /settings	Settings Account
DefaultApi	settings_api_keys_settings_api_keys_get	GET /settings/api-keys	Settings Api Keys
DefaultApi	settings_quickstart_settings_quickstart_get	GET /settings/quickstart	Settings Quickstart
DefaultApi	settings_usage_settings_usage_get	GET /settings/usage	Settings Usage
DefaultApi	shared_files_shared_get	GET /shared	Shared Files
DefaultApi	stream_upload_v0_upload_token_put	PUT /v0/upload/{token}	Proxied streaming upload (via an upload_url token)
DefaultApi	terms_page_terms_get	GET /terms	Terms Page
DefaultApi	toggle_indexing_web_account_indexing_post	POST /web/account/indexing	Toggle Indexing
DefaultApi	trash_web_trash_get	GET /web/trash	Trash
DefaultApi	view_file_drive_id_path_get	GET /{drive_id}/{path}	View File
DefaultApi	view_permalink_artifact_a_art_id_get	GET /a/{art_id}	View Permalink Artifact
DefaultApi	view_permalink_folder_f_fld_id_get	GET /f/{fld_id}	View Permalink Folder
DefaultApi	web_artifact_indexed_web_artifacts_indexed_get	GET /web/artifacts/indexed	Web Artifact Indexed
DefaultApi	web_copy_artifact_web_artifacts_copy_post	POST /web/artifacts/copy	Web Copy Artifact
DefaultApi	web_delete_artifact_op_web_artifacts_delete_post	POST /web/artifacts/delete	Web Delete Artifact Op
DefaultApi	web_delete_artifact_web_artifacts_path_delete	DELETE /web/artifacts/{path}	Web Delete Artifact
DefaultApi	web_delete_folder_web_folders_delete_post	POST /web/folders/delete	Web Delete Folder
DefaultApi	web_move_folder_web_folders_move_post	POST /web/folders/move	Web Move Folder
DefaultApi	web_new_folder_web_folders_new_post	POST /web/folders/new	Web New Folder
DefaultApi	web_project_compile_web_projects_fld_id_compile_post	POST /web/projects/{fld_id}/compile	Web Project Compile
DefaultApi	web_project_files_web_projects_fld_id_files_get	GET /web/projects/{fld_id}/files	Web Project Files
DefaultApi	web_project_preview_web_projects_fld_id_preview_get	GET /web/projects/{fld_id}/preview	Web Project Preview
DefaultApi	web_put_artifact_web_artifacts_path_put	PUT /web/artifacts/{path}	Web Put Artifact
DefaultApi	web_rename_artifact_web_artifacts_rename_post	POST /web/artifacts/rename	Web Rename Artifact
DefaultApi	web_restore_artifact_web_artifacts_restore_post	POST /web/artifacts/restore	Web Restore Artifact
DefaultApi	web_restore_folder_web_folders_restore_post	POST /web/folders/restore	Web Restore Folder
DefaultApi	web_set_metadata_web_set_post	POST /web/set	Web Set Metadata
DefaultApi	web_upload_web_upload_post	POST /web/upload	Web Upload
DefaultApi	webhooks_page_webhooks_get	GET /webhooks	Webhooks Page
DefaultApi	welcome_welcome_get	GET /welcome	Welcome
McpOauthApi	oauth2_register_oauth2_register_post	POST /oauth2/register	Dynamic Client Registration (RFC 7591)
McpOauthApi	oauth2_revoke_oauth2_revoke_post	POST /oauth2/revoke	Token revocation (RFC 7009)
McpOauthUiApi	authorize_decision_oauth2_authorize_post	POST /oauth2/authorize	Authorize Decision
McpOauthUiApi	authorize_page_oauth2_authorize_get	GET /oauth2/authorize	Authorize Page

Documentation For Models

• AnonymousIdentityResponse
• ArtifactOut
• ArtifactSource
• ClaimInitRequest
• ClaimInitResponse
• ClaimMetadata
• CompileJobIn
• CompileOptions
• CopyIn
• EventOut
• EventPage
• ExtensionExchangeRequest
• ExtensionExchangeResponse
• FindHitOut
• FindPage
• FolderCreateIn
• FolderDeleteOut
• FolderMoveIn
• FolderOut
• FolderPatchIn
• HTTPValidationError
• LocationInner
• Page
• ProjectConfigIn
• RenameIn
• SearchHitOut
• SearchPage
• SourceRef
• TokenResponse
• ValidationError
• VersionOut
• VersionPage

Documentation For Authorization

Endpoints do not require authorization.

Author