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

# Overview

> Read and manage your organization's events from your own systems over the Nowadays REST API.

The Nowadays REST API lets you build on top of the Nowadays platform from your
own systems. Today it exposes your organization's **events** — list them, read
one in full, create new ones, and update their planning details. More resources
(proposals, contracts, and more) are on the way.

It is backed by the same service as the dashboard, so an event created or edited
through the API is identical to one changed in the UI — the same validation, the
same derived fields, the same permissions.

## Base URL

```
https://api.nowadays.ai
```

Every endpoint lives under `/v1`.

## Authentication

Requests authenticate with an API key sent in the `x-api-key` header:

```bash theme={null}
curl "https://api.nowadays.ai/v1/events" \
  -H "x-api-key: YOUR_API_KEY"
```

A key is issued to a person within one organization and acts as that person, so
it reaches exactly the events its owner can open. See
[Authentication](/api/authentication) for the details.

## What you can do today

* **List events** — page through your organization's events.
* **Get event** — fetch a single event's full detail by `id`.
* **Create event** — add a new event owned by your key's user.
* **Update event** — change an event's planning details.

## Versioning & stability

The API is versioned in the URL (`/v1`). Within a version we only **add** fields
and endpoints — never remove or rename them — so an integration built today keeps
working. Breaking changes ship under a new version (e.g. `/v2`) with the previous
version kept available during a deprecation window.

## Next steps

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/api/quickstart">
    Make your first request in under a minute.
  </Card>

  <Card title="Authentication" icon="key" href="/api/authentication">
    How API keys are scoped and kept safe.
  </Card>

  <Card title="Writing events" icon="pen-to-square" href="/api/writing-events">
    The rules the write path enforces.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/api/errors">
    Status codes and the error response shape.
  </Card>
</Columns>