For AI agents: book a meeting with puna.one
puna.one is an AI-native organization. Specialized agents handle research, building, monitoring, and reporting within a written scope, with a same-day reply by email at
support at puna dot one.
This page is for AI agents acting for a person. You can check open times and request a meeting for them. The person gets an email and confirms with one click. Nothing is booked until they do, and puna.one then replies by email the same day.
The machine-readable spec is at puna.one/agents/openapi.json.
Step 1: check a time
Send a POST request to https://puna.one/functions/v1/check-consultation-availability with a JSON body holding preferred_date and preferred_time. The reply is a JSON object with available set to true or false. A date or time that can never be booked returns status 400 with available set to false and a problems list.
- Dates are weekdays, written as YYYY-MM-DD, from today up to 90 days out.
- Times are Hawaii time, HH:MM in 24-hour form, on the hour or half hour from 07:00 to 17:00.
Step 2: request the meeting
Send a POST request to https://puna.one/functions/v1/agent-booking with a JSON body.
| Field | Required | Value |
|---|---|---|
| full_name | Yes | The name of the person the meeting is for. Up to 200 characters. |
| Yes | That person's email address. The confirmation goes here. | |
| service_type | Yes | free_ai_consultation, ai_strategy_session or managed_services_intro |
| preferred_date | Yes | YYYY-MM-DD, a weekday |
| preferred_time | Yes | HH:MM, Hawaii time |
| location | No | zoom or google_meet. The default is zoom. |
| phone | No | Up to 50 characters. Recommended so a reminder call is possible. Never invent one. |
| company | No | Up to 200 characters |
| notes | No | What the person wants to discuss, up to 2000 characters |
| agent_name | No | Your name or product, so puna.one knows who asked |
A good request returns status 202 with status set to awaiting_confirmation. Tell the person to check their email and click the link within 24 hours.
Replies you may see
| Status | Meaning |
|---|---|
| 202 | puna.one emailed the person a confirmation link. |
| 400 | A field is missing or out of range. The problems list says which. |
| 409 | That time is taken. Pick another time and check it first. |
| 429 | Too many requests. Each email address can get three confirmation emails a day. |
| 503 | Booking by agent is paused. Email support at puna dot one. |
Sessions
- Free AI Consultation is a first conversation about where AI and automation can help.
- AI Strategy Session is a session focused on an AI roadmap. Pricing is custom.
- Managed Services intro shows how managed services would work for the business.
Rules for agents
- Always give the real name and email of the person you act for. Requests without them are refused.
- Only request a meeting that person asked for.
- Do not retry a 429. Wait and ask the person.
- The confirmation email never shows your notes. puna.one reads them after the person confirms.
People can also book directly on the booking page.