Administrators

Administrators are types of members with delegated workspace management permissions, equivalent to those held by the workspace owner.

---

Objects

Administrator

Extends from Member

Path	JSON Type	Format	Description
administrator	bool		Whether or not the member is an administrator

{
  "id" : "auth0|6a20723703fc6f69f29392e4",
  "name" : "sit+2@meltano.com",
  "handle" : "@sit+21",
  "administrator" : true,
  "_links" : {
    "self" : {
      "href" : "https://staging.meltano.com/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/members/auth0%7C6a20723703fc6f69f29392e4"
    }
  }
}

---

Requests

View all administrators of a workspace

GET /api/workspaces/{workspace-id}/administrators

Returns all administrators of the workspace {workspace-id}.

Prerequisites

• The user must be a member of the workspace {workspace-id}

Examples

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://staging.meltano.com:443/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/administrators' -i -X GET

Python (requests)

import requests

url = "https://staging.meltano.com:443/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/administrators"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("GET", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

Administrator collection with HAL links.

{
  "_embedded" : {
    "administrators" : [ {
      "id" : "auth0|6a205ea86a76a69d8a3babcb",
      "name" : "sit@meltano.com",
      "handle" : "@sit1",
      "administrator" : true,
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/members/auth0%7C6a205ea86a76a69d8a3babcb"
        }
      }
    }, {
      "id" : "auth0|6a20723703fc6f69f29392e4",
      "name" : "sit+2@meltano.com",
      "handle" : "@sit+21",
      "administrator" : true,
      "_links" : {
        "self" : {
          "href" : "https://staging.meltano.com/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/members/auth0%7C6a20723703fc6f69f29392e4"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://staging.meltano.com/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/administrators"
    }
  }
}

---

Add an administrator to a workspace

PUT /api/workspaces/{workspace-id}/administrators/{profile-id}

Adds the profile {profile-id} as an administrator to the workspace {workspace-id}.

Prerequisites

• The authenticated user profile must be the owner of the workspace {workspace-id}
• The profile {profile-id} must be a member of the workspace {workspace-id}

Examples

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://staging.meltano.com:443/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/administrators/auth0%7C6a20723703fc6f69f29392e4' -i -X PUT \
    -H 'Content-Type: application/json'

Python (requests)

import requests

url = "https://staging.meltano.com:443/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/administrators/auth0%7C6a20723703fc6f69f29392e4"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("PUT", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

Administrator with HAL links.

{
  "id" : "auth0|6a20723703fc6f69f29392e4",
  "name" : "sit+2@meltano.com",
  "handle" : "@sit+21",
  "administrator" : true,
  "_links" : {
    "self" : {
      "href" : "https://staging.meltano.com/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/members/auth0%7C6a20723703fc6f69f29392e4"
    }
  }
}

---

Withdraw an administrator from a workspace

DELETE /api/workspaces/{workspace-id}/administrators/{profile-id}

Withdraws the profile {profile-id} as an administrator from the workspace {workspace-id}.

Prerequisites

• The authenticated user profile must be the owner of the workspace {workspace-id}
• The profile {profile-id} must be an administrator of the workspace {workspace-id}

Examples

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://staging.meltano.com:443/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/administrators/auth0%7C6a20723703fc6f69f29392e4' -i -X DELETE

Python (requests)

import requests

url = "https://staging.meltano.com:443/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/administrators/auth0%7C6a20723703fc6f69f29392e4"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("DELETE", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

Administrator with HAL links.

{
  "id" : "auth0|6a20723703fc6f69f29392e4",
  "name" : "sit+2@meltano.com",
  "handle" : "@sit+21",
  "administrator" : false,
  "_links" : {
    "self" : {
      "href" : "https://staging.meltano.com/api/workspaces/fd4b6cbc-8f64-407f-9a9d-f983c326090f/members/auth0%7C6a20723703fc6f69f29392e4"
    }
  }
}

---