Airship REST API

What authentication does the Airship REST API use?

Airship uses HTTP Basic auth: the username is the Airship app key and the password is the master secret. Through Jentic, both values are stored encrypted and the Authorization header is constructed at execution time so the master secret never enters the agent context.

Can I send a push to a specific named user?

Yes. POST /push with an audience selector of { 'named_user': '<user_id>' } targets every channel associated with that named-user ID. Use POST /named_users/associate first to link channels to the user.

What are the rate limits for the Airship REST API?

Airship applies per-app rate limits in the range of hundreds of requests per second for push and lower for management endpoints. Exact limits vary by plan; consult docs.airship.com. Treat HTTP 429 as a backoff-and-retry signal.

How do I send a push notification through Jentic?

Install with pip install jentic, search for 'send a push notification', load the Airship POST /push operation, and execute with the audience and notification fields. Jentic injects the Basic auth header at execution time.

Can I validate a push payload before sending it?

Yes. POST /push/validate runs the same validation as POST /push without dispatching to devices. Useful in CI pipelines and during template iteration to catch malformed audience selectors or platform overrides early.

Can I limit what my agent is allowed to do with the Airship REST API?

Yes. Because your Jentic One instance is self-hosted, you set the rules for which Airship operations and credentials your agent can use. Airship carries its audience and tag targets in the request body, so you scope the agent by operation: grant only the calls it needs, such as POST /push to send notifications or POST /channels/tags to tag channels, and withhold operations like POST /named_users/disassociate that it never uses. The Airship app key and master secret are injected at execution time under your own rules, so the agent only ever exercises the operations you allow.