# Dust Identity Threads API

**Canonical:** https://apis.io/apis/dust-identity/dust-identity-threads-api/  
**Provider:** Dust Identity — https://apis.io/providers/dust-identity/  
**Base URL:** https://apid.dustid.io  
**Documentation:** https://docs.dustid.io/reference/api/

Dust Identity Threads API is one of 24 APIs that [Dust Identity](https://apis.io/providers/dust-identity/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Threads. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

Create and manage threads

## Operations (30)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/assemblies` | List the assembly Threads the caller can view |
| GET | `/api/v1/assemblies/{assembly_id}/parts` | List the direct Parts of an assembly Thread |
| POST | `/api/v1/assemblies/{assembly_id}/parts` | Attach a Part to an assembly Thread |
| DELETE | `/api/v1/assemblies/{assembly_id}/parts` | Detach a Part from an assembly Thread |
| PATCH | `/api/v1/assemblies/{assembly_id}/parts/protection` | Set Part protection relation |
| PUT | `/api/v1/assemblies/{assembly_id}/thread-fields` | Set or clear a thread-valued assembly field |
| PATCH | `/api/v1/assemblies/{assembly_id}/kind` | Convert a Thread between unit and assembly kind |
| GET | `/api/v1/assemblies/{assembly_id}/rolled-up-parts` | List transitive Parts for an assembly Thread |
| POST | `/api/v1/threads` | Create one or more threads |
| GET | `/api/v1/threads` | List threads with cursor pagination. |
| GET | `/api/v1/threads/count` | Count threads with optional filters. |
| POST | `/api/v1/threads/permissions` | Get user permissions on threads. |
| POST | `/api/v1/threads/{thread_id}` | Update thread field data |
| GET | `/api/v1/threads/{thread_id}` | Get thread data. |
| POST | `/api/v1/threads/{thread_id}/data` | Update thread field data |
| GET | `/api/v1/threads/{thread_id}/data/archived` | List archived thread field data |
| POST | `/api/v1/threads/{thread_id}/data/restore` | Restore archived thread field data |
| POST | `/api/v1/threads/{thread_id}/presence` | Heartbeat presence and list the current viewers of a thread |
| GET | `/api/v1/threads/{thread_id}/access` | List access contexts for threads. |
| PATCH | `/api/v1/threads/archive` | Archive a set of threads. |
| PATCH | `/api/v1/threads/restore` | Restore archived threads. |
| PATCH | `/api/v1/threads/{thread_id}/thumbnail` | Set thread's thumbnail |
| POST | `/api/v1/threads/{thread_id}/thumbnail` | Upload thread thumbnail. |
| GET | `/api/v1/threads/{thread_id}/shared` | Thread shared with |
| GET | `/api/v1/threads/{thread_id}/files` | List resources for a Thread |
| GET | `/api/v1/threads/{thread_id}/files/{res_id}` | Get a file resource for a Thread |
| POST | `/api/v1/threads/{thread_id}/files/{res_id}` | Update a thread resource |
| GET | `/api/v1/threads/{thread_id}/links` | List thread links |
| POST | `/api/v1/imports/plan` | Dry-run an Assembly Import Package into an Import Plan |
| POST | `/api/v1/imports/commit` | Commit an Assembly Import Package all-or-nothing |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/dust-identity/refs/heads/main/openapi/dust-identity-threads-api-openapi.yml
- **Documentation** — https://docs.dustid.io/
- **APIReference** — https://apid.dustid.io/api/docs
- **GettingStarted** — https://docs.dustid.io/api/quickstart/
- **Authentication** — https://docs.dustid.io/api/authentication/
- **Examples** — https://raw.githubusercontent.com/api-evangelist/dust-identity/refs/heads/main/examples/dust-identity-examples.yml
- **Events** — https://raw.githubusercontent.com/api-evangelist/dust-identity/refs/heads/main/asyncapi/dust-identity-events.yml

## Other Dust Identity APIs (12)

- [DUST AuthD](https://apis.io/apis/dust-identity/dust-authd/)
- [Dust Identity Auth API](https://apis.io/apis/dust-identity/dust-identity-auth-api/)
- [Dust Identity Bundles API](https://apis.io/apis/dust-identity/dust-identity-bundles-api/)
- [Dust Identity Certificate Forms API](https://apis.io/apis/dust-identity/dust-identity-certificate-forms-api/)
- [Dust Identity Certificates API](https://apis.io/apis/dust-identity/dust-identity-certificates-api/)
- [Dust Identity Connections API](https://apis.io/apis/dust-identity/dust-identity-connections-api/)
- [Dust Identity Events API](https://apis.io/apis/dust-identity/dust-identity-events-api/)
- [Dust Identity Fabric API](https://apis.io/apis/dust-identity/dust-identity-fabric-api/)
- [Dust Identity Files API](https://apis.io/apis/dust-identity/dust-identity-files-api/)
- [Dust Identity Metrics API](https://apis.io/apis/dust-identity/dust-identity-metrics-api/)
- [Dust Identity Notifications API](https://apis.io/apis/dust-identity/dust-identity-notifications-api/)
- [Dust Identity Org Admin API](https://apis.io/apis/dust-identity/dust-identity-org-admin-api/)

## Tags

Threads

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/dust-identity/dust-identity-threads-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/dust-identity/.