> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Standalone Employee

> Creates a new Digital Employee with a new host agent.

### **Code Examples**

```http cURL theme={null}
curl --request POST \
  --url 'https://api.tess.im/digital-employees/standalone' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'x-workspace-id: YOUR_WORKSPACE_ID' \
  --data '{
    "name": "Finance Ops",
    "execution_mode": "agent",
    "execution_approval_mode": "autonomous",
    "heartbeat_cron": "0 9 * * 1-5",
    "execution_timezone": "America/Sao_Paulo"
  }'
```

```json Node.js theme={null}
const axios = require('axios');

const config = {
  method: 'post',
  url: 'https://api.tess.im/digital-employees/standalone',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    'x-workspace-id': 'YOUR_WORKSPACE_ID'
  },
  data: {
    name: 'Finance Ops',
    execution_mode: 'agent',
    execution_approval_mode: 'autonomous',
    heartbeat_cron: '0 9 * * 1-5',
    execution_timezone: 'America/Sao_Paulo'
  }
};

try {
  const response = await axios(config);
  console.log(response.data);
} catch (error) {
  console.error(error);
}
```

```python Python theme={null}
import requests

url = "https://api.tess.im/digital-employees/standalone"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "x-workspace-id": "YOUR_WORKSPACE_ID"
}
payload = {
    "name": "Finance Ops",
    "execution_mode": "agent",
    "execution_approval_mode": "autonomous",
    "heartbeat_cron": "0 9 * * 1-5",
    "execution_timezone": "America/Sao_Paulo"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
```

```php PHP theme={null}
<?php
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tess.im/digital-employees/standalone",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    "name" => "Finance Ops",
    "execution_mode" => "agent",
    "execution_approval_mode" => "autonomous",
    "heartbeat_cron" => "0 9 * * 1-5",
    "execution_timezone" => "America/Sao_Paulo"
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOUR_API_KEY",
    "Content-Type: application/json",
    "x-workspace-id: YOUR_WORKSPACE_ID"
  ]
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;
```

```java Java theme={null}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String body = """
    {
      "name": "Finance Ops",
      "execution_mode": "agent",
      "execution_approval_mode": "autonomous",
      "heartbeat_cron": "0 9 * * 1-5",
      "execution_timezone": "America/Sao_Paulo"
    }
    """;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.tess.im/digital-employees/standalone"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .header("x-workspace-id", "YOUR_WORKSPACE_ID")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(request,
    HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

```go Go theme={null}
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "strings"
)

func main() {
    payload := strings.NewReader(`{
        "name": "Finance Ops",
        "execution_mode": "agent",
        "execution_approval_mode": "autonomous",
        "heartbeat_cron": "0 9 * * 1-5",
        "execution_timezone": "America/Sao_Paulo"
    }`)

    client := &http.Client{}
    req, _ := http.NewRequest("POST", "https://api.tess.im/digital-employees/standalone", payload)
    req.Header.Add("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Add("Content-Type", "application/json")
    req.Header.Add("x-workspace-id", "YOUR_WORKSPACE_ID")
    resp, _ := client.Do(req)
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
```

```jsonnet .NET theme={null}
using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
client.DefaultRequestHeaders.Add("x-workspace-id", "YOUR_WORKSPACE_ID");

var json = """
    {
      "name": "Finance Ops",
      "execution_mode": "agent",
      "execution_approval_mode": "autonomous",
      "heartbeat_cron": "0 9 * * 1-5",
      "execution_timezone": "America/Sao_Paulo"
    }
    """;

var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync(
    "https://api.tess.im/digital-employees/standalone", content);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

```ruby Ruby theme={null}
require 'uri'
require 'net/http'
require 'json'

uri = URI('https://api.tess.im/digital-employees/standalone')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request['x-workspace-id'] = 'YOUR_WORKSPACE_ID'
request.body = {
  name: 'Finance Ops',
  execution_mode: 'agent',
  execution_approval_mode: 'autonomous',
  heartbeat_cron: '0 9 * * 1-5',
  execution_timezone: 'America/Sao_Paulo'
}.to_json

response = http.request(request)
puts response.read_body
```

### **Headers**

> [!NOTE]
>
> Pass your API key as a Bearer token in the `Authorization` header.

**x-workspace-id** `integer` *required*

ID of the workspace.

### **Request Body**

**name** `string` *required*

Employee name. Max 255 characters.

**execution\_mode** `string`

Execution mode. Values: `agent` (autonomous) or `chat`. Default: `agent`.

**execution\_approval\_mode** `string`

Whether runs require manual approval. Values: `autonomous` or `approval_required`.

**heartbeat\_cron** `string`

Cron expression for scheduled runs (e.g. `0 9 * * 1-5`). Max 128 characters.

**heartbeat\_schedule\_json** `object`

Schedule builder config (alternative to `heartbeat_cron`).

**execution\_timezone** `string`

Timezone for schedule execution (e.g. `America/Sao_Paulo`). Max 64 characters.

**default\_interval\_seconds** `integer`

Minimum seconds between runs. Either `0` (no limit) or `>= 60`.

**system\_prompt\_override** `string`

Custom system prompt for this employee. Max 4096 characters.

**model\_override** `string`

Override the AI model (e.g. `tess-6`). Max 100 characters.

**tools\_override** `string`

Override tool configuration. Max 255 characters.

**search\_intelligence\_enabled** `boolean`

Enable Search Intelligence for runs.

**connectors\_json** `array`

Array of connector identifiers to enable.

**skills\_override\_json** `array`

Array of skill identifiers to override.

**max\_consecutive\_failures** `integer`

Max consecutive run failures before auto-pause. Range: 1–100.

**execution\_order** `integer`

Execution priority order. Range: 0–999.

**share\_memory\_with\_owner** `boolean`

Whether the employee shares memory with its owner agent.

**knowledge\_base\_file\_ids** `array`

Array of file IDs for the knowledge base. Max 20 entries.

**avatar** `string`

Avatar image URL. Max 2048 characters.

**avatar\_thumbnail** `string`

Thumbnail image URL. Max 2048 characters.

**personality\_type** `string`

MBTI personality type (e.g. `INTJ`).

**wake\_policy\_json** `object`

Wake policy configuration object.

**budget\_policy\_json** `object`

Budget policy configuration object.

**goal\_json** `object`

Goal configuration object.

**work\_policy\_json** `object`

Work policy configuration object.

**voice\_realtime\_voice** `string`

Voice identifier for real-time voice mode.

### **Response**

```json theme={null}
{
  "data": {
    "id": 123,
    "name": "Finance Ops",
    "workspace_id": 10
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.