## 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

```
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:

```
{
  "deprecation_status": "supported"
}
```

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

Questions? [hi@goguava.ai](mailto:hi@goguava.ai)