> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# Datasphere

> Document storage and vector search.

[restclient]: /docs/server-sdks/reference/python/rest/client

[list]: /docs/server-sdks/reference/python/rest/datasphere/list

[create]: /docs/server-sdks/reference/python/rest/datasphere/create

[get]: /docs/server-sdks/reference/python/rest/datasphere/get

[update]: /docs/server-sdks/reference/python/rest/datasphere/update

[delete]: /docs/server-sdks/reference/python/rest/datasphere/delete

[search]: /docs/server-sdks/reference/python/rest/datasphere/search

[listchunks]: /docs/server-sdks/reference/python/rest/datasphere/list-chunks

[getchunk]: /docs/server-sdks/reference/python/rest/datasphere/get-chunk

[deletechunk]: /docs/server-sdks/reference/python/rest/datasphere/delete-chunk

Manage documents and perform semantic search via the Datasphere API. Documents
are stored with vector embeddings, enabling natural-language search across your
knowledge base. The `documents` sub-resource provides full CRUD plus search and
chunk-level operations.

Access via `client.datasphere.documents` on a [`RestClient`][restclient] instance.

```python {9}
from signalwire.rest import RestClient

client = RestClient(
    project="your-project-id",
    token="your-api-token",
    host="your-space.signalwire.com",
)

results = client.datasphere.documents.search(query_string="billing FAQ")
for chunk in results.get("chunks", []):
    print(chunk.get("text"), "score:", chunk.get("score"))
```

## **Methods**

#### [list](/docs/server-sdks/reference/python/rest/datasphere/list)

List documents in the project.

#### [create](/docs/server-sdks/reference/python/rest/datasphere/create)

Upload a new document.

#### [get](/docs/server-sdks/reference/python/rest/datasphere/get)

Retrieve a specific document.

#### [update](/docs/server-sdks/reference/python/rest/datasphere/update)

Update a document.

#### [delete](/docs/server-sdks/reference/python/rest/datasphere/delete)

Delete a document and all its chunks.

#### [search](/docs/server-sdks/reference/python/rest/datasphere/search)

Perform a semantic search across all documents.

#### [list\_chunks](/docs/server-sdks/reference/python/rest/datasphere/list-chunks)

List chunks belonging to a document.

#### [get\_chunk](/docs/server-sdks/reference/python/rest/datasphere/get-chunk)

Retrieve a specific chunk from a document.

#### [delete\_chunk](/docs/server-sdks/reference/python/rest/datasphere/delete-chunk)

Delete a specific chunk from a document.

> Document storage and vector search.

## Docs

- [create](https://signalwire.com/docs/server-sdks/reference/python/rest/datasphere/create.md): Upload a new document.
- [delete](https://signalwire.com/docs/server-sdks/reference/python/rest/datasphere/delete.md): Delete a document and all its chunks.
- [delete_chunk](https://signalwire.com/docs/server-sdks/reference/python/rest/datasphere/delete-chunk.md): Delete a specific chunk from a document.
- [get](https://signalwire.com/docs/server-sdks/reference/python/rest/datasphere/get.md): Retrieve a specific document.
- [get_chunk](https://signalwire.com/docs/server-sdks/reference/python/rest/datasphere/get-chunk.md): Retrieve a specific chunk from a document.
- [list](https://signalwire.com/docs/server-sdks/reference/python/rest/datasphere/list.md): List documents in the project.
- [list_chunks](https://signalwire.com/docs/server-sdks/reference/python/rest/datasphere/list-chunks.md): List chunks belonging to a document.
- [search](https://signalwire.com/docs/server-sdks/reference/python/rest/datasphere/search.md): Perform a semantic search across all documents.
- [update](https://signalwire.com/docs/server-sdks/reference/python/rest/datasphere/update.md): Update a document.