Create Session

Create a session for tembo to start working on in the background

POST /session/create

JavaScript

JavaScript

import Tembo from '@tembo-io/sdk';

const client = new Tembo({
  apiKey: 'My API Key',
});

const session = await client.session.create({
  prompt: 'Fix the authentication bug in the login component',
  agent: 'claudeCode:claude-opus-4-5',
  repositories: [
    'https://github.com/org/repo',
    'https://gitlab.com/org/repo-2',
  ],
  targetBranch: 'dev',
  branchName: "cooper-is-awesome",
});

console.log(session.id);

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "title": "<string>",
  "description": "<string>",
  "status": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "htmlUrl": "https://app.tembo.io/sessions/123e4567-e89b-12d3-a456-426614174000"
}

Body

application/json

Session creation payload

Option 1

Option 2

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:

[
  "https://github.com/org/repo",
  "https://gitlab.com/org/repo-2"
]

codeRepoIds · string[]

Array of Tembo code repository IDs to target directly

Example:

[
  "cbad4334-c844-4fef-a8da-d08f209f267e",
  "6307d53a-b99d-4e90-ab89-f29114f33d53"
]

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

200

application/json

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"