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

# Set Visitor's Status

> Update an Omnichannel visitor's status in their conversations. The new status appears on all of the visitor's conversations, including conversations waiting in the queue. The status saved on the visitor's record doesn't change.

### Changelog
| Version | Description |
| ------- | ----------- |
| 0.74.0  | Added       |

## OpenAPI

````json POST /api/v1/livechat/visitor.status
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "Omnichannel"
  },
  "servers": [
    {
      "url": "https://apiexplorer.support.rocket.chat"
    }
  ],
  "tags": [
    {
      "name": "Omnichannel Users"
    },
    {
      "name": "Omnichannel Agents"
    },
    {
      "name": "Omnichannel Monitors"
    },
    {
      "name": "Omnichannel Visitors"
    },
    {
      "name": "Omnichannel Contacts"
    },
    {
      "name": "Omnichannel Rooms"
    },
    {
      "name": "Omnichannel Departments"
    },
    {
      "name": "Omnichannel Custom Fields"
    },
    {
      "name": "Omnichannel Business Hours"
    },
    {
      "name": "Omnichannel Priorities"
    },
    {
      "name": "Omnichannel Tags"
    },
    {
      "name": "Omnichannel Units"
    },
    {
      "name": "SLA Policies"
    },
    {
      "name": "Canned Responses"
    },
    {
      "name": "Omnichannel Transcript"
    },
    {
      "name": "Omnichannel Statistics"
    },
    {
      "name": "Omnichannel Agent Stats"
    },
    {
      "name": "Omnichannel Dashboards"
    },
    {
      "name": "Reports"
    },
    {
      "name": "Omnichannel Inquiries"
    },
    {
      "name": "Omnichannel Webhooks"
    },
    {
      "name": "Livechat"
    },
    {
      "name": "Livechat Appearance"
    },
    {
      "name": "Livechat Triggers"
    },
    {
      "name": "Livechat Messages"
    },
    {
      "name": "Livechat Page Visited"
    }
  ],
  "paths": {
    "/api/v1/livechat/visitor.status": {
      "parameters": [],
      "post": {
        "summary": "Set Visitor's Status",
        "description": "Update an Omnichannel visitor's status in their conversations. The new status appears on all of the visitor's conversations, including conversations waiting in the queue. The status saved on the visitor's record doesn't change.\n\n### Changelog\n| Version | Description |\n| ------- | ----------- |\n| 0.74.0  | Added       |",
        "operationId": "post-api-v1-livechat-visitors.status",
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "token": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "success": {
                      "type": "boolean"
                    }
                  }
                },
                "examples": {
                  "Success Example": {
                    "value": {
                      "token": "54fc5544030bcecda0533",
                      "status": "busy",
                      "success": true
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "error": {
                      "type": "string"
                    },
                    "errorType": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "Missing Token": {
                    "value": {
                      "success": false,
                      "error": "Match error: Missing key 'token'"
                    }
                  },
                  "Missing Status": {
                    "value": {
                      "success": false,
                      "error": "Match error: Missing key 'status'"
                    }
                  },
                  "Invalid Visitor Token": {
                    "value": {
                      "success": false,
                      "error": "[invalid-token]",
                      "errorType": "invalid-token"
                    }
                  },
                  "Invalid Field Type": {
                    "value": {
                      "success": false,
                      "error": "Match error: Expected string, got number in field token"
                    }
                  },
                  "Unknown Body Property": {
                    "value": {
                      "success": false,
                      "error": "Match error: Unknown key in field department"
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "token": {
                    "type": "string",
                    "description": "The visitor token.",
                    "example": "54fc5544030bcecda0533"
                  },
                  "status": {
                    "type": "string",
                    "description": "The visitor's new status. Use `online`, `away`, `busy`, or `offline`.",
                    "example": "busy"
                  }
                },
                "required": [
                  "token",
                  "status"
                ]
              },
              "examples": {
                "Example": {
                  "value": {
                    "token": "54fc5544030bcecda0533",
                    "status": "busy"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Omnichannel Visitors"
        ]
      }
    }
  }
}
````