-
Notifications
You must be signed in to change notification settings - Fork 62
New OpenAPI Spec #30
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
New OpenAPI Spec #30
Changes from all commits
Commits
Show all changes
122 commits
Select commit
Hold shift + click to select a range
a09d3fb
Add OAS
connorwinston 2385355
Change Bundle
connorwinston e8d1287
Fix Capitalization
connorwinston c3579fb
Try Fixing Action/Build Again
connorwinston b7b8287
Change Caps
connorwinston 4d2d84f
Merge branch 'main' into oas-fixed
connorwinston 6741fcb
Converting OAS Json to YAML, creating nested folder structure, adjus…
3d06b07
Adding all paths to api-spec/index.yaml
d4bc5ba
fixing malformed paths
5ad5b6a
Update api-spec/paths/assets/_id/getAsset.yaml
hola-soy-milk 90ede79
Update api-spec/paths/assets/_id/getAsset.yaml
hola-soy-milk 5482b90
Update api-spec/paths/auth/login/login.yaml
hola-soy-milk c581f65
Update api-spec/paths/auth/login/login.yaml
hola-soy-milk 29501d4
Update api-spec/components/schemas/permissions.yaml
hola-soy-milk 44403a4
Update api-spec/components/schemas/settings.yaml
hola-soy-milk c56dc76
Update api-spec/components/schemas/settings.yaml
hola-soy-milk 5bbb7bd
Update api-spec/components/schemas/settings.yaml
hola-soy-milk ffee3a5
Update api-spec/components/schemas/users.yaml
hola-soy-milk 5b46fac
Update api-spec/paths/auth/login/login.yaml
hola-soy-milk 21c833c
Update api-spec/paths/auth/login/login.yaml
hola-soy-milk 7d4ea0a
Update api-spec/paths/auth/logout/logout.yaml
hola-soy-milk fec1c61
Update api-spec/paths/auth/logout/logout.yaml
hola-soy-milk 73748ed
Update api-spec/paths/auth/oauth/oauth.yaml
hola-soy-milk a626d55
Update api-spec/paths/auth/oauth/oauth.yaml
hola-soy-milk 74d08a3
Update api-spec/paths/auth/oauth/_provider/oauthProvider.yaml
hola-soy-milk 408aec0
Update api-spec/paths/auth/oauth/_provider/oauthProvider.yaml
hola-soy-milk 59ccbde
Update api-spec/paths/auth/password/request/passwordRequest.yaml
hola-soy-milk a485c3c
Update api-spec/paths/auth/login/login.yaml
hola-soy-milk 630a070
Update api-spec/paths/utils/cache/clear/clear-cache.yaml
hola-soy-milk c4a96d9
Update api-spec/paths/utils/export/_collection/export.yaml
hola-soy-milk 058cb88
Update api-spec/paths/utils/export/_collection/export.yaml
hola-soy-milk 906f779
Update api-spec/paths/utils/cache/clear/clear-cache.yaml
hola-soy-milk b0cfb07
Update api-spec/paths/utils/hash/generate/hash-generate.yaml
hola-soy-milk 404909f
Update api-spec/paths/utils/hash/verify/hash-verify.yaml
hola-soy-milk 52f2635
Update api-spec/paths/utils/sort/_collection/sort.yaml
hola-soy-milk b6b2672
Update api-spec/paths/utils/export/_collection/export.yaml
hola-soy-milk 8525904
Update api-spec/paths/utils/import/_collection/import.yaml
hola-soy-milk 7faa6c8
Update api-spec/paths/auth/refresh/refresh.yaml
hola-soy-milk a268ae0
Update api-spec/paths/auth/refresh/refresh.yaml
hola-soy-milk da257d9
Update api-spec/paths/schema/diff/schemaDiff.yaml
hola-soy-milk 97e695e
Update api-spec/components/parameters.yaml
hola-soy-milk 02abfd1
Update api-spec/paths/server/info/serverInfo.yaml
hola-soy-milk 727fb23
Update api-spec/index.yaml
hola-soy-milk ca74f1c
Update api-spec/paths/operations/_id/updateOperation.yaml
hola-soy-milk a5fda09
Update api-spec/paths/versions/getContentVersions.yaml
hola-soy-milk 434623f
Update api-spec/paths/versions/createContentVersion.yaml
hola-soy-milk d4fd81b
Update api-spec/paths/folders/getFolders.yaml
hola-soy-milk e21a858
Update api-spec/paths/folders/createFolder.yaml
hola-soy-milk 4daeecb
Update api-spec/paths/folders/_id/getFolder.yaml
hola-soy-milk ecca66b
Update api-spec/paths/folders/_id/updateFolder.yaml
hola-soy-milk 8638989
Update api-spec/paths/folders/_id/deleteFolder.yaml
hola-soy-milk 95def41
Update api-spec/paths/relations/getRelations.yaml
hola-soy-milk 342e333
Update api-spec/index.yaml
hola-soy-milk 806e3eb
Update api-spec/paths/files/getFiles.yaml
hola-soy-milk a5dee70
Update api-spec/paths/files/deleteFiles.yaml
hola-soy-milk ca9d097
Update api-spec/paths/files/_id/getFile.yaml
hola-soy-milk 3ff540c
Update api-spec/paths/files/_id/deleteFile.yaml
hola-soy-milk 383be42
Update api-spec/paths/fields/_collection/_id/deleteField.yaml
hola-soy-milk 29ed94c
Update api-spec/paths/operations/getOperations.yaml
hola-soy-milk 081be53
Update api-spec/paths/operations/_id/getOperation.yaml
hola-soy-milk ca91e37
Update api-spec/components/schemas/flows.yaml
hola-soy-milk f87bd06
Update api-spec/paths/versions/_id/promote/promoteContentVersion.yaml
hola-soy-milk 4f21f33
Update api-spec/paths/revisions/_id/getRevision.yaml
hola-soy-milk 7205e6e
Update api-spec/index.yaml
hola-soy-milk 874f373
Update api-spec/paths/users/getUsers.yaml
hola-soy-milk 86ea1b9
Update api-spec/paths/users/_id/getUser.yaml
hola-soy-milk 7915f8e
Update api-spec/paths/users/invite/accept/acceptInvite.yaml
hola-soy-milk 0bae303
Update api-spec/paths/users/me/tfa/disable/meTfaDisable.yaml
hola-soy-milk 58a1bfd
Update api-spec/paths/permissions/createPermission.yaml
hola-soy-milk 3171f3b
Update api-spec/paths/permissions/createPermission.yaml
hola-soy-milk e8c8604
Update api-spec/paths/permissions/updatePermissions.yaml
hola-soy-milk c0b67f2
Update api-spec/paths/permissions/_id/updatePermission.yaml
hola-soy-milk 85899cc
Update api-spec/paths/collections/_id/updateCollection.yaml
hola-soy-milk 1dfb1bf
Update api-spec/paths/flows/_id/updateFlow.yaml
hola-soy-milk caec869
Update api-spec/paths/presets/getPresets.yaml
hola-soy-milk 0467fa0
Update api-spec/components/schemas/activity.yaml
hola-soy-milk 7cb4b81
Update api-spec/paths/permissions/getPermissions.yaml
hola-soy-milk 770072d
Making all code snippet urls directus_project_url instead of directus…
14e34ef
Added more missing endpoints and small fixes
423206c
some more endpoints and fixes
b9b84ed
last of the endpoints
8c8197d
Fixes, primarily schema files
903e5c9
removed single create endpoints to endforce restfulness, removed webh…
2b37400
added missing parameters, requestBody and Responses
d6aaea7
some more missing responses
813122e
Add missing 204 responses
hola-soy-milk 4257cd7
Fix running errors
hola-soy-milk ac977e8
fixed security oas issue
d8c59e7
Fix linting errors
hola-soy-milk 6f5759f
Fix auth params
hola-soy-milk e5a41f4
Fix code samples/descriptions
hola-soy-milk 2db0b7e
Fix server spec
hola-soy-milk 8434621
Mark params as required
hola-soy-milk c5cce76
Add description
hola-soy-milk 0e3e78a
Update required fields
hola-soy-milk 0e0e1b2
Fix operation params
hola-soy-milk bb8e7e5
Fix content version params
hola-soy-milk 6bbbf32
Fix user params
hola-soy-milk 4bf9f96
Rename action
hola-soy-milk 74e7f02
Update descriptions
hola-soy-milk 4fd7d6a
Fix permission params
hola-soy-milk c958d4a
Fix missing info
hola-soy-milk 94aaf0f
Remove capitalisation
hola-soy-milk d3f1cd7
Improve collection spec
hola-soy-milk 698763a
Fix flow endpoints
hola-soy-milk 63c0ca0
Add missing required params
hola-soy-milk bf19634
Fix role params
hola-soy-milk ec8f4a3
items, dashboards
hola-soy-milk 16ac40a
Update notifications
hola-soy-milk 0ca73a3
Fix panel spec
hola-soy-milk 217f0a0
Policy reference fixes
hola-soy-milk fcf70b9
Fix delete params
hola-soy-milk f300924
Fix shares params
hola-soy-milk 9085628
Fix translations
hola-soy-milk 96e243e
Remove models
hola-soy-milk af18a51
Add missing descriptions, consolidate
hola-soy-milk 3f04809
Add revisions text
hola-soy-milk 55b5ce5
Fix big with schema duplication
hola-soy-milk cd7278b
Integrate comments
hola-soy-milk 8370b98
Fix linting errors
hola-soy-milk 4210c9f
Merge branch 'main' into oas-fixed
hola-soy-milk 1ed52cb
Merge branch 'main' into oas-fixed
phazonoverload File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,110 @@ | ||
| Id: | ||
| description: Identifier for the object. | ||
| 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 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,56 @@ | ||
| x-metadata: | ||
| $ref: x-metadata.yaml | ||
| Activity: | ||
| $ref: Activity.yaml | ||
| Collections: | ||
| $ref: Collections.yaml | ||
| Comments: | ||
| $ref: Comments.yaml | ||
| Dashboards: | ||
| $ref: Dashboards.yaml | ||
| Diff: | ||
| $ref: Diff.yaml | ||
| Extensions: | ||
| $ref: Extensions.yaml | ||
| Fields: | ||
| $ref: Fields.yaml | ||
| Files: | ||
| $ref: Files.yaml | ||
| Flows: | ||
| $ref: Flows.yaml | ||
| Folders: | ||
| $ref: Folders.yaml | ||
| Items: | ||
| $ref: Items.yaml | ||
| Notifications: | ||
| $ref: Notifications.yaml | ||
| Operations: | ||
| $ref: Operations.yaml | ||
| Panels: | ||
| $ref: Panels.yaml | ||
| Permissions: | ||
| $ref: Permissions.yaml | ||
| Policies: | ||
| $ref: Policies.yaml | ||
| Presets: | ||
| $ref: Presets.yaml | ||
| Query: | ||
| $ref: Query.yaml | ||
| Relations: | ||
| $ref: Relations.yaml | ||
| Revisions: | ||
| $ref: Revisions.yaml | ||
| Roles: | ||
| $ref: Roles.yaml | ||
| Schema: | ||
| $ref: Schema.yaml | ||
| Settings: | ||
| $ref: Settings.yaml | ||
| Shares: | ||
| $ref: Shares.yaml | ||
| Translations: | ||
| $ref: Translations.yaml | ||
| Users: | ||
| $ref: Users.yaml | ||
| Versions: | ||
| $ref: Versions.yaml |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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. Many-to-one to users. | ||
| type: string | ||
| oneOf: | ||
| - $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: | ||
| description: Any changes that were made in this activity. One-to-many to revisions. | ||
| nullable: true | ||
| type: array | ||
| items: | ||
| oneOf: | ||
| - $ref: Revisions.yaml | ||
| x-collection: directus_activity | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,76 @@ | ||
| type: object | ||
| properties: | ||
| collection: | ||
| description: Name of the collection. This matches the table name in the database. | ||
| example: customers | ||
| type: string | ||
| icon: | ||
| nullable: true | ||
| description: Icon displayed in the Data Studio when working with this collection. | ||
| type: string | ||
| note: | ||
| nullable: true | ||
| description: Short description displayed in the Data Studio. | ||
| type: string | ||
| display_template: | ||
| nullable: true | ||
| description: How items in this collection should be displayed when viewed relationally in the Data Studio. | ||
| type: string | ||
| hidden: | ||
| nullable: false | ||
| description: Whether or not this collection is hidden in the Data Studio. | ||
| type: boolean | ||
| singleton: | ||
| nullable: false | ||
| description: Whether or not this collection is treated as a singleton. | ||
| type: boolean | ||
| translations: | ||
| description: How this collection's name is displayed in the different languages in the Data Studio. | ||
| type: array | ||
| nullable: true | ||
| archive_field: | ||
| description: What field in the collection holds the archived state. | ||
| nullable: true | ||
| type: string | ||
| archive_app_filter: | ||
| nullable: false | ||
| type: boolean | ||
| archive_value: | ||
| nullable: true | ||
| description: What value the archive field should be set to when archiving an item. | ||
| type: string | ||
| unarchive_value: | ||
| nullable: true | ||
| description: What value the archive field should be set to when unarchiving an item. | ||
| type: string | ||
| sort_field: | ||
| nullable: true | ||
| description: What field holds the sort value on the collection. The Data Studio uses this to allow drag-and-drop manual sorting. | ||
| type: string | ||
| accountability: | ||
| nullable: true | ||
| description: What data is tracked. One of `all`, `activity`. | ||
| type: string | ||
| item_duplication_fields: | ||
| nullable: true | ||
| description: What fields are duplicated during "Save as copy" action of an item in this collection. | ||
| type: array | ||
| sort: | ||
| nullable: true | ||
| description: What sort order of the collection relative to other collections of the same level. | ||
| type: integer | ||
| group: | ||
| nullable: true | ||
| description: The name of the parent collection. | ||
| type: string | ||
| oneOf: | ||
| - $ref: Collections.yaml | ||
| collapse: | ||
| nullable: false | ||
| description: What is the default behavior of this collection or "folder" collection when it has nested collections. One of `open`, `closed`, `locked`. | ||
| type: string | ||
| versioning: | ||
| nullable: false | ||
| description: Whether or not Content Versioning is enabled for this collection. | ||
| type: boolean | ||
| x-collection: directus_collections |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,42 @@ | ||
| type: object | ||
| properties: | ||
| collection: | ||
| description: Collection identifier in which the item resides. | ||
| example: articles | ||
| type: string | ||
| id: | ||
| description: Unique identifier for the object. | ||
| example: 2fab3b9d-0543-4b87-8a30-3c5ee66fedf1 | ||
| type: string | ||
| format: uuid | ||
| item: | ||
| description: The item the comment is created for. | ||
| example: 15 | ||
| 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 Data Studio. | ||
| example: This is a comment on an article | ||
| type: string | ||
| date_created: | ||
| description: Timestamp in ISO8601 when the comment was created. | ||
| example: 2023-01-15T09:14:52Z | ||
| type: string | ||
| format: date-time | ||
| date_updated: | ||
| description: Timestamp in ISO8601 when the comment was last updated. | ||
| example: 2023-01-15T09:00:00Z | ||
| type: string | ||
| format: date-time | ||
| user_created: | ||
| description: The user who created the comment. Many-to-one to users. | ||
| example: 12e62fd0-29c7-4fd3-b3d3-c7a39933e8af | ||
| type: string | ||
| oneOf: | ||
| - $ref: Users.yaml | ||
| user_updated: | ||
| description: The user who last updated the comment. Many-to-one to users. | ||
| example: 12e62fd0-29c7-4fd3-b3d3-c7a39933e8af | ||
| type: string | ||
| oneOf: | ||
| - $ref: Users.yaml | ||
| x-collection: directus_comments |
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.