# Terminologies

Some terminologies used in the docs as defined in PPDRIVE context.

## Asset

An asset refers to any file or folder managed by PPDRIVE. This could be uploaded by a user or client.

## User

A user is an individual entity that owns an [Asset](#asset) on PPDRIVE.

## Client

A client typically represents an external application that integrates PPDRIVE by sending requests to manage PPDRIVE's [Assets](#asset) and resources.

## Bucket

A bucket is used to isolate [Assets](#asset) and configure access rules. It also defines the mechanism we use to manage and protect assets management operations (file upload, folder creation, etc).

* Each asset (file or folder) must be added to a bucket.
* A bucket may be created by a `Client` or directly by a user.
* A user, if allowed, has a maximum number of buckets they can create.
* Buckets can be public or private. A public bucket is writable by everyone. A private bucket is writable only by its owner and users with access.

{% hint style="info" %}
When writing to a bucket, the permission check is:

1. If the user is the bucket owner — allow.
2. Otherwise, if the bucket is public — allow.
3. Otherwise — the operation fails.
   {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dududaa.gitbook.io/ppdrive/terminologies.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.