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

# Cloud Management

> Use the SDK for folders, rooms, users, API keys, webhooks, and signed audio URLs.

Cloud methods manage organization resources and return non-plaintext metadata.

## Files and folders

```python theme={null}
folder = client.create_file(
    name="Customer calls",
    type="folder",
    visibility="restricted",
)

client.update_file(folder["id"], parent_id=None)
client.grant_file(folder["id"], "user_uuid")
```

For `update_file`, omit `parent_id` to keep the current parent, pass a folder ID to move, or pass `None` to move to root.

## Rooms and microphones

```python theme={null}
room = client.create_room(
    display_name="Conference Room",
    microphone_id="tablet-01",
)

client.update_room(room["id"], is_primary=True)
```

## Signed audio URLs

```python theme={null}
audio = client.get_transcript_audio("transcript_event_uuid")
print(audio["url"], audio.get("suggested_clip_secs"))
```

Signed URL responses include `filename` and `mime`. Transcript audio can include `offset_secs` and `suggested_clip_secs`; retained audio currently expires quickly.

## API keys and webhooks

```python theme={null}
key = client.create_api_key(
    name="Read-only integration",
    scopes=["records:read"],
)
print(key["secret"])
```

```python theme={null}
webhook = client.create_webhook(
    name="Meeting webhook",
    url="https://example.com/vued",
    events=["meeting.finalized"],
    payload_fields={"default": ["meeting", "timestamps", "title", "summary"]},
)
print(webhook["secret"])
```

Public API key secrets and webhook signing secrets are shown once. Store them securely.
