api overview.md
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
| Name | Type | Required | Description |
|---|---|---|---|
| sdk_name | string | Yes | "python-sdk" or "typescript-sdk" |
| sdk_version | string | Yes | The version to check (e.g. "0.5.0") |
Response fields
| Name | Type | Description |
|---|---|---|
| deprecation_status | string | "supported" or "deprecated" |
Example
<CodeBlock
filename="terminal"
language="bash"
code={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:
<CodeBlock
filename="response.json"
language="json"
code={{ "deprecation_status": "supported" }}/>