Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "0.5.0"
".": "0.6.0"
}
15 changes: 15 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,20 @@
# Changelog

## [0.6.0](https://github.com/tembo/sdk-python/compare/v0.5.0...v0.6.0) (2026-10-28)


### ⚠ BREAKING CHANGES

* **api:** 3 breaking changes to the SDK surface.
- Removed operation `organizations.subscriptions.reset` (`POST /v1/organizations/{organizationId}/subscriptions/reset`).
- Removed operation `users.delete` (`DELETE /v1/users/{userId}`).
- Removed operation `users.subscriptions.reset` (`POST /v1/users/{userId}/subscriptions/reset`).

### Features

* **api:** update SDK surface (10 changes) ([c77633b](https://github.com/tembo/sdk-python/commit/c77633b90e182d6d7b0d279410d6b82e436872ca))
* **api:** update SDK surface (3 changes) ([aecec17](https://github.com/tembo/sdk-python/commit/aecec170fe9b4bc13722dadbdbc08e9b662b2f90))

## [0.5.0](https://github.com/tembo/sdk-python/compare/v0.4.0...v0.5.0) (2026-10-23)


Expand Down
92 changes: 47 additions & 45 deletions api.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,6 @@ Complete reference of every operation, grouped by resource. See [the README](./R
- [Validate organization provider credentials](#validate-organization-provider-credentials)
- [`Organizations Subscriptions`](#organizations-subscriptions)
- [Retrieve organization subscriptions](#retrieve-organization-subscriptions)
- [Reset organization subscription usage](#reset-organization-subscription-usage)
- [`McpConnections`](#mcpconnections)
- [List MCP connections](#list-mcp-connections)
- [Create an MCP connection](#create-an-mcp-connection)
Expand Down Expand Up @@ -75,7 +74,6 @@ Complete reference of every operation, grouped by resource. See [the README](./R
- [`Users`](#users)
- [Retrieve the current user](#retrieve-the-current-user)
- [Retrieve a user](#retrieve-a-user)
- [Delete a user](#delete-a-user)
- [`Users Settings`](#users-settings)
- [Retrieve user settings](#retrieve-user-settings)
- [Update user settings](#update-user-settings)
Expand All @@ -84,7 +82,10 @@ Complete reference of every operation, grouped by resource. See [the README](./R
- [Retrieve a user connected account](#retrieve-a-user-connected-account)
- [`Users Subscriptions`](#users-subscriptions)
- [Retrieve user subscriptions](#retrieve-user-subscriptions)
- [Reset user subscription usage](#reset-user-subscription-usage)
- [`Users EnvironmentVariables`](#users-environmentvariables)
- [List personal environment variables](#list-personal-environment-variables)
- [Create a personal environment variable](#create-a-personal-environment-variable)
- [Delete a personal environment variable](#delete-a-personal-environment-variable)
- [`Users ProfilePicture`](#users-profilepicture)
- [Retrieve a user profile picture](#retrieve-a-user-profile-picture)
- [Update your profile picture](#update-your-profile-picture)
Expand Down Expand Up @@ -757,23 +758,6 @@ subscription = client.organizations.subscriptions.retrieve(
)
```

#### Reset organization subscription usage

Redeem an earned ChatGPT rate-limit reset.

| Direction | Type |
| --- | --- |
| Request | [`SubscriptionResetParams`](./src/tembo/types/organizations/subscription_reset_params.py) |
| Response | [`SubscriptionResetResponse`](./src/tembo/types/organizations/subscription_reset_response.py) |

```python
subscription = client.organizations.subscriptions.reset(
organization_id="organizationId",
idempotency_key="7c9e6679-7425-40de-944b-e07fc1f90ae7",
provider="chatgpt",
)
```

## `McpConnections`

### List MCP connections
Expand Down Expand Up @@ -1097,21 +1081,6 @@ user = client.users.retrieve(
)
```

### Delete a user

Queue permanent deletion of your user account.

| Direction | Type |
| --- | --- |
| Request | [`UserDeleteParams`](./src/tembo/types/user_delete_params.py) |
| Response | [`UserDeleteResponse`](./src/tembo/types/user_delete_response.py) |

```python
user = client.users.delete(
user_id="userId",
)
```

### `Users Settings`

#### Retrieve user settings
Expand Down Expand Up @@ -1192,20 +1161,51 @@ subscription = client.users.subscriptions.retrieve(
)
```

#### Reset user subscription usage
### `Users EnvironmentVariables`

#### List personal environment variables

List your personal environment variables in the current organization. Values are never returned.

| Direction | Type |
| --- | --- |
| Response | [`EnvironmentVariableListResponse`](./src/tembo/types/users/environment_variable_list_response.py) |

```python
environment_variable = client.users.environment_variables.list(
user_id="userId",
)
```

#### Create a personal environment variable

Store an encrypted environment variable that is injected into every session you start in the current organization.

| Direction | Type |
| --- | --- |
| Request | [`EnvironmentVariableCreateParams`](./src/tembo/types/users/environment_variable_create_params.py) |
| Response | [`EnvironmentVariableCreateResponse`](./src/tembo/types/users/environment_variable_create_response.py) |

```python
environment_variable = client.users.environment_variables.create(
user_id="userId",
key="x",
value="x",
)
```

#### Delete a personal environment variable

Redeem an earned ChatGPT rate-limit reset.
Permanently delete a personal environment variable. Sessions started afterwards no longer receive it.

| Direction | Type |
| --- | --- |
| Request | [`SubscriptionResetParams`](./src/tembo/types/users/subscription_reset_params.py) |
| Response | [`SubscriptionResetResponse`](./src/tembo/types/users/subscription_reset_response.py) |
| Response | [`EnvironmentVariableDeleteResponse`](./src/tembo/types/users/environment_variable_delete_response.py) |

```python
subscription = client.users.subscriptions.reset(
environment_variable = client.users.environment_variables.delete(
user_id="userId",
idempotency_key="7c9e6679-7425-40de-944b-e07fc1f90ae7",
provider="chatgpt",
environment_variable_id="7c9e6679-7425-40de-944b-e07fc1f90ae7",
)
```

Expand Down Expand Up @@ -1310,7 +1310,7 @@ session = client.sessions.retrieve(

### Update a session

Update a session: archive or restore it, set priority, rename it, change agent/model, switch between Build (normal) and Plan (planning) modes, configure its workspace and branches, or change visibility between private and visible to workspace (public). Archiving uses level=0; restoring archived sessions uses level=1 and does not restart work. Use pins to pin or unpin sessions.
Update a session: archive or restore it, set priority, rename it, change agent/model, switch between Build (normal) and Plan (planning) modes, configure its workspace and branches, or change visibility between private and visible to workspace (public). Archiving uses level=0; restoring archived sessions uses level=1 and does not restart work. Use pins to pin or unpin sessions. Submit memoryMb alone to request asynchronous memory growth for a running adaptive sandbox within project limits; sandbox metrics report progress.

| Direction | Type |
| --- | --- |
Expand Down Expand Up @@ -1561,7 +1561,8 @@ Create a reusable project environment.
```python
project = client.projects.create(
name="x",
sizes=["nano"],
sizes=["medium"],
resource_settings={"automaticSizing": False},
)
```

Expand Down Expand Up @@ -1591,6 +1592,7 @@ Update project repositories, setup script, agent instructions, environment varia
```python
project = client.projects.update(
project_id="projectId",
resource_settings={"automaticSizing": False},
)
```

Expand Down Expand Up @@ -2682,7 +2684,7 @@ billing = client.billing.retrieve()

### List billing usage

List session usage with cursor pagination.
List session usage by default, or include warm pool compute with the type filter. Uses cursor pagination.

| Direction | Type |
| --- | --- |
Expand Down
3 changes: 1 addition & 2 deletions pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "tembo-sdk-python"
version = "0.5.0" # x-release-please-version
version = "0.6.0" # x-release-please-version
description = "Manage agents, sessions, repositories, and organization resources with the Tembo API."
readme = "README.md"
license = "Apache-2.0"
Expand All @@ -13,7 +13,6 @@ dependencies = [
"pydantic>=1.9.0, <3",
"typing-extensions>=4.14, <5",
"anyio>=3.5.0, <5",
"distro>=1.7.0, <2",
"sniffio",
]

Expand Down
Loading
Loading