# Cognite Principals API

**Canonical:** https://apis.io/apis/cognite/cognite-principals-api/  
**Provider:** Cognite — https://apis.io/providers/cognite/  
**Base URL:** https://api.cognitedata.com  
**Documentation:** https://api-docs.cognite.com/

Cognite Principals API is one of 90 APIs that [Cognite](https://apis.io/providers/cognite/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Principals. The published artifact set on APIs.io includes an OpenAPI specification.

**Principal** is an umbrella term for **user accounts** and **service accounts**. Both entities can be uniquely identified, authenticated, and authorized in CDF. Principals are unique within an organization, and therefore also within a project in the organization. Principals can access data and create and run processes (transformations, Functions) in a CDF project. * A **user account** is associated with a **person** who wants to interact with CDF. Each user account has a user profile containing a unique user ID. * A **service account** is associated with an **application** or **process** that wants to interact with CDF, such as an extractor or Cognite Functions, rather than a person. ## Authentication for this API Requests to the Principals API are directed to `auth.cognite.com`, like for organizations. Only OAuth tokens issued by `https://auth.cognite.com` (such as the ones issued when logging into Fusion) are accepted by the Principals API. It is also possible to obtain a token by initiating a login flow against the authorization server directly. See the "Authorizations" sections for more information. ## User Accounts The Principals API lets you query user accounts in an organization, and retrieve profiles.

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cognite/refs/heads/main/openapi/cognite-principals-api-openapi.yml

## Other Cognite APIs (12)

- [Cognite Data Fusion API](https://apis.io/apis/cognite/cognite-data-fusion-api/)
- [Cognite 3D Asset Mapping API](https://apis.io/apis/cognite/cognite-3d-asset-mapping-api/)
- [Cognite 3D Files API](https://apis.io/apis/cognite/cognite-3d-files-api/)
- [Cognite 3D Jobs API](https://apis.io/apis/cognite/cognite-3d-jobs-api/)
- [Cognite 3D Model Revisions API](https://apis.io/apis/cognite/cognite-3d-model-revisions-api/)
- [Cognite 3D Models API](https://apis.io/apis/cognite/cognite-3d-models-api/)
- [Cognite Annotations API](https://apis.io/apis/cognite/cognite-annotations-api/)
- [Cognite Assets API](https://apis.io/apis/cognite/cognite-assets-api/)
- [Cognite Connections API](https://apis.io/apis/cognite/cognite-connections-api/)
- [Cognite Containers API](https://apis.io/apis/cognite/cognite-containers-api/)
- [Cognite Data models API](https://apis.io/apis/cognite/cognite-data-models-api/)
- [Cognite Data point subscriptions API](https://apis.io/apis/cognite/cognite-data-point-subscriptions-api/)

## Tags

Principals

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cognite/cognite-principals-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cognite/.