# Attachments

You can enrich PIARA objects (such as Indicators, Malware, Threat Actors, Reports, etc.) by attaching relevant files like documents, archives, video files, etc. To ensure proper handling and control information sharing, PIARA requires you to classify each uploaded file into one of the following types:

* **`Internal Attachment`**:
  * **Purpose:** For internal records and archival only, associated with a specific object.&#x20;
  * **Sharing:** These attachments are considered strictly internal and **will not be shared or exported** via TAXII endpoints, even if the object they are attached to is shared.
* **`Public Attachment`**:
  * **Purpose:** For broad, unrestricted sharing, linked to the shared object.&#x20;
  * **Action:** Ensure the attachment is fully cleared for public consumption before selecting this type.
  * **Sharing:** Attachments marked as `Public` **are included** when the data of the associated object is shared via TAXII endpoints and are suitable for wider distribution.

#### Adding an attachment:

To add an attachment:

1. Use the `Attachments` tab
2. Select "Internal" or "Public" attachments
3. Click "Upload"

<figure><img src="/files/OaMfzCceqOyr1gzUNjgf" alt=""><figcaption></figcaption></figure>


---

# 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://piara-docs.gitbook.io/piara-documentation/user-guide/creating-and-managing-intelligence/creating-stix-objects/attachments.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.
