Skip to main content

agent-push-kit

The complete Agent Push Kit REST API. Application event ingestion uses an organization key beginning with apk_. Authenticated user operations accept either an Agent Push Kit login JWT or an agent access token beginning with apt_.

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

  • API version: 0.1.0
  • Package version: 0.1.0
  • Generator version: 7.24.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://agentpushkit.com

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/JustinBStrong/agent-push-kit-python.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/JustinBStrong/agent-push-kit-python.git)

Then import the package:

import agent_push_kit

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 agent_push_kit

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import agent_push_kit
from agent_push_kit.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.chatdna.co/agent-push-kit/v1
# See configuration.py for a list of all supported configuration parameters.
configuration = agent_push_kit.Configuration(
    host = "https://api.chatdna.co/agent-push-kit/v1"
)

# 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 (Agent Push Kit JWT or apt_ token): UserOrAgent
configuration = agent_push_kit.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)


# Enter a context with an instance of the API client
with agent_push_kit.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = agent_push_kit.AccountApi(api_client)

    try:
        # Delete the current user and customer accounts they own
        api_response = api_instance.delete_current_account()
        print("The response of AccountApi->delete_current_account:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling AccountApi->delete_current_account: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.chatdna.co/agent-push-kit/v1

Class Method HTTP request Description
AccountApi delete_current_account DELETE /me Delete the current user and customer accounts they own
AccountApi get_current_account GET /me Get the current user and customer accounts
AgentTokensApi call_mcp POST /mcp Connect through stateless MCP Streamable HTTP
AgentTokensApi create_agent_token POST /agent-tokens Create a named non-expiring agent token
AgentTokensApi list_agent_tokens GET /agent-tokens List agent access tokens without their secrets
AgentTokensApi revoke_agent_token DELETE /agent-tokens/{tokenId} Revoke one of the current user's agent tokens
AuthenticationApi complete_password_reset POST /auth/password-reset/complete Choose a new password and log in
AuthenticationApi login_with_apple POST /auth/apple Log in or attach an account using a Sign in with Apple identity token
AuthenticationApi login_with_google POST /auth/google Log in or attach an account using a verified Google ID token
AuthenticationApi login_with_password POST /auth/login Log in with email and password
AuthenticationApi register POST /auth/register Create a user and first customer account
AuthenticationApi request_password_reset POST /auth/password-reset/request Email a single-use password reset token
CustomerAccountsApi add_organization_member POST /organizations/{organizationId}/members Add an already-registered user to a customer account
CustomerAccountsApi create_organization POST /organizations Create another Agent Push Kit customer account
CustomerAccountsApi list_organization_members GET /organizations/{organizationId}/members List members of a customer account
CustomerAccountsApi list_organizations GET /organizations List customer accounts available to the current user
CustomerAccountsApi regenerate_organization_api_key POST /organizations/{organizationId}/api-key/regenerate Rotate the application event-ingestion key
DevicesApi get_web_push_configuration GET /web-push/configuration Get browser push availability and its public VAPID key
DevicesApi register_device POST /devices Register or refresh an APNs device
DevicesApi register_web_push_subscription POST /web-push/subscriptions Register or refresh a browser push subscription
DevicesApi remove_device DELETE /devices/{installationId} Disable push delivery to one installation
DevicesApi remove_web_push_subscription DELETE /web-push/subscriptions/{subscriptionId} Disable a browser push subscription
EventsApi get_event GET /organizations/{organizationId}/events/{eventId} Get one event including metadata
EventsApi list_events GET /organizations/{organizationId}/events List a paginated inbox
EventsApi list_notification_types GET /organizations/{organizationId}/types List distinct notification types
EventsApi list_services GET /organizations/{organizationId}/services List services discovered from ingested events
EventsApi search_events POST /organizations/{organizationId}/events/search Search events with a validated Boolean filter tree
EventsApi send_event POST /events Send an event using an application ingestion key
EventsApi send_event_as_user POST /organizations/{organizationId}/events Send an event as an authenticated user or agent
HealthApi get_health GET /health Check Agent Push Kit API health
PreferencesApi list_preferences GET /organizations/{organizationId}/preferences List service defaults and exact-type overrides
PreferencesApi remove_type_preference DELETE /services/{serviceId}/types/{type}/preference Remove an exact-type override so it inherits the service default
PreferencesApi set_service_preference PUT /services/{serviceId}/preference Enable or disable pushes for a service by default
PreferencesApi set_type_preference PUT /services/{serviceId}/types/{type}/preference Override push delivery for one exact notification type

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

UserOrAgent

  • Type: Bearer authentication (Agent Push Kit JWT or apt_ token)

AgentToken

  • Type: Bearer authentication (apt_)

OrganizationApiKey

  • Type: Bearer authentication (apk_)

Author

Metadata

Release files for agent-push-kit 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-push-kit 0.1.0
File Size Uploaded Provenance Actions
agent_push_kit-0.1.0.tar.gz 63.5 kB Without provenance Details for agent_push_kit-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agent-push-kit 0.1.0
File Interpreter ABI Platform Actions
agent_push_kit-0.1.0-py3-none-any.whl Python 3 none any Details for agent_push_kit-0.1.0-py3-none-any.whl

Total release size: 194.0 kB

Release files / agent_push_kit-0.1.0.tar.gz

Download URL agent_push_kit-0.1.0.tar.gz
Size 63.5 kB
Tags Source
SHA-256 checksum
How to use checksums
d90163d9e3938c9adb6bb60a217bdd037a97ad89e3f24832e84574ee46a13974
BLAKE2b-256 checksum
How to use checksums
39ea58d46d71a37b396ff5602381fe6dc5a12c1ad50c7143d54af26bf7153b53
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release files / agent_push_kit-0.1.0-py3-none-any.whl

Download URL agent_push_kit-0.1.0-py3-none-any.whl
Size 130.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5c8f0de093974060306a4317c9f2067c9538d03850695b7949e070427e0baa07
BLAKE2b-256 checksum
How to use checksums
15e938e08efd0aa28c9a208b17fc19aacf83814a25a84ed2ed2ecfad86d299d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Security for agent-push-kit 0.1.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

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