***

title: create
slug: /reference/typescript/rest/datasphere/create
description: Upload a new document.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

[ref-datasphere]: /docs/server-sdks/reference/typescript/rest/datasphere

Upload a new document to the [Datasphere][ref-datasphere].

<EndpointSchemaSnippet endpoint="POST /api/datasphere/documents" />

## **Response Example**

<EndpointResponseSnippet endpoint="POST /api/datasphere/documents" />

## **Example**

```typescript {9}
import { RestClient } from "@signalwire/sdk";

const client = new RestClient({
  project: "your-project-id",
  token: "your-api-token",
  host: "your-space.signalwire.com"
});

const doc = await client.datasphere.documents.create({
    url: "https://filesamples.com/samples/document/txt/sample3.txt",
    tags: ["support", "demo"],
});
console.log("Document ID:", doc.id);
```