v1

latestOpenAPI 3.1.02026-07-266016.5 KB

Create Session

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

post/session/create

Request body

Example request

{
  "prompt": "Fix the authentication bug in the login component",
  "description": "Users are reporting they cannot log in. JWT token validation appears to be failing.",
  "agent": "claudeCode:claude-opus-4-5",
  "repositories": [
    "https://github.com/org/repo",
    "https://gitlab.com/org/repo-2"
  ],
  "codeRepoIds": [
    "cbad4334-c844-4fef-a8da-d08f209f267e",
    "6307d53a-b99d-4e90-ab89-f29114f33d53"
  ],
  "targetBranch": "main",
  "branchName": "feature/auth-fix"
}

Response

Session created successfully

idstring uuid required

titlestring required

descriptionstring required

statusstring required

createdAtstring date-time required

updatedAtstring date-time required

organizationIdstring uuid required

htmlUrlstring uri required

URL to view this session in the Tembo web application

Example response

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