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

# Set Status • AI Agent SDK

> set_status: Set task status with transition validation.

# set\_status

Method

> This is a method of the [**Task**](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/Task.md) class in the [**task**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/task.md) module.

Set task status with transition validation.

Validates the transition is legal. If not, logs a warning but
still applies the change for backward compatibility.

## Signature

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
def set_status(new_status: str) -> None
```

## Parameters

**new\_status** `str` *required*

Target status (string or TaskStatus enum)

## Uses

* `_lifecycle_manager.can_transition`
* `logger.warning`
* `TaskStatus`

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/task/task.py#L512)
>
> `praisonaiagents/task/task.py` at line 512


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