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

# Introduction

> Shared Desk API Dokumentation

Alternativ kann auch eine Swagger UI zur Erkundung genutzt werden. Die Swagger UI kann unter [production.shared-desk.cloud/swagger-ui/](https://production.shared-desk.cloud/swagger-ui/index.html) aufgerufen werden.
Die Open API Spezifikation kann unter [production.shared-desk.cloud/api-docs](https://production.shared-desk.cloud/api-docs) abgerufen werden.

<Note>
  Fast alle Endpunkte in Shared Desk sind durch JWT (JSON Web Token) geschützt. Das bedeutet, dass ein gültiges JWT im
  Header der Anfrage enthalten sein muss, um auf die Endpunkte zuzugreifen. Wenn kein JWT vorhanden ist oder das JWT
  ungültig ist, wird der Zugriff verweigert.
</Note>

<CardGroup cols={3}>
  <Card title="Authentication" icon="lock" href="/api-reference/authentication">
    Manage user authentication, including registration, login, token refresh, password changes, and token
    invalidation.
  </Card>

  <Card title="Department" icon="building" href="/api-reference/department">
    Create, read, update, and delete departments, as well as manage department-related reports and images.
  </Card>

  <Card title="Desk" icon="table-picnic" href="/api-reference/desk">
    Manage desks, including creation, deletion, retrieval, equipment assignment, user assignment, and reporting.
  </Card>

  <Card title="Equipment" icon="desktop" href="/api-reference/equipment">
    Manage equipment, including creation, deletion, retrieval, and association with desks.
  </Card>

  <Card title="Password" icon="lock" href="/api-reference/password">
    Handle password reset requests and password updates with tokens.
  </Card>

  <Card title="Report" icon="flag" href="/api-reference/report">
    Create, read, update, and delete reports related to defects or issues.
  </Card>

  <Card title="Reservation" icon="calendar-check" href="/api-reference/reservation">
    Manage desk reservations, including creation, cancellation, retrieval, and splitting.
  </Card>

  <Card title="Room" icon="door-open" href="/api-reference/room">
    Create, read, update, and delete rooms, and manage room-related reports.
  </Card>

  <Card title="Search" icon="magnifying-glass" href="/api-reference/search">
    Perform advanced searches for departments, rooms, desks, reports, and users.
  </Card>

  <Card title="Self" icon="user" href="/api-reference/self">
    Manage your own profile information and profile picture.
  </Card>

  <Card title="Session" icon="key" href="/api-reference/session">
    Manage user sessions, including retrieval and deletion.
  </Card>

  <Card title="Stats" icon="chart-bar" href="/api-reference/stats">
    Retrieve system statistics and usage data.
  </Card>

  <Card title="User" icon="users" href="/api-reference/user">
    Manage users, including creation, deletion, enabling/disabling, retrieval of user details, reservations, and
    sessions.
  </Card>

  <Card title="User Avatar" icon="circle-user" href="/api-reference/user">
    Manage user avatars, including retrieval, upload, and deletion.
  </Card>
</CardGroup>


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