Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

KISI Organizations API

The Organizations API from KISI — 13 operation(s) for organizations.

KISI Organizations API is one of 48 APIs that KISI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Organizations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

This API exposes 14 operations across 13 paths, and defines 2 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.kisi.io.

14 operations 13 paths 2 schemas 6 GET1 PATCH7 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.kisi.io
Authentication
API Key, API Key, API Key, API Key, API Key, HTTP Basic, OAuth 2.0
Resource Areas
1

Authentication & Security 7

KISI Organizations API declares 7 security schemes for authenticating requests. An API key is passed in the header as X-Signature (Webhook-Signature). An API key is passed in the header as Authorization (Kisi-Login). An API key is passed in the header as Authorization (Kisi-Access-Key). An API key is passed in the header as Authorization (Kisi-Group-Link). An API key is passed in the header as Authorization (Kisi-Service). It accepts HTTP basic authentication (OAuth2Basic). It supports OAuth 2.0 (OAuth2) using the authorizationCode flow.

  • Webhook-Signature — Authorize using a signature of the request body. The signature is a HMAC-SHA256 hash of the request body using a secret key. E.g. X-Signature: 123
  • Kisi-Login — Authorize using a login. Prefix the value with KISI-LOGIN Example: Authorization: KISI-LOGIN 123
  • Kisi-Access-Key — Authorize using an access key. Prefix the value with KISI-ACCESS-KEY Example: Authorization: KISI-ACCESS-KEY 123
  • Kisi-Group-Link — Authorize using a group link. Prefix the value with KISI-GROUP-LINK Example: Authorization: KISI-GROUP-LINK 123
  • Kisi-Service — Authorize using a service. Prefix the value with KISI-SERVICE Example: Authorization: KISI-SERVICE 123
  • OAuth2Basic — Username is the client id. Password is the client secret.
  • OAuth2 — OAuth access tokens are sent as bearer tokens. Example: Authorization: Bearer youraccesstoken

Paths & Operations 14

Across 13 paths, the API surfaces 14 operations — 6 GET, 1 PATCH, 7 POST. Each is listed below with its method, path, parameters, and response codes.

Organizations 14
GET
/organizations
Fetch organizations
fetchOrganizations → 200401
GET
/organizations/{domain}/public
Fetch public organization
fetchPublicOrganization 1 param → 200404
POST
/organizations/find
Find my organizations
findOrganizations body → 204422
GET
/organization
Fetch current organization
fetchCurrentOrganization → 200401
PATCH
/organization
Update current organization
updateCurrentOrganization body → 204401403422
GET
/organization/settings
Fetch current organization settings
fetchCurrentOrganizationSettings → 200401403
GET
/organization/dashboard
Fetch current organization dashboard
fetchCurrentOrganizationDashboard → 200401
POST
/organization/generate_next_certificate
Generate next certificate
generateNextCertificate → 200401403
POST
/organization/rotate_certificate
Rotate certificate
rotateCertificate → 204401403422
GET
/organization/transfers
Fetch current user's organization transfers
fetchOrganizationTransfers → 200401
POST
/organization/request_transfer
Request transfer
requestTransfer body → 204401403422
POST
/organization/accept_transfer
Accept transfer
acceptTransfer → 204401403
POST
/organization/reject_transfer
Reject transfer
rejectTransfer → 204401403
POST
/organization/cancel_transfer
Cancel transfer
cancelTransfer → 204401403

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are Error (2 properties), Errors (1 property). Each schema is shown below with its type and property counts.

Errors
object
Schema describing validation errors.
1 property 1 required
Error
object
Schema describing errors.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kisi-organizations-api-openapi.yml Raw ↑

Other APIs KISI publishes across the network.

KISI Calendars API
KISI Cameras API
KISI Card assignments API
KISI Cards API
KISI Controller Input Connections API
KISI Controller Inputs API
KISI Controller Relay Connections API
KISI Controller Relays API
KISI Controller Wiegand Connections API
KISI Controller Wiegands API
KISI Controllers API
KISI CSV card imports API