Rest API inconsistency with documentation 2 ask

Weird. I must have lost track of it; Sorry about that.

The definition for owner actually lives in the GET Document endpoint (and should be linked to by other endpoints that share that response resource.)

`Published` documents do not require any authorization with Lucid at all. They are available to the world without logging in. A common use case would be a diagram explaining an open source institution.

https://help.lucid.co/hc/en-us/articles/16181914460692-Publish-or-embed-a-Lucid-document

If you see cases where that does not apply and the owner is not returned, submit a ticket and we will explore further. I am not aware of other exceptions.

No problem.

Yes I use Get Document for now but it makes two calls instead of one.

So if your response to documents/search contains a bunch of document (which is often the case), you must iterate and makes a call for each returned document one which is time consuming.

Regards. 

I may be misunderstanding you.  Search documents should also return owner information. The documentation about owner was only added to GET documents.

I mean. If sometimes “https://api.lucid.co/documents/search” returns the owner, I don’t know why it does not return that always.

Regards

Hmm, perhaps I have my facts wrong. Researching now and will be in touch.

I apologize for the confusion; I had some facts incorrect. I have created an internal story to get documentation correct regarding this. Additionally, that story includes investigating the differences and fixing any that don’t have a justification.

• GET /documents/:id returns owner
• GET /accounts/me/documents/search returns owner
  • It also returns other undocumented fields that might be useful to some. Given this is a Enterprise-Shield endpoint, those additional fields are related to that product.
• GET /documents/search does not return owner

I am unaware of a reason why /document/search does not include owner given that the base GET does. I do not have a timeframe for when that will be fixed, but you are correct that something is wrong.

Can you double check `If sometimes “https://api.lucid.co/documents/search” returns the owner,`? I shouldn’t ever return it currently, but I have been wrong before. ;)

I confirm that “https://api.lucid.co/documents/search” never returns the owner.
But yes if it could as i say it will be great!

About GET /accounts/me/documents/search, i could never use that cause it need Enterprise-shield which as I said in other post is a pity because I think We could expect that as soon as we have enterprise subscription (without enterprise shield).