Documents
Read the API Overview to get started and learn more.
Get all documents
Gets all documents the specified guild. Can be filtered by project id and number of results limited. Defaults to 100 results maximum
Parameters
Responses
200 Response (Documents retrieved):
Response Field | Type | Description |
---|---|---|
documents | array | List of documents |
Create a new document
Creates a new document in the specified guild
Parameters
Request body
Request Field | Type | Description |
---|---|---|
project_id | string | ID of the project the document belongs to |
title | string | Title of the document |
content | string | Content of the document |
topic_id (optional) | string | ID of the topic the document belongs to |
in_bin (optional) | boolean | Whether the document is in the bin |
Responses
200 Response (Document created):
Response Field | Type | Description |
---|---|---|
id | string | ID of the document |
project_id | string | ID of the project the document belongs to |
title | string | Title of the document |
content | string | Content of the document |
topic_id (optional) | string | ID of the topic the document belongs to |
in_bin | boolean | Whether the document is in the bin |
delete_date (optional) | string | Date the document will be deleted if in the bin |
Get a document
Gets the document data by id in the specified guild
Parameters
Responses
200 Response (Document retrieved):
Response Field | Type | Description |
---|---|---|
id | string | ID of the document |
project_id | string | ID of the project the document belongs to |
title | string | Title of the document |
content | string | Content of the document |
topic_id (optional) | string | ID of the topic the document belongs to |
in_bin | boolean | Whether the document is in the bin |
delete_date (optional) | string | Date the document will be deleted if in the bin |
Update a document
Updates a document in the specified guild
Parameters
Request body
Request Field | Type | Description |
---|---|---|
project_id (optional) | string | The project id |
title (optional) | string | The title of the document |
content (optional) | string | The content of the document |
topic_id (optional) | string | The topic id |
in_bin (optional) | boolean | Is the document in the bin |
Responses
200 Response (Document updated):
Response Field | Type | Description |
---|---|---|
id | string | ID of the document |
project_id | string | ID of the project the document belongs to |
title | string | Title of the document |
content | string | Content of the document |
topic_id (optional) | string | ID of the topic the document belongs to |
in_bin | boolean | Whether the document is in the bin |
delete_date (optional) | string | Date the document will be deleted if in the bin |
Delete a document
Deletes a document in the specified guild
Parameters
Responses
204 Response (Document deleted): Empty response.