> ## 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.

# Get Capabilities

> Returns the effective capability map for the current user in the workspace.

Use this endpoint to check which actions the current user can perform on Digital Employees before making write requests.

### **Code Examples**

```http cURL theme={null}
curl --request GET \
  --url 'https://api.tess.im/digital-employees/capabilities' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'x-workspace-id: YOUR_WORKSPACE_ID'
```

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

const config = {
  method: 'get',
  url: 'https://api.tess.im/digital-employees/capabilities',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'x-workspace-id': 'YOUR_WORKSPACE_ID'
  }
};

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/capabilities"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "x-workspace-id": "YOUR_WORKSPACE_ID"
}

response = requests.get(url, 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/capabilities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOUR_API_KEY",
    "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;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.tess.im/digital-employees/capabilities"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("x-workspace-id", "YOUR_WORKSPACE_ID")
    .GET()
    .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"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://api.tess.im/digital-employees/capabilities", nil)
    req.Header.Add("Authorization", "Bearer YOUR_API_KEY")
    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 var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
client.DefaultRequestHeaders.Add("x-workspace-id", "YOUR_WORKSPACE_ID");
var response = await client.GetAsync("https://api.tess.im/digital-employees/capabilities");
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

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

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

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['x-workspace-id'] = 'YOUR_WORKSPACE_ID'

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

### **Headers**

> [!NOTE]
>
> The `Authorization` header must contain a valid Bearer token.

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

ID of the workspace to query capabilities for.

### **Response**

```json theme={null}
{
  "data": {
    "can_write": true,
    "can_invoke": true,
    "can_manage_state": true
  },
  "has_terminated_employees": false
}
```

#### Response fields

| Field | Type | Description |
| :- | :- | :- |
| `data.can_write` | boolean | Whether the user can create or update employees. |
| `data.can_invoke` | boolean | Whether the user can trigger manual runs. |
| `data.can_manage_state` | boolean | Whether the user can pause, resume, or rollback employees. |
| `has_terminated_employees` | boolean | Whether any soft-deleted employees exist in this workspace. |


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