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

# Task

> Beebole legacy API — Task operations.

## **Create a Task**

Request:

```json theme={null}
{
  "service": "task.create",
  "task": {
    "name": "Meeting",
    "company": {"id": 233}
  }
}
```

Response:

```json theme={null}
{
  "status": "ok",
  "id": 955
}
```

## **Get a Task**

Request:

```json theme={null}
{
  "service": "task.get",
  "id": 955
}
```

Response:

```json theme={null}
{
  "status" : "ok",
  "task" : {
    "id" : 955,
    "name" : "Meeting",
    "company" : {"id" : 233},
    "active" : true
  }
}
```

## **Update a Task**

Request:

```json theme={null}
{
  "service" : "task.update",
  "task" : {
    "id" : 955,
    "name" : "newName"
  }
}
```

Response:

```json theme={null}
{"status" : "ok"}
```

## **List Tasks**

Request:

```json theme={null}
{
  "service": "task.list",
  "company" : {"id" : 233}
}
```

Response:

```json theme={null}
{
  "status": "ok",
  "tasks": [
    {
      "id" : 955,
      "name" : "Meeting",
      "company" : {"id" : 233},
      "active" : true
    }, ...
  ]
}
```

## **Activate a Task**

Request:

```json theme={null}
{
  "service": "task.activate",
  "id": 955
}
```

Response:

```json theme={null}
{"status": "ok"}
```

## **Deactivate a Task**

Request:

```json theme={null}
{
  "service": "task.deactivate",
  "id": 955
}
```

Response:

```json theme={null}
{"status": "ok"}
```

## **Assign a Group to a Task**

Request:

```json theme={null}
{
  "service" : "task.add_group",
  "id" : 78,
  "group" : {
    "id" : 105
  }
}
```

Response:

```json theme={null}
{"status": "ok"}
```

## **Unassign a Group to a Task**

Request:

```json theme={null}
{
  "service" : "task.remove_group",
  "id" : 78,
  "group" : {
    "id" : 105
  }
}
```

Response:

```json theme={null}
{"status": "ok"}
```

## **List Groups Assigned to a Task**

Request:

```json theme={null}
{
  "service" : "task.groups",
  "id" : 78
}
```

Response:

```json theme={null}
{
  "status":"ok",
  "groups":[
    {
      "id":4787,
      "name":"US",
      "groups":{"count":4}
    }, ...
  ]
}
```