Complete reference of every operation, grouped by resource. See the README for usage and configuration.
import os
from tembo import Tembo
client = Tembo (
api_key = os .environ .get ("TEMBO_API_KEY" ),
)
List active API keys for the current organization.
api_key = client .api_keys .list (
limit = 50 ,
)
Create an API key for the current organization. Optionally set expiresAt to a future timestamp after which the key stops authenticating requests. The complete token is returned only by this operation.
api_key = client .api_keys .create ()
Retrieve an active API key without exposing its complete token.
api_key = client .api_keys .retrieve (
api_key_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Rename an active API key.
api_key = client .api_keys .update (
api_key_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
name = "x" ,
)
Revoke an active API key so it can no longer authenticate requests.
api_key = client .api_keys .delete (
api_key_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List organization skills or skills checked into a repository.
skill = client .skills .list (
limit = 50 ,
source = "organization" ,
)
Create an organization skill with its files.
skill = client .skills .create (
description = "" ,
name = "x" ,
files = [{"content" : "" , "encoding" : "utf8" , "filename" : "x" }],
)
Retrieve an organization skill and all of its files.
skill = client .skills .retrieve (
skill_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Update an organization skill. When files are provided, they replace the complete file set.
skill = client .skills .update (
skill_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Delete an organization skill.
skill = client .skills .delete (
skill_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List popular marketplace skills or search the catalog. Results have no continuation cursor.
marketplace = client .skills .marketplace .list (
limit = 50 ,
)
Retrieve a marketplace skill
Retrieve the files and content hash for a marketplace skill. This does not install the skill.
marketplace = client .skills .marketplace .retrieve (
skill_id = "skillId" ,
source = "source" ,
)
Retrieve pull request contribution insights and their collection status for the current organization.
insight = client .insights .retrieve (
range = "1y" ,
)
Enable or disable pull request insight collection. Enabling starts the initial refresh when needed.
insight = client .insights .update (
enabled = False ,
)
List organization members included in pull request insights.
insight = client .insights .list_members (
limit = 50 ,
range = "1y" ,
)
List insight repositories
List repositories included in pull request insights for the current organization.
insight = client .insights .list_repositories (
limit = 50 ,
range = "1y" ,
)
Create an organization and make the authenticated user its administrator.
organization = client .organizations .create (
name = "x" ,
)
Return self membership and workspace eligibility; include the full profile with organization read permission.
organization = client .organizations .retrieve (
organization_id = "organizationId" ,
)
Update organization profile fields or onboarding state.
organization = client .organizations .update (
organization_id = "organizationId" ,
)
Delete the organization from the identity provider and Tembo.
organization = client .organizations .delete (
organization_id = "organizationId" ,
)
List organization members
List active members or pending invitations with cursor pagination.
member = client .organizations .members .list (
organization_id = "organizationId" ,
limit = 50 ,
status = "active" ,
)
Create an organization member
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_id = "x" ,
)
Retrieve an organization member
Retrieve an active member or pending member invitation.
member = client .organizations .members .retrieve (
organization_id = "organizationId" ,
member_id = "memberId" ,
)
Update an organization member
Update an organization member role.
member = client .organizations .members .update (
organization_id = "organizationId" ,
member_id = "memberId" ,
)
Remove an organization member
Remove an active member or revoke a pending invitation.
member = client .organizations .members .delete (
organization_id = "organizationId" ,
member_id = "memberId" ,
)
role = client .organizations .roles .list (
organization_id = "organizationId" ,
)
Create a organization role
role = client .organizations .roles .create (
organization_id = "organizationId" ,
name = "x" ,
description = "" ,
permissions = ["organization:read" ],
)
Retrieve an organization role
role = client .organizations .roles .retrieve (
organization_id = "organizationId" ,
role_id = "roleId" ,
)
Update a organization role
role = client .organizations .roles .update (
organization_id = "organizationId" ,
role_id = "roleId" ,
description = "" ,
)
Archive a role with an explicit replacement
role = client .organizations .roles .delete (
organization_id = "organizationId" ,
role_id = "roleId" ,
replacement_role_id = "x" ,
)
List organization secrets
List redacted organization secret summaries with cursor pagination.
secret = client .organizations .secrets .list (
organization_id = "organizationId" ,
limit = 50 ,
)
Create an organization secret
Create an encrypted organization secret.
secret = client .organizations .secrets .create (
organization_id = "organizationId" ,
key = "x" ,
value = "x" ,
)
Retrieve an organization secret
Retrieve a redacted organization secret summary.
secret = client .organizations .secrets .retrieve (
organization_id = "organizationId" ,
secret_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Update an organization secret
Update a secret name, encrypted value, or both.
secret = client .organizations .secrets .update (
organization_id = "organizationId" ,
secret_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Delete an organization secret
Delete an organization secret.
secret = client .organizations .secrets .delete (
organization_id = "organizationId" ,
secret_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Retrieve organization settings
Retrieve effective organization settings, including defaults for settings that have not been configured.
setting = client .organizations .settings .retrieve (
organization_id = "organizationId" ,
)
Update organization settings
Configure organization defaults for agent/model, VM size and keep-alive; inference credentials and subscription fallback; agent prompts and commit/PR instructions; bot feedback, signing, reports, and insights. Only supplied settings are changed.
setting = client .organizations .settings .update (
organization_id = "organizationId" ,
)
Validate organization provider credentials
Validate supplied inference provider credentials for an organization without saving them. The provider must be available on the organization’s plan.
setting = client .organizations .settings .validate_credentials (
organization_id = "organizationId" ,
provider = "anthropic" ,
api_key = "" ,
)
Organizations Subscriptions
Retrieve organization subscriptions
Retrieve connection statuses and available ChatGPT and Claude usage. Provider usage errors are reported without failing the response.
subscription = client .organizations .subscriptions .retrieve (
organization_id = "organizationId" ,
)
List MCP connections for the current organization with cursor pagination and optional search by name or URL. Command arguments, headers, and environment configuration are omitted.
mcp_connection = client .mcp_connections .list (
limit = 50 ,
)
Create a new stdio or Streamable HTTP MCP connection. Remote connections support OAuth, Client Credentials (M2M), or static headers and begin authorization when required; stdio commands are stored but never executed by this API.
mcp_connection = client .mcp_connections .create (
name = "x" ,
args = [],
command = "x" ,
type = "stdio" ,
visibility = "shared" ,
)
Retrieve an MCP connection
Retrieve MCP connection configuration and authentication details. Stored header values, environment values, OAuth tokens, and client secrets are never returned.
mcp_connection = client .mcp_connections .retrieve (
mcp_connection_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Update MCP configuration, including OAuth, Client Credentials (M2M), or static-header authentication. Supplied headers merge by key only for unchanged-server static_headers authentication; otherwise they are replaced. Environment values merge by key, null values remove individual keys, and a null environment clears all variables. Hidden credentials are preserved unless explicitly changed or authentication is replaced; changing a remote server URL clears credentials for the old server. Call authorize explicitly after changing the server or authentication to reconnect.
mcp_connection = client .mcp_connections .update (
mcp_connection_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
type = "remote" ,
)
Delete an MCP connection in the current organization.
mcp_connection = client .mcp_connections .delete (
mcp_connection_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Authorize an MCP connection
Connect or authorize a remote Streamable HTTP MCP connection, returning an OAuth URL when user authorization is required. Stdio connections are rejected because this action cannot authorize them.
mcp_connection = client .mcp_connections .authorize (
mcp_connection_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Test a remote MCP connection by connecting to its server. Stdio connections are rejected because the API does not execute arbitrary local commands.
mcp_connection = client .mcp_connections .test (
mcp_connection_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List organization artifacts with optional session and type filters.
artifact = client .artifacts .list (
limit = 50 ,
)
Create a file artifact for a session from inline content or an uploaded asset.
artifact = client .artifacts .create (
title = "x" ,
output = {"type" : "html" , "content" : "x" },
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Retrieve an organization artifact by ID.
artifact = client .artifacts .retrieve (
artifact_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Retrieve a signed asset URL
Get a fresh signed download URL for an uploaded session asset by its asset ID.
artifact = client .artifacts .retrieve_asset_url (
asset_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Delete an organization artifact and its backing asset when present.
artifact = client .artifacts .delete (
artifact_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List organization messages with optional session and thread filters.
message = client .messages .list (
limit = 50 ,
)
Send a task or follow-up message to an existing session, resume work, or steer an active agent turn using deliveryMode.
message = client .messages .create (
content = "x" ,
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Retrieve an organization message by ID.
message = client .messages .retrieve (
message_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Update message content before its queued processing has started.
message = client .messages .update (
message_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Delete a message and cancel its queued jobs, runtime turns, and active sandbox sessions.
message = client .messages .delete (
message_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List the models available to the current organization, including enablement and inference-provider access.
model = client .models .list (
limit = 50 ,
)
Enable or disable an organization model, or select its inference provider.
model = client .models .update (
model_name = "modelName" ,
)
List execution runtimes and their compatible model references for the current organization.
runtime = client .runtimes .list (
limit = 50 ,
)
Retrieve the current user
Retrieve the authenticated user.
Retrieve a user profile visible to the caller.
user = client .users .retrieve (
user_id = "userId" ,
)
Retrieve user preferences without exposing stored credentials.
setting = client .users .settings .retrieve (
user_id = "userId" ,
)
Configure personal agent/model and project defaults, system instructions, follow-up queue/steer behavior, VM restart, commit signing/attribution, notifications, themes, and review layout. Updates preserve unrelated settings.
setting = client .users .settings .update (
user_id = "userId" ,
)
List user connected accounts
List the user identity-provider accounts without returning credentials.
connected_account = client .users .connected_accounts .list (
user_id = "userId" ,
limit = 50 ,
)
Retrieve a user connected account
Retrieve one identity-provider account without returning credentials.
connected_account = client .users .connected_accounts .retrieve (
user_id = "userId" ,
connected_account_id = "connectedAccountId" ,
)
Retrieve user subscriptions
Retrieve connection statuses and available ChatGPT and Claude usage. Provider usage errors are reported without failing the response.
subscription = client .users .subscriptions .retrieve (
user_id = "userId" ,
)
Users EnvironmentVariables
List personal environment variables
List your personal environment variables in the current organization. Values are never returned.
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.
environment_variable = client .users .environment_variables .create (
user_id = "userId" ,
key = "x" ,
value = "x" ,
)
Delete a personal environment variable
Permanently delete a personal environment variable. Sessions started afterwards no longer receive it.
environment_variable = client .users .environment_variables .delete (
user_id = "userId" ,
environment_variable_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Retrieve a user profile picture
Redirect to a user's profile picture. Signed URLs are valid for one hour.
client .users .profile_picture .retrieve (
user_id = "userId" ,
)
Update your profile picture
Upload a JPEG, PNG, GIF, or WebP profile picture up to 5 MB.
profile_picture = client .users .profile_picture .update (
user_id = "userId" ,
file = b"file" ,
)
Delete your profile picture
Delete your profile picture. This succeeds if no picture exists.
profile_picture = client .users .profile_picture .delete (
user_id = "userId" ,
)
List and search sessions, including active or archived sessions, with repository, project, creator, and source filters and cursor pagination.
session = client .sessions .list (
limit = 50 ,
include_archived = True ,
include_total = False ,
sort_by = "lastQueuedAt" ,
state = "all" ,
)
Create a session for a task. Provide the initial prompt in description and optionally configure its repositories, agent, Build (normal) or Plan (planning) mode, and private or workspace visibility.
session = client .sessions .create (
agent = "claudeCode:claude-fable-5-1" ,
base_branch = "main" ,
mcp_servers = [],
project_id = "your-project-id" ,
target_branch = "main" ,
visibility = "private" ,
code_repository_ids = ["123e4567-e89b-12d3-a456-426614174000" ],
description = "Fix the authentication bug in the login component" ,
)
Retrieve a session you have permission to access.
session = client .sessions .retrieve (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
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.
session = client .sessions .update (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Archive a session and stop its VM without permanently deleting it. Equivalent to updateSession with level=0; restore with updateSession and level=1.
session = client .sessions .delete (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Create an independent session from a fresh workspace snapshot, or the latest saved snapshot when stopped, without replaying messages or adding context. The fork returns right away and its messages queue until its workspace finishes booting.
session = client .sessions .fork (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
queue_right_away = True ,
)
Import a chat as a session
Create a private session from a chat in another coding agent app, such as Conductor, with its messages and agent activity. No agent run starts until a follow-up is sent, which receives the imported history as context. Importing the same chat again returns the existing session.
session = client .sessions .import_ (
source = "conductor" ,
external_id = "x" ,
title = "x" ,
messages = [{"id" : "x" , "role" : "user" , "content" : "" , "sent_at" : "2024-01-01T00:00:00.000Z" }],
)
Interrupt active session work without archiving it. Continue with the next queued message, or set cancelQueued=true to cancel pending messages too.
session = client .sessions .stop (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List recorded session stream events with cursor pagination.
session = client .sessions .list_events (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
limit = 50 ,
)
List session sources in the authenticated organization.
source = client .sessions .sources .list (
limit = 50 ,
include_total = False ,
)
Retrieve a session source
Retrieve one session source.
source = client .sessions .sources .retrieve (
source_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List recorded session diff metadata with cursor pagination.
diff = client .sessions .diffs .list (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
limit = 50 ,
)
Retrieve one recorded session diff and its content.
diff = client .sessions .diffs .retrieve (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
diff_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List pending questions for the active session agent.
input = client .sessions .inputs .list (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Answer a pending session question.
input = client .sessions .inputs .update (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
input_id = "inputId" ,
answers = {},
)
Replace the order of messages waiting in a session queue.
queue = client .sessions .queue .update (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
message_ids = ["7c9e6679-7425-40de-944b-e07fc1f90ae7" ],
)
List slash commands available to the session runtime.
command = client .sessions .commands .list (
session_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Choose the default project and sandbox size for the organization.
project = client .projects .update_defaults (
project_id = "x" ,
sandbox_size = "nano" ,
)
Retrieve project defaults
Get the default sandbox size and the largest size the plan allows.
project = client .projects .retrieve_defaults ()
List projects in the authenticated organization.
project = client .projects .list (
limit = 50 ,
)
Create a reusable project environment.
project = client .projects .create (
name = "x" ,
sizes = ["medium" ],
resource_settings = {"automaticSizing" : False },
)
Retrieve project configuration. Use the project subresources to list snapshots, builds, schedules, and environment variables.
project = client .projects .retrieve (
project_id = "projectId" ,
)
Update project repositories, setup script, agent instructions, environment variables, VM sizes and defaults; enable or pause scheduled builds or the warm pool; rename or customize its appearance.
project = client .projects .update (
project_id = "projectId" ,
resource_settings = {"automaticSizing" : False },
)
Archive a project, remove its default VM-size assignments, and disable its build schedule. This does not permanently delete the project record.
project = client .projects .delete (
project_id = "projectId" ,
)
Create a new project with the same configuration, environment variables, and schedule as an existing project. Snapshots are not copied.
project = client .projects .duplicate (
project_id = "projectId" ,
)
Projects EnvironmentVariables
List project environment variables
List environment-variable names without exposing values.
environment_variable = client .projects .environment_variables .list (
project_id = "projectId" ,
)
Create project environment variables
Create one or more encrypted project environment variables.
environment_variable = client .projects .environment_variables .create (
project_id = "projectId" ,
secrets = [{"key" : "" , "value" : "x" }],
)
Delete a project environment variable
Delete one encrypted project environment variable.
environment_variable = client .projects .environment_variables .delete (
project_id = "projectId" ,
key = "key" ,
)
List recent VM snapshots built for a project.
snapshot = client .projects .snapshots .list (
project_id = "projectId" ,
limit = 50 ,
)
Retrieve a project snapshot
Retrieve one project snapshot.
snapshot = client .projects .snapshots .retrieve (
project_id = "projectId" ,
snapshot_id = "snapshotId" ,
)
Update a project snapshot
Rename a snapshot or choose whether it is pinned.
snapshot = client .projects .snapshots .update (
project_id = "projectId" ,
snapshot_id = "snapshotId" ,
)
Delete a project snapshot
Delete a project snapshot.
snapshot = client .projects .snapshots .delete (
project_id = "projectId" ,
snapshot_id = "snapshotId" ,
)
List recent queued, running, and failed project builds.
build = client .projects .builds .list (
project_id = "projectId" ,
limit = 50 ,
)
Build selected project sizes or rebuild one snapshot.
build = client .projects .builds .create (
project_id = "projectId" ,
)
Retrieve project build status.
build = client .projects .builds .retrieve (
project_id = "projectId" ,
build_id = "buildId" ,
)
Cancel an active queued or running project build.
build = client .projects .builds .cancel (
project_id = "projectId" ,
build_id = "buildId" ,
)
List schedules linked to a project.
schedule = client .projects .schedules .list (
project_id = "projectId" ,
limit = 50 ,
)
Create a project schedule
Create a recurring project build schedule.
schedule = client .projects .schedules .create (
project_id = "projectId" ,
cron = "x" ,
)
Retrieve a project schedule
Retrieve one project build schedule.
schedule = client .projects .schedules .retrieve (
project_id = "projectId" ,
schedule_id = "scheduleId" ,
)
Update a project schedule
Update timing or enabled state for a project schedule.
schedule = client .projects .schedules .update (
project_id = "projectId" ,
schedule_id = "scheduleId" ,
)
Delete a project schedule
Disable a project build schedule.
schedule = client .projects .schedules .delete (
project_id = "projectId" ,
schedule_id = "scheduleId" ,
)
List your pinned resources in pin order.
pin = client .pins .list (
limit = 50 ,
)
Pin a session, pull request, or project you have permission to access, or one of your folders.
pin = client .pins .create (
type = "session" ,
id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
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.
pin = client .pins .update (
resource_type = "session" ,
resource_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
placement = {"target" : {"type" : "session" , "id" : "7c9e6679-7425-40de-944b-e07fc1f90ae7" }, "position" : "before" },
)
Unpin a session, pull request, project, or folder for the authenticated user without deleting or archiving the resource.
pin = client .pins .delete (
resource_type = "session" ,
resource_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List pull requests for the authenticated organization with cursor pagination.
pull_request = client .pull_requests .list (
limit = 50 ,
)
Retrieve a pull request for the authenticated organization.
pull_request = client .pull_requests .retrieve (
pull_request_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List agents available in your organization, with optional search, status, integration, and author filters.
agent = client .agents .list (
limit = 50 ,
)
Create an agent from instructions, a template, or another agent. sourceAgentId cannot be combined with other fields. Template creation accepts only templateName, name, and triggers; creation from scratch requires name.
agent = client .agents .create ()
Retrieve an agent and its configuration, repository associations, and run summary.
agent = client .agents .retrieve (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Update agent instructions, model, workspace, repositories, or persistent state; enable or pause the agent; archive or restore it. enabled and archived also control its schedules and triggers. Supply expectedUpdatedAt to reject concurrent changes.
agent = client .agents .update (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Archive an agent and disable its scheduled and triggered jobs without permanently deleting it. Restore with updateAgent and archived=false.
agent = client .agents .delete (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List reusable agent templates and their configuration requirements.
template = client .agents .templates .list (
limit = 50 ,
)
Retrieve an agent template
Retrieve a reusable agent template by name, including its instructions and required parameters.
template = client .agents .templates .retrieve (
template_name = "templateName" ,
)
List the schedules configured for an agent.
schedule = client .agents .schedules .list (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
limit = 50 ,
)
Create a recurring schedule that starts agent runs using a cron expression.
schedule = client .agents .schedules .create (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
cron = "x" ,
)
Retrieve an agent schedule
Retrieve an agent schedule, including its enabled state and next execution time.
schedule = client .agents .schedules .retrieve (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
schedule_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Change an agent schedule cron expression. Use updateAgent with enabled to enable or pause the agent and its schedules.
schedule = client .agents .schedules .update (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
schedule_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
cron = "x" ,
)
Delete a recurring agent schedule.
schedule = client .agents .schedules .delete (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
schedule_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List the integration events configured to start runs of an agent.
trigger = client .agents .triggers .list (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
limit = 50 ,
)
Configure an integration event to start agent runs. Available filters depend on the integration and event name.
trigger = client .agents .triggers .create (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
name = "x" ,
)
Retrieve an agent trigger
Retrieve an agent trigger and its integration event filters.
trigger = client .agents .triggers .retrieve (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
trigger_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Change an agent trigger event, integration, or filters. Use updateAgent with enabled to enable or pause the agent and its triggers.
trigger = client .agents .triggers .update (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
trigger_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
name = "x" ,
)
Delete an integration event trigger for an agent.
trigger = client .agents .triggers .delete (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
trigger_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List executions of an agent, including status, linked session, measured duration, and failure summary.
run = client .agents .runs .list (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
limit = 50 ,
)
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.
run = client .agents .runs .create (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Retrieve the status, linked session, measured duration, and failure summary of an agent run.
run = client .agents .runs .retrieve (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
run_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List agent instruction revisions
List saved revisions of an agent’s instruction JSON document, newest first. Revisions do not include other agent configuration. Author details are redacted from public API responses.
content_revision = client .agents .content_revisions .list (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
limit = 50 ,
)
Retrieve an agent instruction revision
Retrieve the instruction JSON document saved in one revision. Other agent configuration is not included. Author details are redacted from public API responses.
content_revision = client .agents .content_revisions .retrieve (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
version = 1 ,
)
Restore agent instructions
Restore a saved instruction JSON document and its mentioned integrations, without reverting other agent configuration. A changed document creates a new revision attributed to the caller. Supply the agent’s current contentVersion as expectedContentVersion; a concurrent instruction change returns 409.
content_revision = client .agents .content_revisions .restore (
agent_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
version = 1 ,
expected_content_version = 1 ,
)
List repositories in the authenticated organization. Defaults to enabled repositories.
repository = client .repositories .list (
limit = 50 ,
enabled = "all" ,
order = "desc" ,
sort = "pullRequests" ,
)
Retrieve a repository in the authenticated organization.
repository = client .repositories .retrieve (
repository_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Update repository configuration or enable or disable it.
repository = client .repositories .update (
repository_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
enabled = False ,
)
List integrations visible to the current organization or authenticated admin.
integration = client .integrations .list (
limit = 50 ,
include_total = False ,
)
Connect AWS, BigQuery, GitLab, PostgreSQL, Snyk, OpenConnect VPN, or Tailscale using provider credentials. For browser-authorized providers, use listIntegrationProviders and authorizeIntegration instead.
integration = client .integrations .create (
environment = "x" ,
role_arn = "x" ,
type = "aws" ,
)
Retrieve an integration and its configuration.
integration = client .integrations .retrieve (
integration_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Update integration settings such as the default repository, Slack channel restrictions, automatic solving, or Sentry environments; replace AWS or PostgreSQL configuration; rotate GitLab service account access tokens; set or remove Atlassian service-account credentials.
integration = client .integrations .update (
integration_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
settings = {},
)
Uninstall an integration from its provider when supported, then delete it from Tembo.
integration = client .integrations .delete (
integration_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Return the provider authorization URL for an integration.
integration = client .integrations .authorize (
integration_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Test the saved provider connection.
integration = client .integrations .test (
integration_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Queue or immediately perform an integration sync.
integration = client .integrations .sync (
integration_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
mode = "queued" ,
)
Sync eligible integrations
Queue integration and pull-request sync jobs for integrations with enabled repositories.
integration = client .integrations .sync_all ()
Retrieve integration sync status
Count active sync jobs for an integration or eligible integrations.
integration = client .integrations .retrieve_sync_status ()
Retrieve an integration rate limit
Retrieve the GitHub installation rate-limit state.
integration = client .integrations .retrieve_rate_limit (
integration_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
List environments visible to a Sentry integration.
integration = client .integrations .list_sentry_environments (
integration_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
limit = 50 ,
)
List channels visible to a Slack integration.
integration = client .integrations .list_slack_channels (
integration_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
limit = 50 ,
)
List integration providers
List providers available to the current organization.
provider = client .integrations .providers .list (
limit = 50 ,
)
Discover Snyk organizations
Validate Snyk service-account credentials and list accessible organizations.
provider = client .integrations .providers .discover_snyk_organizations (
client_id = "x" ,
client_secret = "x" ,
limit = 50 ,
)
List integration triggers
List visible automation triggers grouped by provider.
trigger = client .integrations .triggers .list (
limit = 50 ,
)
Retrieve an integration trigger
Retrieve a trigger definition and its default filter values for an integration in the current organization.
trigger = client .integrations .triggers .retrieve (
integration_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
trigger_name = "triggerName" ,
)
List integration trigger filter options
List one cursor-page of selectable values for an integration trigger filter field, with optional search.
trigger = client .integrations .triggers .list_filter_options (
integration_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
trigger_name = "triggerName" ,
field = "field" ,
limit = 50 ,
)
Retrieve billing and credit information for the organization.
billing = client .billing .retrieve ()
List session usage by default, or include warm pool compute with the type filter. Uses cursor pagination.
billing = client .billing .list_usage (
limit = 50 ,
)
List the sidebar folders you use to organize sessions. Use listSessions with folderId to list the sessions in a folder.
folder = client .folders .list ()
Create a sidebar folder for organizing sessions. New folders go first in your folder list; use createPin to pin one.
folder = client .folders .create (
name = "x" ,
)
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.
folder = client .folders .update (
folder_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Delete one of your sidebar folders. Its sessions are kept and return to your recent sessions.
folder = client .folders .delete (
folder_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7" ,
)
Authorize a live connection
Issue a 30-second WebSocket ticket for one live connection that multiplexes resource subscriptions.
live = client .live .authorize ()
Live resource subscriptions
Native WebSocket. Send { op: "subscribe", id, resource, input }, { op: "unsubscribe", id }, or { op: "ping" }; receive { id, type: "ready" | "event" | "error" } or { type: "pong" }.
with client .live .connect () as connection :
message = connection .recv ()
print (message )