HTTP API

List managers

GET

/v1/documents/{document_id}/managers

const url = 'https://sergo.example.com/v1/documents/example/managers';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://sergo.example.com/v1/documents/example/managers \
  --header 'Authorization: Bearer <token>'

Who can manage the document: its owner first, then people it was shared with, then people who manage a folder above it.

Authorizations

key

Parameters

Path Parameters

document_id

required

Document Id

string

Responses

200

Successful Response

application/json

ManagerList

object

items

required

Items

Array<object>

Manager

object

username

required

Username

string

name

required

Name

string

inherited_from

required

The folder above that this person manages, when their access comes from there

Any of:

Ref
null

Ref

object

required

string

name

required

Name

Its name, or null if it was deleted

Any of:

string
null

string

owner

required

Owner

Whether this is the owner — the person whose My documents it is in

boolean

Example

{
  "items": [
    {
      "owner": false
    }
  ]
}

422

Validation Error

application/json

RequestError

object

code

required

Code

string

Allowed value: invalid_request

message

required

Message

What was wrong, field by field

string

Example

{
  "code": "invalid_request"
}