How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Dust Identity Threads API

Create and manage threads

Dust Identity Threads API is one of 24 APIs that Dust Identity publishes on the 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.

This API exposes 30 operations across 24 paths, and defines 145 schemas. It is described by OpenAPI 3.2.0, at version 2026.7.4.

Requests are made against a single base URL, https://apid.dustid.io.

30 operations 24 paths 145 schemas 1 DELETE12 GET5 PATCH11 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026.7.4
Base URL
https://apid.dustid.io
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Dust Identity Threads API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (Bearer). By default, every request must be authenticated.

  • Bearer — JWT issued by the DUST auth service. Obtain one by exchanging a Service Account API key (GET /api/auth/token with the key header) or via the OAuth2 clientcrede…

Paths & Operations 30

Across 24 paths, the API surfaces 30 operations — 1 DELETE, 12 GET, 5 PATCH, 11 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Threads 30

Create and manage threads

GET
/api/v1/assemblies
List the assembly Threads the caller can view
assembly.list 2 params → 200401
GET
/api/v1/assemblies/{assembly_id}/parts
List the direct Parts of an assembly Thread
assembly.children 1 param → 200400401404
POST
/api/v1/assemblies/{assembly_id}/parts
Attach a Part to an assembly Thread
assembly.attach_part 1 param body → 200400401404
DELETE
/api/v1/assemblies/{assembly_id}/parts
Detach a Part from an assembly Thread
assembly.detach_part 1 param body → 200400401404
PATCH
/api/v1/assemblies/{assembly_id}/parts/protection
Set Part protection relation
assembly.set_part_protection 1 param body → 200400401404
PUT
/api/v1/assemblies/{assembly_id}/thread-fields
Set or clear a thread-valued assembly field
assembly.set_thread_field 1 param body → 200400401404
PATCH
/api/v1/assemblies/{assembly_id}/kind
Convert a Thread between unit and assembly kind
assembly.convert 1 param body → 200400401404
GET
/api/v1/assemblies/{assembly_id}/rolled-up-parts
List transitive Parts for an assembly Thread
assembly.rolled_up_parts 1 param → 200400401404
POST
/api/v1/threads
Create one or more threads
threads.create body → 201400401
GET
/api/v1/threads
List threads with cursor pagination.
threads.list 18 params → 200400401
GET
/api/v1/threads/count
Count threads with optional filters.
threads.count 18 params → 200400401
POST
/api/v1/threads/permissions
Get user permissions on threads.
threads.check_permissions body → 200400401
POST
/api/v1/threads/{thread_id}
Update thread field data
threads.update 1 param body → 200400401404
GET
/api/v1/threads/{thread_id}
Get thread data.
threads.get 2 params → 200400401404
POST
/api/v1/threads/{thread_id}/data
Update thread field data
threads.update_data 1 param body → 200400401404
GET
/api/v1/threads/{thread_id}/data/archived
List archived thread field data
threads.get_archived_data 1 param → 200400401404
POST
/api/v1/threads/{thread_id}/data/restore
Restore archived thread field data
threads.restore_data 1 param body → 200400401404
POST
/api/v1/threads/{thread_id}/presence
Heartbeat presence and list the current viewers of a thread
threads.presence 1 param body → 200400401404
GET
/api/v1/threads/{thread_id}/access
List access contexts for threads.
threads.list_access_contexts 1 param → 200400401
PATCH
/api/v1/threads/archive
Archive a set of threads.
threads.archive body → 200400401404
PATCH
/api/v1/threads/restore
Restore archived threads.
threads.archive_restore body → 200400401404
PATCH
/api/v1/threads/{thread_id}/thumbnail
Set thread's thumbnail
threads.set_thumbnail 1 param body → 200400401404
POST
/api/v1/threads/{thread_id}/thumbnail
Upload thread thumbnail.
threads.upload_thumbnail 1 param body → 200400401404
GET
/api/v1/threads/{thread_id}/shared
Thread shared with
threads.list_shared 3 params → 200400401500
GET
/api/v1/threads/{thread_id}/files
List resources for a Thread
threads.list_files 6 params → 200400401500
GET
/api/v1/threads/{thread_id}/files/{res_id}
Get a file resource for a Thread
files.get 2 params → 200400401500
POST
/api/v1/threads/{thread_id}/files/{res_id}
Update a thread resource
files.update 2 params body → 200400401404500
GET
/api/v1/threads/{thread_id}/links
List thread links
thread_links.list_for_thread 1 param → 200400401
POST
/api/v1/imports/plan
Dry-run an Assembly Import Package into an Import Plan
imports.plan body → 200400401
POST
/api/v1/imports/commit
Commit an Assembly Import Package all-or-nothing
imports.commit body → 200400401

Schemas 145

