New OpenAPI Spec

api-spec/components/parameters.yaml

@@ -0,0 +1,110 @@
+Id:
+  description: Index
+  name: id
+  in: path
+  required: true
+  schema:
+    type: integer
+UUId:
+  description: Unique identifier for the object.
+  name: id
+  in: path
+  required: true
+  schema:
+    example: 8cbb43fe-4cdf-4991-8352-c461779cec02
+    type: string
+Collection:
+  description: Collection of which you want to retrieve the items from.
+  name: collection
+  in: path
+  required: true
+  schema:
+    type: string
+Search:
+  description: Filter by items that contain the given search query in one of their fields.
+  in: query
+  name: search
+  required: false
+  schema:
+    type: string
+Page:
+  description: Cursor for use in pagination. Often used in combination with limit.
+  in: query
+  name: page
+  required: false
+  schema:
+    type: integer
+Offset:
+  description: How many items to skip when fetching data.
+  in: query
+  name: offset
+  required: false
+  schema:
+    type: integer
+Sort:
+  description: >-
+    How to sort the returned items. `sort` is a CSV of fields used to sort the fetched items. Sorting defaults to ascending (ASC) order but a minus sign (` - `) can be used to reverse this to descending (DESC) order. Fields are prioritized by their order in the CSV. You can also use a ` ? ` to sort randomly.
+  in: query
+  name: sort
+  required: false
+  explode: false
+  schema:
+    type: array
+    items:
+      type: string
+Meta:
+  description: What metadata to return in the response.
+  in: query
+  name: meta
+  required: false
+  schema:
+    type: string
+Limit:
+  description: A limit on the number of objects that are returned.
+  in: query
+  name: limit
+  required: false
+  schema:
+    type: integer
+Filter:
+  description: Select items in collection by given conditions.
+  in: query
+  name: filter
+  required: false
+  content:
+    application/json:
+      schema:
+        type: object
+        example:
+          <field>:
+            <operator>: <value>
+Fields:
+  description: Control what fields are being returned in the object.
+  in: query
+  name: fields
+  required: false
+  explode: false
+  schema:
+    type: array
+    items:
+      type: string
+Export:
+  name: export
+  description: Saves the API response to a file. Accepts one of "csv", "json", "xml", "yaml".
+  in: query
+  required: false
+  schema:
+    type: string
+    enum:
+      - csv
+      - json
+      - xml
+      - yaml
+Version:
+  name: version
+  description: >-
+    Retrieve an item's state from a specific Content Version. The value corresponds to the "key" of the Content Version.
+  in: query
+  required: false
+  schema:
+    type: string

api-spec/components/responses.yaml

@@ -0,0 +1,30 @@
+NotFoundError:
+  description: "Error: Not found."
+  content:
+    application/json:
+      schema:
+        type: object
+        properties:
+          error:
+            type: object
+            properties:
+              code:
+                type: integer
+                format: int64
+              message:
+                type: string
+UnauthorizedError:
+  description: "Error: Unauthorized request"
+  content:
+    application/json:
+      schema:
+        type: object
+        properties:
+          error:
+            type: object
+            properties:
+              code:
+                type: integer
+                format: int64
+              message:
+                type: string

api-spec/components/schemas/_index.yaml

@@ -0,0 +1,43 @@
+Diff:
+  $ref: diff.yaml
+Query:
+  $ref: query.yaml
+Schema:
+  $ref: schema.yaml
+x-metadata:
+  $ref: x-metadata.yaml
+
+Activity:
+  $ref: activity.yaml
+Collections:
+  $ref: collections.yaml
+Extensions:
+  $ref: extensions.yaml
+Fields:
+  $ref: fields.yaml
+Files:
+  $ref: files.yaml
+Flows:
+  $ref: flows.yaml
+Folders:
+  $ref: folders.yaml
+Operations:
+  $ref: operations.yaml
+Permissions:
+  $ref: permissions.yaml
+Presets:
+  $ref: presets.yaml
+Relations:
+  $ref: relations.yaml
+Revisions:
+  $ref: revisions.yaml
+Roles:
+  $ref: roles.yaml
+Settings:
+  $ref: settings.yaml
+Users:
+  $ref: users.yaml
+Versions:
+  $ref: versions.yaml
+Webhooks:
+  $ref: webhooks.yaml

