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

# Apps

> Create and manage Vela apps with Python

## List apps

```python theme={null}
apps = client.apps.list()

for app in apps:
    print(app.id, app.name, app.slug, app.api_key_prefix)
```

## Create an app

```python theme={null}
result = client.apps.create({"name": "Order Service"})
print(result.api_key)  # vela_live_xxxx... -- shown only once
```

Optionally provide a slug:

```python theme={null}
result = client.apps.create({"name": "Order Service", "slug": "order-service"})
```

<Warning>
  The API key is returned only at creation time. Store it in a secure location immediately.
</Warning>

## Get an app

```python theme={null}
app = client.apps.get("order-service")  # UUID or slug
```

## Update an app

```python theme={null}
updated = client.apps.update("order-service", {"name": "Orders v2"})
```

## Rotate API key

```python theme={null}
result = client.apps.rotate_key("order-service")
# Old key is immediately revoked
print(result.api_key)
```