title: Convert Assistant To Workflow
keywords:

- convert assistant to workflow
- post
- convert
- assistant
- workflow


# Convert Assistant To Workflow

Convert an assistant to use a workflow.

#### Path Parameters

**`assistant_id`** string required

The assistant id parameter.

#### Request Body

**`workflow_name`** string optional

Workflow name (defaults to '{assistant.name} Workflow')

**`description`** string optional

Workflow description

## Returns

**`assistant_id`** string

Assistant ID

**`workflow_id`** string

Created workflow ID

**`workflow`** object

Created workflow details

Example

```bash cURL
curl -X POST "https://api.aitronos.com/v1/assistants/asst_abc123/convert-to-workflow" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json"
```


```python Python SDK
from aitronos import Aitronos

client = Aitronos(api_key="your-api-key")

result = client.assistants.convert_assistant_to_workflow(
    "asst_abc123",
    workflow_name="My Assistant Workflow",
)
print(result.workflow_id)
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.post(
    "https://api.aitronos.com/v1/assistants/{assistant_id}/convert-to-workflow",
    headers={"X-API-Key": api_key}
)

print(response.json())
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch('https://api.aitronos.com/v1/assistants/{assistant_id}/convert-to-workflow', {
  method: 'POST',
  headers: {
    'X-API-Key': apiKey,
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);
```

**Response:**


```json 201 OK
{
  "assistant_id": "asst_abc123def456",
  "workflow_id": "flow_abc123def456",
  "workflow": {
    "id": "flow_abc123def456",
    "organization_id": "org_abc123def456",
    "name": "My Resource",
    "definition": {},
    "version": 1,
    "is_active": true,
    "created_at": 1731667800,
    "updated_at": 1731667800
  }
}
```

Errors

```json 401 Unauthorized
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required. Please provide a valid API key.",
    "system_message": "Missing or invalid authorization header",
    "type": "authentication_error",
    "status": 401,
    "trace_id": "req_abc123xyz",
    "timestamp": "2025-11-11T10:30:00Z",
    "details": {}
  }
}
```


```json 403 Forbidden
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "You do not have permission to access this resource.",
    "system_message": "Insufficient permissions for this operation",
    "type": "authorization_error",
    "status": 403,
    "trace_id": "req_def456uvw",
    "timestamp": "2025-11-11T10:30:00Z",
    "details": {}
  }
}
```

## Related Resources

- [Create Assistant](/docs/api-reference/assistants/create)
- [List Assistants](/docs/api-reference/assistants/list)