import { CodeBlock } from '../views/docs/CodeBlock';
import { Callout } from '../views/docs/prose';

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