# Fibre Cafe : Tenant Updates API

# Introduction

The Fibre Cafe is a scalable, unified platform to support L2C provisioning, in-life modification/cease and
T2R trouble resolution between communication providers (CP) and network operators or aggregators.

CPs are known as 'tenants' on the Fibre Cafe and communicate with this API - the Fibre Cafe's Tenant API. The
network operators and aggregators providing the underlying services are known as 'suppliers'.

Where suppliers need to send updates back to the tenant (KCIs - Keep Customer Informed) then this API will be
called. Each tenant is responsible for implementing this API definition for the Fibre Cage to call.

Examples of KCIs are where the order/problem state and/or order/problem fields have changed or to provide feedback
on any requests e.g. amendment/cancellation submitted on the Tenant API asynchronously.

Unsolicited ceases can also be sent via this API - these will be represented as a new order in the system that
follows a similar but reduced order flow.
__

© 2022-2026 Strategic Imperatives


Version: 1.14

## Servers

```
https://api.provided_by_tenant.net/kcis
```

## Security

### oauth2

The Fibre Cafe can support a number of different authentication mechanisms e.g. OAuth2, Mutual TLS, Basic Auth.
We recommend the industry standard [OAuth 2.0 protocol](https://oauth.net/2/) client credentials flow where possible.


Type: oauth2

## Download OpenAPI description

[Fibre Cafe : Tenant Updates API](https://docs.thefibrecafe.net/_bundle/openapi/prod/tenant-updates-api/gen/index.yaml)

## KCIs

KCI (Keep Customer Informed) updates are sent from a supplier to the tenant to provide order updates.
For example, updates about an inflight order for a new service may include order state changes, delays
and requests for information. A KCI update may represent an unsolicited cease from the supplier.


### Endpoint to receive an update (KCI).

 - [POST /kcis](https://docs.thefibrecafe.net/openapi/prod/tenant-updates-api/gen/kcis/handlekci.md): This endpoint is called by the Fibre Cafe to send an update (KCI) to the tenant.

Each KCI will have timestamps showing when issued by the supplier and the Fibre Cafe
as appropriate. The reason for the KCI will be provided along with the updated
associated entity.