Docs
API Reference
Me
Get the authenticated principal

Get the authenticated principal

Returns the API key presented on the request, together with the active organization, the abilities currently in effect, and the projects you may act in.

GET /api/v1/me

The response carries four top-level keys: organization, abilities, projects, and api_key. The abilities array is taken directly from the API key's grants.

Response

The authenticated principal

Field	Type	Description
organization	Organization	The active organization the API key is bound to.
abilities	string[]	The abilities currently in effect for the request, taken from the API key itself.
projects	Project[]	The projects in the active organization that the caller may act in.
api_key	ApiKeyMetadata	Metadata describing the API key used on the request.

API key metadata

Field	Type	Description
id	integer	The unique ID of the API key.
name	string	The label you gave the key when you created it.
last_used_at	datetime	When the key was last used to authenticate a request, or `null` when it has not yet been used.
created_at	datetime	When the key was created.

import os import requests response = requests.get( "https://pineprompt.com/api/v1/me", headers={ "Authorization": f"Bearer {os.environ['PINEPROMPT_TOKEN']}", }, ) response.raise_for_status() payload = response.json()

use GuzzleHttp\Client; $response = (new Client())->get('https://pineprompt.com/api/v1/me', [ 'headers' => [ 'Authorization' => 'Bearer '.getenv('PINEPROMPT_TOKEN'), ], ]); // Guzzle throws on 4xx/5xx by default, so no manual check needed. $payload = json_decode((string) $response->getBody(), true);

{ "organization": { "id": 7, "name": "Acme Inc.", "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" }, "abilities": [ "organization:read", "monitors:read", "monitors:write" ], "projects": [ { "id": 42, "organization_id": 7, "name": "Acme Marketing", "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" } ], "api_key": { "id": 84, "name": "CI pipeline", "last_used_at": "2026-05-15T09:11:42+00:00", "created_at": "2026-05-15T09:11:42+00:00" } }