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
- AcceptedResponse
- AddMemberInput
- AgentToken
- AgentTokenCreated
- ApiKeySummary
- AuthResponse
- CreateAgentTokenInput
- CreateOrganizationInput
- CurrentAccount
- DeletedResponse
- DeliverySummary
- Device
- DisabledResponse
- ErrorResponse
- EventDetail
- EventFilter
- EventPage
- EventSummary
- FilterGroup
- FilterNot
- HealthResponse
- IngestionResult
- InheritedResponse
- Membership
- MembershipUser
- Organization
- OrganizationApiKeyCreated
- OrganizationCount
- OrganizationCreated
- OrganizationRecord
- PasswordLoginInput
- PasswordResetCompleteInput
- PasswordResetRequestInput
- PreferenceRecord
- ProviderLoginInput
- RegisterDeviceInput
- RegisterInput
- RegisterWebPushSubscriptionInput
- RegisterWebPushSubscriptionInputKeys
- RevokedResponse
- SearchEventsInput
- SendEventInput
- Service
- ServiceAllOfCount
- ServicePreference
- ServiceSummary
- SetEnabledInput
- TextFilterCondition
- TimeFilterCondition
- TypeOverride
- User
- WebPushConfiguration
- WebPushSubscription
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d90163d9e3938c9adb6bb60a217bdd037a97ad89e3f24832e84574ee46a13974
|
|
| MD5 |
fa8bec7c8ac881b409d91072def9d646
|
|
| BLAKE2b-256 |
39ea58d46d71a37b396ff5602381fe6dc5a12c1ad50c7143d54af26bf7153b53
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5c8f0de093974060306a4317c9f2067c9538d03850695b7949e070427e0baa07
|
|
| MD5 |
13fe7fcb4e85726f5d0ba1cab863bc53
|
|
| BLAKE2b-256 |
15e938e08efd0aa28c9a208b17fc19aacf83814a25a84ed2ed2ecfad86d299d2
|