api-spec/components/schemas/activity.yaml

@@ -0,0 +1,62 @@
+type: object
+properties:
+  id:
+    description: Unique identifier for the object.
+    example: 2
+    type: integer
+  action:
+    description: Action that was performed.
+    example: update
+    type: string
+    enum:
+      - create
+      - update
+      - delete
+      - login
+  user:
+    description: The user who performed this action.
+    oneOf:
+      - type: string
+      - $ref: users.yaml
+    nullable: true
+  timestamp:
+    description: When the action happened.
+    example: '2019-12-05T22:52:09Z'
+    type: string
+    format: date-time
+  ip:
+    description: The IP address of the user at the time the action took place.
+    example: 127.0.0.1
+    oneOf:
+      - type: string
+        format: ipv4
+  user_agent:
+    description: User agent string of the browser the user used when the action took place.
+    example: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_1) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/78.0.3904.108 Safari/537.36
+    type: string
+  collection:
+    description: Collection identifier in which the item resides.
+    oneOf:
+      - type: string
+      - $ref: collections.yaml
+  item:
+    description: Unique identifier for the item the action applied to. This is always a string, even for integer primary keys.
+    example: '328'
+    type: string
+  comment:
+    description: User comment. This will store the comments that show up in the right sidebar of the item edit page in the admin app.
+    example: null
+    type: string
+    nullable: true
+  origin:
+    description: Origin of the request when the action took place.
+    example: https://directus.io
+    type: string
+  revisions:
+    nullable: true
+    type: array
+    items:
+      oneOf:
+        - type: integer
+        - $ref: revisions.yaml
+x-collection: directus_activity

api-spec/components/schemas/collections.yaml

@@ -0,0 +1,64 @@
+type: object
+properties:
+  collection:
+    description: The collection key.
+    example: customers
+    type: string
+  icon:
+    nullable: true
+    type: string
+  note:
+    nullable: true
+    type: string
+  display_template:
+    nullable: true
+    type: string
+  hidden:
+    nullable: false
+    type: boolean
+  singleton:
+    nullable: false
+    type: boolean
+  translations:
+    nullable: true
+  archive_field:
+    nullable: true
+    type: string
+  archive_app_filter:
+    nullable: false
+    type: boolean
+  archive_value:
+    nullable: true
+    type: string
+  unarchive_value:
+    nullable: true
+    type: string
+  sort_field:
+    nullable: true
+    type: string
+  accountability:
+    nullable: true
+    type: string
+  color:
+    nullable: true
+    type: string
+  item_duplication_fields:
+    nullable: true
+  sort:
+    nullable: true
+    type: integer
+  group:
+    nullable: true
+    oneOf:
+      - type: string
+      - $ref: collections.yaml
+  collapse:
+    nullable: false
+    type: string
+  preview_url:
+    nullable: true
+    type: string
+  versioning:
+    nullable: false
+    type: boolean
+x-collection: directus_collections

api-spec/components/schemas/diff.yaml

@@ -0,0 +1,46 @@
+type: object
+properties:
+  hash:
+    type: string
+  diff:
+    type: object
+    properties:
+      collections:
+        type: array
+        items:
+          type: object
+          properties:
+            collection:
+              type: string
+            diff:
+              type: array
+              items:
+                type: object
+      fields:
+        type: array
+        items:
+          type: object
+          properties:
+            collection:
+              type: string
+            field:
+              type: string
+            diff:
+              type: array
+              items:
+                type: object
+      relations:
+        type: array
+        items:
+          type: object
+          properties:
+            collection:
+              type: string
+            field:
+              type: string
+            related_collection:
+              type: string
+            diff:
+              type: array
+              items:
+                type: object

api-spec/components/schemas/extensions.yaml

@@ -0,0 +1,21 @@
+type: object
+properties:
+  enabled:
+    nullable: false
+    type: boolean
+  id:
+    nullable: false
+    type: string
+    format: uuid
+  folder:
+    nullable: false
+    type: string
+  source:
+    nullable: false
+    type: string
+  bundle:
+    description: Name of the bundle the extension is in.
+    example: my-bundle
+    type: string
+    nullable: true
+x-collection: directus_extensions