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

# Nexudus SDK

> An overview of the Nexudus.Sdk .NET library for interacting with the Nexudus REST API programmatically.

# Nexudus SDK

The **Nexudus SDK** is a .NET library that provides a strongly-typed, idiomatic way to interact with the [Nexudus REST API](/rest-api/overview). It handles authentication, pagination, filtering, CRUD operations, and server-side command execution — so you can focus on building your integration.

<Note>
  The Nexudus SDK targets **.NET 10** and is distributed via NuGet. Make sure you have the .NET 10 SDK installed before getting started.

  A **.NET Framework 4.8** version is also available as a separate NuGet package: **Nexudus.Sdk.Framework**.
</Note>

## What can you do with it?

<CardGroup cols={2}>
  <Card title="Full CRUD operations" icon="database">
    List, create, read, update, and delete any entity in Nexudus — coworkers, bookings, products, resources, and 200+ more.
  </Card>

  <Card title="Strongly typed" icon="shield-check">
    Every entity and response is a typed C# class. No raw JSON manipulation or magic strings.
  </Card>

  <Card title="Built-in pagination" icon="list">
    Paginated results come with metadata like `TotalItems`, `TotalPages`, and `CurrentPage` for easy iteration.
  </Card>

  <Card title="Server-side commands" icon="bolt">
    Discover and execute server-side commands on any entity, with or without parameters.
  </Card>
</CardGroup>

## Who is this for?

| Audience                | Use case                                                                                      |
| ----------------------- | --------------------------------------------------------------------------------------------- |
| **.NET developers**     | Build custom integrations, automate workflows, or create dashboards using the Nexudus API.    |
| **System integrators**  | Connect Nexudus to third-party systems like CRMs, ERPs, or custom portals.                    |
| **Coworking operators** | Automate repetitive administrative tasks such as bulk imports, scheduled reports, or syncing. |

## How it works

The SDK wraps every Nexudus entity into a dedicated **endpoint class** that exposes a consistent set of methods:

```
SearchAsync  →  list / filter records
GetAsync     →  fetch a single record by ID
CreateAsync  →  create a new record
UpdateAsync  →  update an existing record
DeleteAsync  →  delete a record
GetCommandsAsync / RunCommandAsync  →  discover and run server-side commands
```

All endpoint classes inherit from `EntityEndpoint<T>` and follow the same pattern, so once you learn one, you know them all.

## Next steps

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/sdk/installation">
    Install the SDK and set up your first project.
  </Card>

  <Card title="Client setup" icon="gear" href="/sdk/client-setup">
    Configure the API client with authentication and options.
  </Card>

  <Card title="Deleting Records" icon="trash" href="/sdk/deleting-records">
    Remove entities by ID.
  </Card>

  <Card title="CRUD Lifecycle" icon="arrows-spin" href="/sdk/crud-lifecycle">
    Full create → read → update → delete walkthrough.
  </Card>

  <Card title="Server-Side Commands" icon="bolt" href="/sdk/commands">
    Discover and execute commands on entities.
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation" href="/sdk/error-handling">
    Understand how the SDK handles errors and retries.
  </Card>
</CardGroup>