Skip to main content
Creating an Organization API key requires organization admin access in Logfire.

Organization API key

An Organization API key works across every project in your Logfire organization.

1

Start a new API key

Sign in to the Logfire EU console, or the Logfire US console for the US region.

  • Click your organization name in the top-left corner.
  • Click Org settings.
  • In the sidebar, click API keys.
  • Click + New API key.
Logfire organization menu opened from the top-left header with the Org settings item highlighted
2

Configure the key

Fill in the New API key form.

  • Name: StackOne Integration
  • Key type: Organization
  • Permissions: tick Read, Manage and Org administration
New API key form with the Organization key type and the Read permission category highlighted
3

Choose individual scopes (optional)

Enables actions: Create Alert, Create Channel, Create Dashboard, Create Organization Invitation, Create Project, Create Project Write Token, Create Schedule, Create Variable, Delete Alert, Delete Channel, Delete Current Organization, Delete Dashboard, Delete Project, Delete Project Write Token, Delete Schedule, Expire Project Write Token, Get Alert, Get Channel, Get Current Organization, Get Dashboard, Get Project Info, Get Schedule, Get Variable By Name, Get Variables Config, List Alerts, List Channels, List Dashboards, List Organization Invitations, List Project Write Tokens, List Projects, Rotate Project Write Token, Update Alert, Update Channel, Update Current Organization, Update Dashboard, Update Project, Update Schedule, Update Variable

To give the key fewer permissions, leave the Permissions categories unticked.

  • Expand Advanced.
  • Under Organization Scopes and Project Scopes, tick only the scopes listed.
Advanced section expanded on the New API key form showing individual Organization and Project scope checkboxes
4

Create the key

Finish the form.

  • Expiration: No expiration, or the duration your security policy requires
  • Click Create API key.
New API key form showing the Expiration field and the Create API key button highlighted
5

Copy the API key

Copy the API Key across.

  • The key is shown only once and cannot be retrieved later.
  • The key starts with pylf_v2_eu_ (EU) or pylf_v2_us_ (US).

Find your API region URL

The API Region URL matches the region of the Logfire console you signed in to.

  • Format: https://api-{region}.pydantic.dev
  • Example: if your console is https://logfire-us.pydantic.dev, your API Region URL is https://api-us.pydantic.dev
1

Connect

  • Click Connect.
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.