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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agent_push_kit-0.1.0.tar.gz (63.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agent_push_kit-0.1.0-py3-none-any.whl (130.6 kB view details)

Uploaded Python 3

File details

Details for the file agent_push_kit-0.1.0.tar.gz.

File metadata

  • Download URL: agent_push_kit-0.1.0.tar.gz
  • Upload date:
  • Size: 63.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for agent_push_kit-0.1.0.tar.gz
Algorithm Hash digest
SHA256 d90163d9e3938c9adb6bb60a217bdd037a97ad89e3f24832e84574ee46a13974
MD5 fa8bec7c8ac881b409d91072def9d646
BLAKE2b-256 39ea58d46d71a37b396ff5602381fe6dc5a12c1ad50c7143d54af26bf7153b53

See more details on using hashes here.

File details

Details for the file agent_push_kit-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: agent_push_kit-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 130.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for agent_push_kit-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5c8f0de093974060306a4317c9f2067c9538d03850695b7949e070427e0baa07
MD5 13fe7fcb4e85726f5d0ba1cab863bc53
BLAKE2b-256 15e938e08efd0aa28c9a208b17fc19aacf83814a25a84ed2ed2ecfad86d299d2

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 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