## 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"
}`}/>

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