Add a PermissionPolicy to support users for an organization - m3ter Documentation

Add a PermissionPolicy to support users for an organization

cURL

curl --request POST \
  --url https://api.m3ter.com/organizations/{orgId}/permissionpolicies/{permissionPolicyId}/addtosupportusers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "version": 123
}'
import requests

url = "https://api.m3ter.com/organizations/{orgId}/permissionpolicies/{permissionPolicyId}/addtosupportusers"

payload = { "version": 123 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({version: 123})
};

fetch('https://api.m3ter.com/organizations/{orgId}/permissionpolicies/{permissionPolicyId}/addtosupportusers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [\
  CURLOPT_URL => "https://api.m3ter.com/organizations/{orgId}/permissionpolicies/{permissionPolicyId}/addtosupportusers",\
  CURLOPT_RETURNTRANSFER => true,\
  CURLOPT_ENCODING => "",\
  CURLOPT_MAXREDIRS => 10,\
  CURLOPT_TIMEOUT => 30,\
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\
  CURLOPT_CUSTOMREQUEST => "POST",\
  CURLOPT_POSTFIELDS => json_encode([\
    'version' => 123\
  ]),\
  CURLOPT_HTTPHEADER => [\
    "Authorization: Bearer <token>",\
    "Content-Type: application/json"\
  ],\
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
}
package main

import (
    "fmt"
    "strings"
    "net/http"
    "io"
)

func main() {

url := "https://api.m3ter.com/organizations/{orgId}/permissionpolicies/{permissionPolicyId}/addtosupportusers"

payload := strings.NewReader("{\n  \"version\": 123\n}")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("Authorization", "Bearer <token>")
    req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.post("https://api.m3ter.com/organizations/{orgId}/permissionpolicies/{permissionPolicyId}/addtosupportusers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"version\": 123\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.m3ter.com/organizations/{orgId}/permissionpolicies/{permissionPolicyId}/addtosupportusers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"version\": 123\n}"

response = http.request(request)
puts response.read_body

200

4XX

5XX

Response Schema

{
  "id": "<string>",
  "version": 123,
  "permissionPolicyId": "<string>",
  "principalId": "<string>",
  "dtCreated": "2023-11-07T05:31:56Z",
  "dtLastModified": "2023-11-07T05:31:56Z",
  "createdBy": "<string>",
  "lastModifiedBy": "<string>"
}
{
  "message": "<string>"
}
{
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

m3ter supports machine to machine authentication using the clientCredentials OAuth2 flow.

The authorizationCode flow controls access for human users via the m3ter Console application.

Path Parameters

Body

application/json

Response

application/json

Returns the PrincipalPermission