---
title: "Update Current Agent Availability"
method: PUT
path: "/api/v1/agents/me/availability"
tags: ["Agents"]
---

# Update Current Agent Availability

`PUT /api/v1/agents/me/availability`

## Request body

- AvailabilityRequest
  - `status` 'available' | 'busy' | 'away' | 'offline', required — Availability status
  - `source` 'user' | 'idle' — Origin of the status change. 'user' is a manual change by the agent (default); 'idle' is an automatic idle-detection driven change. Idle transitions do not overwrite manual away states.

## Response `200`

Agent availability status updated successfully

- AgentResponse
  - `status` string
  - `data` Agent
    - `id` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `first_name` string
    - `last_name` string
    - `email` string, email, nullable
    - `type` string
    - `availability_status` string
    - `phone_number_country_code` string, nullable
    - `phone_number` string, nullable
    - `avatar_url` string, nullable
    - `enabled` boolean
    - `last_active_at` string, date-time, nullable
    - `last_login_at` string, date-time, nullable
    - `roles` string[]
    - `permissions` string[]
    - `custom_attributes` object
    - `teams` TeamCompact[]
      - `id` integer
      - `name` string
      - `emoji` string, nullable
    - `api_key` string, nullable
    - `api_key_last_used_at` string, date-time, nullable

## Other responses

- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/libredesk/apis/libredesk-api.md) · [All operations](https://skmtc.dev/libredesk/apis/libredesk-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/libredesk/libredesk-api/revisions/71ee25a0b5df/schema)