Skip to main content
POST
/
task
/
create
JavaScript
import Tembo from '@tembo-io/sdk';

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

const task = await client.task.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(task.id);
{
  "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"
}

Body

application/json

Task creation payload

​
prompt
string
required

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

Minimum string length: 1
Example:

"Fix the authentication bug in the login component"

​
agent
string

The agent to use for this task

Example:

"claudeCode:claude-opus-4-5"

​
repositories
string[]

Array of code repository urls that this task relates to

Example:
[
  "https://github.com/org/repo",
  "https://gitlab.com/org/repo-2"
]
​
branch
string | null

Specific git branch to target for this task

Example:

"feature/auth-fix"

​
queueRightAway
boolean | null
default:true

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

Example:

false

Response

Task 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