Search Account Documents

post

https://api.lucid.co/accounts/me/documents/search

Body Params

userIds

array of numbers

List of userIds to include in the search. If no ids are provided, it will search across the entire account.

userIds

ownedByUsers

boolean

Truthy if search results should only include documents owned by users specified by userIds. Ignored if no userIds are provided.

documentIds

array of uuids

List of documentIds to filter by.

documentIds

classificationIds

array of uuids

List of classificationIds to filter by.

classificationIds

statusIds

array of numbers

List of statusIds to filter by.

statusIds

createdStartTime

date-time

Start of range to filter documents by created time.

createdEndTime

date-time

End of range to filter documents by created time.

lastModifiedStartTime

date-time

Start of range to filter documents by last modified time.

lastModifiedEndTime

date-time

End of range to filter documents by last modified time.

product

array of objects

Defaults to lucidchart,lucidscale,lucidspark

Array of Lucid Suite products to filter by. Default value assumes all valid products for the given scopes.

product

Allowed:

keywords

string

Keyword(s) to search against document content and titles. When provided, results will be sorted by relevance to keyword search.

documentLocation

string

enum

Specify to search for documents owned by team folders, owned by users, or deleted

Allowed:

externalAccess

string

enum

Specify to search for documents with either “any” type of external access, “external-collaborators”, or "external-links"

Allowed:

Headers

Lucid-Api-Version

string

required

Defaults to 1

The API version used in the request.

Lucid-Request-As

string

required

If the requesting user is an account owner or document admin with the required permissions and they make the request with the value of “admin” as this header and include an admin scope, the request will be made using their admin permissions.

Responses

400

Bad Request if incorrect format

403

Forbidden if "product" query parameter is used and the token’s scopes do not contain the matching readonly scope for each product, or account does not have access to the API

429

Too Many Requests if account makes more than 300 requests in 5 seconds

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200With paginated list of Account Documents