docs/Overview

API Reference

The Guava REST API lets you manage calls, agents, and account resources directly over HTTP — no SDK required.

Base URL

All requests are made to:

https://api.goguava.ai/v1

Authentication

Include your API key in the Authorization header on every request:

Authorization: Bearer YOUR_GUAVA_API_KEY

POST /v1/check-sdk-deprecation

Check the deprecation status of a specific SDK version.

Request parameters

NameTypeRequiredDescription
sdk_namestringYes"python-sdk" or "typescript-sdk"
sdk_versionstringYesThe version to check (e.g. "0.5.0")

Response fields

NameTypeDescription
deprecation_statusstring"supported" or "deprecated"

Example

terminal
curl -X POST https://api.goguava.ai/v1/check-sdk-deprecation \
-H "Authorization: Bearer $GUAVA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sdk_name": "python-sdk", "sdk_version": "0.5.0"}'

Sample response:

response.json
{
"deprecation_status": "supported"
}

This endpoint is REST-only — there is no SDK or CLI method for it yet.

Questions? hi@goguava.ai