API Keys

List your API keys, create a key limited to some of your projects, for example one per customer project, and revoke one. These endpoints need an account-wide read_write key.

GET`/api_keys`

Your API keys, newest first, revoked ones included, with name, the visible prefix, scope, project_ids (empty for an account-wide key), last_used_at and revoked_at. Never the secret token. Also available below the Scale plan, so old keys can still be revoked.

Params:

page
per_pagedefault 20, max 100

POST`/api_keys`

Create a key limited to the projects in project_ids and owned by the calling key's user. Its secret token is returned only in this response, so store it. The key never sees other projects, and this endpoint never creates an account-wide key. A project you cannot access answers ERR_PROJECT_NOT_FOUND, and past 500 active keys ERR_LIMIT_REACHED until you revoke one. Requires the Scale plan or above.

Body (JSON):

namerequired, up to 100 characters
project_idsrequired, at least one project id
scoperead by default, or read_write

DELETE`/api_keys/:id`

Revoke one of your keys: it stops working immediately and cannot be restored. Revoking it again changes nothing. Also available below the Scale plan.

Path:

:idkey id from GET /api_keys

Returns ERR_NOT_FOUND for a key of another user.

Code Examples

Download: OpenAPI Swagger Postman

Ask AI: Open in ChatGPT Open in Claude View as Markdown

Language

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/api_keys?per_page=20"

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/api_keys?per_page=20",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/api_keys?per_page=20", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/api_keys?per_page=20', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/api_keys?per_page=20"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"name":"Client A","project_ids":["PROJECT_ID"],"scope":"read"}' \
  "https://api.llmpulse.ai/api/v1/api_keys"

const response = await fetch("https://api.llmpulse.ai/api/v1/api_keys", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"name":"Client A","project_ids":["PROJECT_ID"],"scope":"read"})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/api_keys",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"name": "Client A", "project_ids": ["PROJECT_ID"], "scope": "read"}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/api_keys",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "name" => "Client A", "project_ids" => ["PROJECT_ID"], "scope" => "read" }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/api_keys", strings.NewReader(`{"name":"Client A","project_ids":["PROJECT_ID"],"scope":"read"}`))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/api_keys', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['name' => 'Client A', 'project_ids' => ['PROJECT_ID'], 'scope' => 'read']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/api_keys"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{\"name\":\"Client A\",\"project_ids\":[\"PROJECT_ID\"],\"scope\":\"read\"}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X DELETE -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/api_keys/123"

const response = await fetch("https://api.llmpulse.ai/api/v1/api_keys/123", {
  method: "DELETE",
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("DELETE", "https://api.llmpulse.ai/api/v1/api_keys/123", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('DELETE', 'https://api.llmpulse.ai/api/v1/api_keys/123', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/api_keys/123"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .DELETE()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

API Keys

GET/api_keys

POST/api_keys

DELETE/api_keys/:id

GET`/api_keys`

POST`/api_keys`

DELETE`/api_keys/:id`