documentosconceder acesso
POST
/v1/documents/:documentId/sharespermissão: view_documents (ver)Conceder acesso
Exige Administrar. Alvo já concedido tem o nível alterado; mesmo nível é document_share_duplicate.
parâmetros do caminho
- documentIduuidobrigatório
- Id do documento.
corpo da requisição
- targetmember | group | role | organizationobrigatório
- Tipo do destinatário.
- levelview | edit | adminobrigatório
- Nível concedido.
- memberIduuid | nullopcional
- Obrigatório quando target é member.
- groupIduuid | nullopcional
- Obrigatório quando target é group.
- roleowner | finance | hr | accountant | employee | supportopcional
- Obrigatório quando target é role. client é recusado.
erros deste endpoint
- 401not_authenticatedA chave não veio, não existe mais ou foi revogada.
- 403not_allowedA chave não tem view_documents (ver).
- 404not_foundO recurso não existe nesta organização.
- 409document_deletedEsse documento foi apagado e não aceita mais alterações.
- 409document_share_duplicateEsse destinatário já tem exatamente esse nível de acesso.
- 422invalid_inputUm campo não passou na validação; fields aponta qual.
- 422document_share_selfO responsável já administra o documento e não recebe concessão.
- 422document_share_outsiderSó membros desta organização, fora o papel Cliente, recebem acesso.