Update organization disabled state (v1)

Enable or disable read and write access for all documents in a Velt organization using the v1 REST API. Useful when suspending tenant access.

POST /v1/organizations/access/disablestate/update

Update Disabled State for Organizations

cURL

curl --request POST \
  --url https://api.velt.dev/v1/organizations/access/disablestate/update \
  --header 'Content-Type: application/json' \
  --header 'x-velt-api-key: <x-velt-api-key>' \
  --header 'x-velt-auth-token: <x-velt-auth-token>' \
  --data '
{
  "data": {
    "organizationIds": [
      "<string>"
    ],
    "disabled": true
  }
}
'

import requests

url = "https://api.velt.dev/v1/organizations/access/disablestate/update"

payload = { "data": {
        "organizationIds": ["<string>"],
        "disabled": True
    } }
headers = {
    "x-velt-api-key": "<x-velt-api-key>",
    "x-velt-auth-token": "<x-velt-auth-token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-velt-api-key': '<x-velt-api-key>',
    'x-velt-auth-token': '<x-velt-auth-token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({data: {organizationIds: ['<string>'], disabled: true}})
};

fetch('https://api.velt.dev/v1/organizations/access/disablestate/update', 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.velt.dev/v1/organizations/access/disablestate/update",
  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([
    'data' => [
        'organizationIds' => [
                '<string>'
        ],
        'disabled' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-velt-api-key: <x-velt-api-key>",
    "x-velt-auth-token: <x-velt-auth-token>"
  ],
]);

$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.velt.dev/v1/organizations/access/disablestate/update"

	payload := strings.NewReader("{\n  \"data\": {\n    \"organizationIds\": [\n      \"<string>\"\n    ],\n    \"disabled\": true\n  }\n}")

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

	req.Header.Add("x-velt-api-key", "<x-velt-api-key>")
	req.Header.Add("x-velt-auth-token", "<x-velt-auth-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.velt.dev/v1/organizations/access/disablestate/update")
  .header("x-velt-api-key", "<x-velt-api-key>")
  .header("x-velt-auth-token", "<x-velt-auth-token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {\n    \"organizationIds\": [\n      \"<string>\"\n    ],\n    \"disabled\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.velt.dev/v1/organizations/access/disablestate/update")

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

request = Net::HTTP::Post.new(url)
request["x-velt-api-key"] = '<x-velt-api-key>'
request["x-velt-auth-token"] = '<x-velt-auth-token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {\n    \"organizationIds\": [\n      \"<string>\"\n    ],\n    \"disabled\": true\n  }\n}"

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

{
  "result": {
    "status": "success",
    "message": "Updated disable state for Organization(s) successfully.",
    "data": {
      "yourOrganizationId": {
        "success": true,
        "id": "02cf91e5e7a5f4c0b600c84cf248384b",
        "message": "Updated disable state for organization Successfully"
      }
    }
  }
}

Use this API to enable or disable both read and write access for all documents for all users.

Let’s say your customer’s trial or subscription has ended and you want to disable their access to the Velt data, you could use this to disable access to the entire organization data.

If organization does not exist, it will be created.

Endpoint

POST https://api.velt.dev/v1/organizations/access/disablestate/update

Headers

x-velt-api-key · string · required

Your API key.

x-velt-auth-token · string · required

Your Auth Token.

Body

Params

data · object · required

Show properties

organizationIds · string[] · required

Array of Organization IDs

disabled · boolean · required

Whether to disable read and write access to the specified organizations. Allowed values: true, false.

Example Requests

{
  "data": {
    "organizationIds": ["yourOrganizationId1","yourOrganizationId2"],
    "disabled": true
  }
}

Response

Success Response

{
  "result": {
    "status": "success",
    "message": "Updated disable state for Organization(s) successfully.",
    "data": {
      "yourOrganizationId1": {
        "success": true,
        "id": "02cf91e5e7a5f4c0b600c84cf248384b",
        "message": "Updated disable state for organization Successfully"
      },
      "yourOrganizationId2": {
        "success": false,
        "id": "44e0132f4c6b0d453f18df42d2263b4e",
        "message": "Organization does not exist"
      }
    }
  }
}

Failure Response

{
  "error": {
    "message": "ERROR_MESSAGE",
    "status": "INVALID_ARGUMENT"
  }
}

{
  "result": {
    "status": "success",
    "message": "Updated disable state for Organization(s) successfully.",
    "data": {
      "yourOrganizationId": {
        "success": true,
        "id": "02cf91e5e7a5f4c0b600c84cf248384b",
        "message": "Updated disable state for organization Successfully"
      }
    }
  }
}