Overview

The Peaka Partner API uses API keys for authentication.

There are two types of API keys:

While Project API Keys are restricted to project-specific resources, Partner API Keys provide broader access across all available resources.

Authentication

To authenticate requests, include the API key in the Authorization header as a Bearer token. The format is as follows:

Authorization: Bearer <API Key>

This ensures secure authentication for API requests, with access based on the type of API key used.

Example: Using a Partner API Key

A Partner API Key can perform all actions that a Project API Key can, plus additional partner-level operations. For example, to list all organizations accessible by the partner:

GET api/v1/organizations
Authorization: Bearer <Partner API Key>

This returns all organizations and related resources the partner has access to.

You can also use a Partner API Key to access endpoints scoped to a specific project. For example, to list catalogs within a project:

GET api/v1/data/projects/{projectId}/catalogs
Authorization: Bearer <Partner API Key>

This returns data catalogs associated only with that project.

Example: Using a Project API Key

You can use a Project API Key to access endpoints scoped to a specific project. (Whenever you see projects/{projectId} in the path of an endpoint, it is scoped to the project.)

For example, to list catalogs within a project:

GET api/v1/data/projects/{projectId}/catalogs
Authorization: Bearer <Project API Key>

Replace {projectId} with the ID of your project.

This returns data catalogs associated only with that project.