The contract defines 145 schemas that model the data the API accepts and returns. The most detailed are ThreadResponse (35 properties), Resource (24 properties), ThreadListItem (23 properties), UploadResourceResponse (19 properties). Each schema is shown below with its type and property counts.

ThreadFieldSelectMany
object
15 properties 15 required
ThreadFieldPhoneValue
object
1 property 1 required
ThreadFieldDateCreateInput
object
10 properties 2 required
ThreadFieldSelect
object
15 properties 15 required
ThreadFieldDefinitionDate
object
7 properties 2 required
ImportPlanResponse
object
1 property 1 required
SetThumbnailUriRequest
object
Request to set a thread's thumbnail to an existing image URI. Resource ID is optional but allows the client to specify an existing resource that the URI corres…
1 property 1 required
ThreadFieldDateRange
object
15 properties 15 required
ThreadListSharedResponse
array
ThreadUpdateRequest
object
3 properties 1 required
ThreadFieldText
object
15 properties 15 required
ThreadFieldDefinitionNumber
object
7 properties 2 required
ThreadFieldThreadValue
object
1 property 1 required
ThreadTemplate
object
11 properties 9 required
ThreadCreateBaseRequest
object
2 properties 1 required
RolledUpPartsResponse
object
1 property 1 required
AssemblyChild
object
4 properties 3 required
ThreadFieldLongTextCreateInput
object
10 properties 2 required
ThreadFieldDefinitionTime
object
7 properties 2 required
ThreadFieldDefinitionSelect
object
7 properties 2 required
ThreadFieldPhoneUpdateInput
object
10 properties 3 required
SetPartProtectionRequest
object
2 properties 2 required
ThreadFieldDatetimeUpdateInput
object
10 properties 3 required
ThreadFieldLongText
object
15 properties 15 required
ImportRequest
object
1 property 1 required
ThreadFieldTagsValue
object
1 property 1 required
ImportCommitResponse
object
4 properties 3 required
Resource
object
24 properties 21 required
ThreadFieldNumberValue
object
1 property 1 required
ThreadAccessContextResponse
array
List of teams the user belongs to that have access to the thread, along with their role and permissions in the thread
ThreadFieldJsonValue
object
1 property 1 required
ThreadFieldTextCreateInput
object
10 properties 2 required
ThreadFieldDefinitionJson
object
7 properties 2 required
ThreadFieldEmailCreateInput
object
10 properties 2 required
ThreadCreateManyRequest
object
3 properties 2 required
ThreadFieldSelectManyValue
object
2 properties 2 required
ThreadFieldSelectUpdateInput
object
10 properties 3 required
ThreadFieldTextUpdateInput
object
10 properties 3 required
ThreadPresenceHeartbeatRequest
object
4 properties
ThreadFieldDateUpdateInput
object
10 properties 3 required
ThreadFieldDurationCreateInput
object
10 properties 2 required
ThreadFieldThread
object
15 properties 15 required
ThreadFieldDateRangeValue
object
2 properties 2 required
ThreadFieldUrlUpdateInput
object
10 properties 3 required
ThreadTemplateSpec
array
ThreadFieldResourceCreateInput
object
10 properties 2 required
AssemblyImportPackage
object
7 properties 2 required
ImportPlanMatch
object
5 properties 4 required
ThreadFieldEmail
object
15 properties 15 required
ThreadFieldPhone
object
15 properties 15 required
ThreadFieldDatetime
object
15 properties 15 required
ThreadFieldLongTextUpdateInput
object
10 properties 3 required
ThreadFieldTimeUpdateInput
object
10 properties 3 required
AssemblyChildrenResponse
object
1 property 1 required
ThreadFieldTags
object
15 properties 15 required
ThreadFieldDefinitionDatetime
object
7 properties 2 required
ThreadCreateResponse
object
2 properties 2 required
ThreadFieldBoolean
object
15 properties 15 required
ThreadFieldThreadUpdateInput
object
10 properties 3 required
ThreadQueryResponse
object
3 properties 1 required
ThreadFieldDefinitionTags
object
7 properties 2 required
ThreadFieldDuration
object
15 properties 15 required
ImportCategoryEntry
object
3 properties 2 required
ThreadPresenceViewer
object
10 properties 3 required
ThreadFieldSelectValue
object
2 properties 2 required
ThreadFieldDefinitionText
object
7 properties 2 required
ThreadFieldJsonUpdateInput
object
10 properties 3 required
ThreadCreateSingleRequest
object
4 properties 2 required
UploadResourceResponse
object
19 properties 7 required
ThreadFieldDefinitionBoolean
object
7 properties 2 required
ThreadUpdateDataRequest
object
4 properties 2 required
ImportThreadLinkEntry
object
3 properties 3 required
ImportFolderEntry
object
1 property 1 required
ThreadFieldDefinitionDuration
object
7 properties 2 required
ThreadPresenceResponse
object
1 property 1 required
ThreadFieldUrlCreateInput
object
10 properties 2 required
ImportSlotEntry
object
2 properties 1 required
ThreadFieldSelectCreateInput
object
10 properties 2 required
ThreadFieldDefinitionPhone
object
7 properties 2 required
ThreadFieldBooleanCreateInput
object
10 properties 2 required
ThreadFieldNumberUpdateInput
object
10 properties 3 required
ThreadFieldDateRangeUpdateInput
object
10 properties 3 required
ThreadFieldEmailValue
object
1 property 1 required
Principal
object
11 properties 11 required
ConvertThreadKindRequest
object
1 property 1 required
ThreadFieldTimeValue
object
1 property 1 required
ThreadFieldJson
object
15 properties 15 required
ThreadResourceUpdateResponse
object
3 properties 3 required
ThreadFieldEmailUpdateInput
object
10 properties 3 required
ThreadResourceUpdateRequest
object
1 property 1 required
ImportPlanIssue
object
4 properties 3 required
ThreadFieldNumber
object
15 properties 15 required
ThreadFieldDefinitionSelectMany
object
7 properties 2 required
ThreadFieldDurationValue
object
1 property 1 required
ImportThreadEntry
object
9 properties 3 required
ThreadFieldDurationUpdateInput
object
10 properties 3 required
ThreadFieldTagsCreateInput
object
10 properties 2 required
ThreadFieldList
array
Updated fields of the thread
ThreadUpdateResponse
object
2 properties 1 required
ThreadFieldTagsUpdateInput
object
10 properties 3 required
ThreadFieldTimeCreateInput
object
10 properties 2 required
ThreadArchivedDataResponse
array
ResourceSignedUrlList
array
ThreadFieldSelectManyUpdateInput
object
10 properties 3 required
ThreadGetResponse
object
2 properties 2 required
ThreadFieldDefinitionDateRange
object
7 properties 2 required
ThreadUpdateDataResponse
array
AttachPartRequest
object
2 properties 1 required
ThreadFieldThreadCreateInput
object
10 properties 2 required
ThreadFieldDefinitionUrl
object
7 properties 2 required
ThreadFieldDateValue
object
1 property 1 required
ThreadFieldDatetimeCreateInput
object
10 properties 2 required
ThreadFieldTextValue
object
1 property 1 required
ThreadFieldDateRangeCreateInput
object
10 properties 2 required
DetachPartRequest
object
1 property 1 required
ThreadRestoreDataRequest
object
2 properties 2 required
ThreadFieldNumberCreateInput
object
10 properties 2 required
ThreadFieldResource
object
15 properties 15 required
ImportPlanSummary
object
11 properties 11 required
ThreadFieldUrlValue
object
1 property 1 required
ThreadFieldDate
object
15 properties 15 required
ThreadFieldBooleanUpdateInput
object
10 properties 3 required
ImportRelationshipEntry
object
5 properties 3 required
ThreadFieldPhoneCreateInput
object
10 properties 2 required
ThreadResponse
object
35 properties 18 required
AssemblyListItem
object
4 properties 4 required
ThreadFieldDatetimeValue
object
1 property 1 required
ThreadFieldDefinitionLongText
object
7 properties 2 required
ThreadActiveShipment
object
3 properties 3 required
ThreadListItem
object
23 properties 18 required
ThreadFieldDefinitionResource
object
7 properties 3 required
RolledUpPart
object
6 properties 4 required
ThreadFieldResourceUpdateInput
object
10 properties 3 required
SetThumbnailFromResourceRequest
object
Set the thread's thumbnail using an existing resource.
1 property 1 required
AssemblyListResponse
object
1 property 1 required
ImportPlan
object
7 properties 5 required
ThreadFieldSelectManyCreateInput
object
10 properties 2 required
ThreadFieldResourceValue
object
1 property 1 required
ThreadFieldBooleanValue
object
1 property 1 required
SetThreadFieldRequest
object
4 properties 1 required
ThreadFieldUrl
object
15 properties 15 required
ThreadFieldDefinitionEmail
object
7 properties 2 required
ThreadFieldJsonCreateInput
object
10 properties 2 required
ThreadCreateManyRawRequest
object
5 properties 2 required
ThreadFieldTime
object
15 properties 15 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

dust-identity-threads-api-openapi.yml Raw ↑

Other APIs Dust Identity publishes across the network.

DUST AuthD
Dust Identity Auth API
Dust Identity Bundles API
Dust Identity Certificate Forms API
Dust Identity Certificates API
Dust Identity Connections API
Dust Identity Events API
Dust Identity Fabric API
Dust Identity Files API
Dust Identity Metrics API
Dust Identity Notifications API
Dust Identity Org Admin API
Where this information came from

This is an independent, third-party profile of Dust Identity Threads API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.