Skip to main content
POST
JavaScript

Body

application/json

Session creation payload

prompt
string
required

Description of the session to be performed. Supports tagging files.

Minimum string length: 1
Example:

"Fix the authentication bug in the login component"

description
string

Detailed description of the session (alternative to prompt)

Minimum string length: 1
Example:

"Users are reporting they cannot log in. JWT token validation appears to be failing."

agent
string

The agent to use for this session

Example:

"claudeCode:claude-opus-4-5"

repositories
string[]

Array of code repository urls that this session relates to

Example:
codeRepoIds
string[]

Array of Tembo code repository IDs to target directly

Example:
targetBranch
string | null

The branch to open the pull request against (e.g. main, develop)

Example:

"main"

branchName
string | null

The branch name to use for the work

Example:

"feature/auth-fix"

queueRightAway
boolean | null
default:true

Whether to immediately queue the session for processing (optional, defaults to true)

Example:

false

Response

Session created successfully

id
string<uuid>
required
title
string
required
description
string
required
status
string
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
organizationId
string<uuid>
required
htmlUrl
string<uri>
required

URL to view this session in the Tembo web application

Example:

"https://app.tembo.io/sessions/123e4567-e89b-12d3-a456-426614174000"