Plugins

Creates a Draft for the resource

Changed on Sep 30, 2026

post/api/v1/plugins/{id}/files/drafts/

Request

Base URL
/ (relative, and the document was published on a file host, not at the API’s origin)
Auth
none declared
TypeScript
https://skmtc.dev/usnistgov/apis/dioptra-rest-api/docs/api/v1/plugins/:id/files/drafts/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

X-Fieldsstring mask

An optional fields mask

Request body

filenamestring required

Name of the PluginFile resource.

contentsstring required

Contents of the file.

descriptionstring

Description of the PluginFile resource.

Response

Success

idinteger

ID of the Draft.

payloadobject

The contents of the draft resource.

createdOnstring date-time

Timestamp when the draft resource was created.

lastModifiedOnstring date-time

Timestamp when the draft resource was last modified.

resourceTypestring

The type of resource of this draft.

resourceinteger

ID of the resource this draft modifies.

resourceSnapshotinteger

ID of the resource snapshot this draft modifies.

metadataobject

Additional metadata about the draft

Changes

Sep 30, 20267615a76631a4 Revision changes
- breaking
  added to the ///////////////// request property allOf list
- breaking
  added to the ///////////////// request property allOf list
- breaking
  added to the ///////////////// request property allOf list
- breaking
  the request property type changed from object to no type
- breaking
  the ////// request property type changed from object to no type
- breaking
  the //////////// request property type changed from object to no type
- breaking
  the ///////////////// request property type changed from object to no type
- breaking
  the ////// request property type changed from object to no type
- breaking
  the //////////// request property type changed from object to no type
- breaking
  the ///////////////// request property type changed from object to no type
- breaking
  the //////////// request property type changed from object to no type
- breaking
  the ///////////////// request property type changed from object to no type
- breaking
  the response's property type changed from object to no type for status
- breaking
  the response's property type changed from object to no type for status
- warning
  deleted the path request parameter id
- warning
  removed from the ///////////////// request property allOf list
- warning
  removed from the ///////////////// request property allOf list
- warning
  removed from the ///////////////// request property allOf list
Feb 11, 2026a73101579c5c Revision changes
- breaking
  added to the request property allOf list
- breaking
  the request property type changed from array to object

Operation history (3 revisions)