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.11.1"
".": "0.12.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.12.0](https://github.com/tembo/sdk-python/compare/v0.11.1...v0.12.0) (2026-11-11)


### ⚠ BREAKING CHANGES

* **api:** 3 breaking changes to the SDK surface.
- Added required body field `roleId` to `organizations.members.create`.
- Removed body field `role` from `organizations.members.create`.
- Removed body field `role` from `organizations.members.update`.

### Features

* **api:** add operation organizations.roles.list (+10 more changes) ([4c68011](https://github.com/tembo/sdk-python/commit/4c6801159bcbef9479864af5f08b36f2bbfc1e25))
* **api:** update SDK surface (6 changes) ([9b0a9f0](https://github.com/tembo/sdk-python/commit/9b0a9f0de2dbf1240a167aa15e652e9d4afa7fd7))

## [0.11.1](https://github.com/tembo/sdk-python/compare/v0.11.0...v0.11.1) (2026-11-08)


Expand Down
181 changes: 175 additions & 6 deletions api.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,12 @@ Complete reference of every operation, grouped by resource. See [the README](./R
- [Retrieve an organization member](#retrieve-an-organization-member)
- [Update an organization member](#update-an-organization-member)
- [Remove an organization member](#remove-an-organization-member)
- [`Organizations Roles`](#organizations-roles)
- [List organization roles](#list-organization-roles)
- [Create a organization role](#create-a-organization-role)
- [Retrieve an organization role](#retrieve-an-organization-role)
- [Update a organization role](#update-a-organization-role)
- [Archive a role with an explicit replacement](#archive-a-role-with-an-explicit-replacement)
- [`Organizations Secrets`](#organizations-secrets)
- [List organization secrets](#list-organization-secrets)
- [Create an organization secret](#create-an-organization-secret)
Expand All @@ -59,6 +65,7 @@ Complete reference of every operation, grouped by resource. See [the README](./R
- [List artifacts](#list-artifacts)
- [Create an artifact](#create-an-artifact)
- [Retrieve an artifact](#retrieve-an-artifact)
- [Retrieve a signed asset URL](#retrieve-a-signed-asset-url)
- [Delete an artifact](#delete-an-artifact)
- [`Messages`](#messages)
- [List messages](#list-messages)
Expand Down Expand Up @@ -115,6 +122,7 @@ Complete reference of every operation, grouped by resource. See [the README](./R
- [List session commands](#list-session-commands)
- [`Projects`](#projects)
- [Update project defaults](#update-project-defaults)
- [Retrieve project defaults](#retrieve-project-defaults)
- [List projects](#list-projects)
- [Create a project](#create-a-project)
- [Retrieve a project](#retrieve-a-project)
Expand Down Expand Up @@ -206,6 +214,11 @@ Complete reference of every operation, grouped by resource. See [the README](./R
- [`Billing`](#billing)
- [Retrieve billing](#retrieve-billing)
- [List billing usage](#list-billing-usage)
- [`Folders`](#folders)
- [List folders](#list-folders)
- [Create a folder](#create-a-folder)
- [Update a folder](#update-a-folder)
- [Delete a folder](#delete-a-folder)
- [`Live`](#live)
- [Authorize a live connection](#authorize-a-live-connection)
- [Live resource subscriptions](#live-resource-subscriptions)
Expand Down Expand Up @@ -563,7 +576,7 @@ Invite or add a user to an organization with a role.
member = client.organizations.members.create(
organization_id="organizationId",
email_address="user@example.com",
role="org:member",
role_id="x",
)
```

Expand Down Expand Up @@ -595,7 +608,6 @@ Update an organization member role.
member = client.organizations.members.update(
organization_id="organizationId",
member_id="memberId",
role="org:admin",
)
```

Expand All @@ -614,6 +626,79 @@ member = client.organizations.members.delete(
)
```

### `Organizations Roles`

#### List organization roles

| Direction | Type |
| --- | --- |
| Response | [`RoleListResponse`](./src/tembo/types/organizations/role_list_response.py) |

```python
role = client.organizations.roles.list(
organization_id="organizationId",
)
```

#### Create a organization role

| Direction | Type |
| --- | --- |
| Request | [`RoleCreateParams`](./src/tembo/types/organizations/role_create_params.py) |
| Response | [`RoleCreateResponse`](./src/tembo/types/organizations/role_create_response.py) |

```python
role = client.organizations.roles.create(
organization_id="organizationId",
name="x",
description="",
permissions=["organization:read"],
)
```

#### Retrieve an organization role

| Direction | Type |
| --- | --- |
| Response | [`RoleRetrieveResponse`](./src/tembo/types/organizations/role_retrieve_response.py) |

```python
role = client.organizations.roles.retrieve(
organization_id="organizationId",
role_id="roleId",
)
```

#### Update a organization role

| Direction | Type |
| --- | --- |
| Request | [`RoleUpdateParams`](./src/tembo/types/organizations/role_update_params.py) |
| Response | [`RoleUpdateResponse`](./src/tembo/types/organizations/role_update_response.py) |

```python
role = client.organizations.roles.update(
organization_id="organizationId",
role_id="roleId",
description="",
)
```

#### Archive a role with an explicit replacement

| Direction | Type |
| --- | --- |
| Request | [`RoleDeleteParams`](./src/tembo/types/organizations/role_delete_params.py) |
| Response | [`RoleDeleteResponse`](./src/tembo/types/organizations/role_delete_response.py) |

```python
role = client.organizations.roles.delete(
organization_id="organizationId",
role_id="roleId",
replacement_role_id="x",
)
```

### `Organizations Secrets`

#### List organization secrets
Expand Down Expand Up @@ -915,6 +1000,20 @@ artifact = client.artifacts.retrieve(
)
```

### Retrieve a signed asset URL

Get a fresh signed download URL for an uploaded session asset by its asset ID.

| Direction | Type |
| --- | --- |
| Response | [`ArtifactRetrieveAssetURLResponse`](./src/tembo/types/artifact_retrieve_asset_url_response.py) |

```python
artifact = client.artifacts.retrieve_asset_url(
asset_id="7c9e6679-7425-40de-944b-e07fc1f90ae7",
)
```

### Delete an artifact

Delete an organization artifact and its backing asset when present.
Expand Down Expand Up @@ -1553,6 +1652,18 @@ project = client.projects.update_defaults(
)
```

### Retrieve project defaults

Get the default sandbox size and the largest size the plan allows.

| Direction | Type |
| --- | --- |
| Response | [`ProjectRetrieveDefaultsResponse`](./src/tembo/types/project_retrieve_defaults_response.py) |

```python
project = client.projects.retrieve_defaults()
```

### List projects

List projects in the authenticated organization.
Expand Down Expand Up @@ -1916,7 +2027,7 @@ pin = client.pins.list(

### Create a pin

Pin a session, pull request, or project you have permission to access.
Pin a session, pull request, or project you have permission to access, or one of your folders.

| Direction | Type |
| --- | --- |
Expand All @@ -1932,7 +2043,7 @@ pin = client.pins.create(

### Update a pin

Reorder a pinned session, pull request, or project before or after another pin for the authenticated user. Use createPin to pin a resource and deletePin to unpin it.
Reorder a pinned session, pull request, project, or folder before or after another pin for the authenticated user. Use createPin to pin a resource and deletePin to unpin it.

| Direction | Type |
| --- | --- |
Expand All @@ -1949,7 +2060,7 @@ pin = client.pins.update(

### Delete a pin

Unpin a session, pull request, or project for the authenticated user without deleting or archiving the resource.
Unpin a session, pull request, project, or folder for the authenticated user without deleting or archiving the resource.

| Direction | Type |
| --- | --- |
Expand Down Expand Up @@ -2279,7 +2390,7 @@ run = client.agents.runs.list(

#### Create an agent run

Queue an agent run. The entire JSON object body is passed to the agent as event input; no eventPayload wrapper is needed. Omit the body to run without event input. The response confirms queuing, not completed execution.
Queue an agent run. The entire JSON object body is passed to the agent as event input; no eventPayload wrapper is needed. Omit the body to run without event input. The response confirms queuing, not completed execution, and includes the run ID to poll for its status and session.

| Direction | Type |
| --- | --- |
Expand Down Expand Up @@ -2716,6 +2827,64 @@ billing = client.billing.list_usage(
)
```

## `Folders`

### List folders

List the sidebar folders you use to organize sessions. Use listSessions with folderId to list the sessions in a folder.

| Direction | Type |
| --- | --- |
| Response | [`FolderListResponse`](./src/tembo/types/folder_list_response.py) |

```python
folder = client.folders.list()
```

### Create a folder

Create a sidebar folder for organizing sessions. New folders go first in your folder list; use createPin to pin one.

| Direction | Type |
| --- | --- |
| Request | [`FolderCreateParams`](./src/tembo/types/folder_create_params.py) |
| Response | [`FolderCreateResponse`](./src/tembo/types/folder_create_response.py) |

```python
folder = client.folders.create(
name="x",
)
```

### Update a folder

Rename one of your sidebar folders, change its icon color, move it in your folder list, or add, reorder, or remove its sessions. Use updatePin to move a pinned folder among your pins.

| Direction | Type |
| --- | --- |
| Request | [`FolderUpdateParams`](./src/tembo/types/folder_update_params.py) |
| Response | [`FolderUpdateResponse`](./src/tembo/types/folder_update_response.py) |

```python
folder = client.folders.update(
folder_id="7c9e6679-7425-40de-944b-e07fc1f90ae7",
)
```

### Delete a folder

Delete one of your sidebar folders. Its sessions are kept and return to your recent sessions.

| Direction | Type |
| --- | --- |
| Response | [`FolderDeleteResponse`](./src/tembo/types/folder_delete_response.py) |

```python
folder = client.folders.delete(
folder_id="7c9e6679-7425-40de-944b-e07fc1f90ae7",
)
```

## `Live`

### Authorize a live connection
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "tembo-sdk-python"
version = "0.11.1" # x-release-please-version
version = "0.12.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 Down
Loading
Loading