Tenants - Create

Each new user to the Cogniac system by default has a single tenant created for them. Users have the option to create additional tenants if they wish.

Create a Tenant

To create a tenant, an authorized user should pass the following fields to the /1/tenants endpoint.

Name	Example	Description
name string	"Cogniac Demo"	(required) Brief name, usually including your company name
description string	"Example Cogniac Tenant"	(optional) More descriptive note about your Tenant/focus

Endpoint

POST /1/tenants
Host: https://api.cogniac.io

Example: Create a Tenant

cURL

curl -X POST https://api.cogniac.io/1/tenants \
-H "Authorization: Bearer abcdefg.hijklmnop.qrstuvwxyz" \
-H "Content-Type: application/json" \
-d '{	
	"name": "Cogniac Demo",
	"description": "Example Cogniac Tenant"	
  }'

Python

import requests

my_headers = {"Authorization": "Bearer abcdefg.hijklmnop.qrstuvwxyz"}
tenant_data = {
  "name": "Cogniac Demo",
  "type": "orgtenant", 
  "description": "Example Cogniac Tenant"	
  }
res = requests.post("https://api.cogniac.io/1/tenants", 
                    data=tenant_data, 
                    headers=my_headers)

For instructions on obtaining an authorization token, see Authentication.

Example Response

{
  "tenant_id":"63QhzFLc9tg4",
  "name":"Cogniac Demo",
  "description":"Example Cogniac Tenant",
  "created_at":1455044755,
  "modified_at":1455044755,
  "created_by":"[email protected]"
}

📘

Supported AWS Regions

Cogniac currently supports only us-west-1. Please reach out at [email protected] if you require hosting in a different region.