Collections & Tags

Collections (in der App: Tags) gruppieren Prompts nach Thema, Funnel-Phase oder Kampagne, sodass sich jede Kennzahl danach filtern lässt. Ein Prompt kann zu mehreren Collections gehören.

GET`/dimensions/collections`

Listet die Collections (in der App: Tags) des Projekts auf.

GET`/dimensions/tags`

Alias für /dimensions/collections. Liefert dieselbe Payload, aber wie in der App unter dem Namen tags.

POST`/collections`

Erstellt ein Tag (Collection) in einem Projekt. Optional können Sie dem Tag im selben Aufruf bestehende Prompts zuweisen. Der Tag-Name muss innerhalb eines Projekts eindeutig sein, unabhängig von Groß- und Kleinschreibung.

Anfragetext (JSON):

project_iderforderlich
nameerforderlich
descriptionoptional
prompt_idsoptional, Array, die Prompts müssen zum Projekt gehören

PATCH/DELETE /collections/:id

Benennt ein Tag um, ändert seine Beschreibung oder löscht es. Beim Löschen eines Tags bleiben die zugehörigen Prompts erhalten; nur die Gruppierung entfällt. Welche Prompts zu einem Tag gehören, verwalten Sie über POST /prompts/assign_tags und POST /prompts/remove_tags.

PATCH-Anfragetext: project_id (erforderlich), name und/oder description. DELETE: project_id + :id in der URL.

POST`/prompts/assign_tags`

Idempotente Massenzuweisung von Tags zu bestehenden Prompts. Tags können über ihre ID oder ihren Namen angegeben werden.

Anfragetext (JSON):

project_iderforderlich
prompt_idserforderlich, Array
tag_idseiner von beiden
tag_nameseiner von beiden
create_missingoptional, boolescher Wert; legt Tags für unbekannte Namen automatisch an

POST`/prompts/remove_tags`

Idempotentes Entfernen von Tags bei vielen bestehenden Prompts auf einmal. Entfernt werden nur die Zuordnungen; Tags und Prompts bleiben erhalten.

Anfragetext (JSON): project_id (erforderlich), prompt_ids (erforderlich, Array, maximal 500), tag_ids und/oder tag_names (maximal 50 Tags).

Codebeispiele

Download: OpenAPI Swagger Postman

KI fragen: In ChatGPT öffnen In Claude öffnen Als Markdown anzeigen

Sprache

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/dimensions/collections?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/collections?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/collections?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/dimensions/collections?project_id=PROJECT_ID",
  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/dimensions/collections?project_id=PROJECT_ID", 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/dimensions/collections?project_id=PROJECT_ID', [
    '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/dimensions/collections?project_id=PROJECT_ID"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/dimensions/tags?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/tags?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/tags?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/dimensions/tags?project_id=PROJECT_ID",
  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/dimensions/tags?project_id=PROJECT_ID", 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/dimensions/tags?project_id=PROJECT_ID', [
    '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/dimensions/tags?project_id=PROJECT_ID"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Response

{ "project_id":4, "collections":[ { "id":7, "name":"Brand: ACME" } ], "request_id":"..." }

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","name":"Branded prompts","description":"Prompts that mention us","prompt_ids":[101,102]}' \
  "https://api.llmpulse.ai/api/v1/collections"

const response = await fetch("https://api.llmpulse.ai/api/v1/collections", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","name":"Branded prompts","description":"Prompts that mention us","prompt_ids":[101,102]})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/collections",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID", "name": "Branded prompts", "description": "Prompts that mention us", "prompt_ids": [101, 102]}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/collections",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID", "name" => "Branded prompts", "description" => "Prompts that mention us", "prompt_ids" => [101, 102] }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/collections", strings.NewReader(`{"project_id":"PROJECT_ID","name":"Branded prompts","description":"Prompts that mention us","prompt_ids":[101,102]}`))
	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/collections', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID', 'name' => 'Branded prompts', 'description' => 'Prompts that mention us', 'prompt_ids' => [101, 102]]
]);
$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/collections"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"name\":\"Branded prompts\",\"description\":\"Prompts that mention us\",\"prompt_ids\":[101,102]}"))
            .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 '{"project_id":"PROJECT_ID","prompt_ids":[101,102],"tag_names":["priority"],"create_missing":true}' \
  "https://api.llmpulse.ai/api/v1/prompts/assign_tags"

const response = await fetch("https://api.llmpulse.ai/api/v1/prompts/assign_tags", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","prompt_ids":[101,102],"tag_names":["priority"],"create_missing":true})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/prompts/assign_tags",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID", "prompt_ids": [101, 102], "tag_names": ["priority"], "create_missing": True}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/prompts/assign_tags",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID", "prompt_ids" => [101, 102], "tag_names" => ["priority"], "create_missing" => true }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/prompts/assign_tags", strings.NewReader(`{"project_id":"PROJECT_ID","prompt_ids":[101,102],"tag_names":["priority"],"create_missing":true}`))
	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/prompts/assign_tags', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID', 'prompt_ids' => [101, 102], 'tag_names' => ['priority'], 'create_missing' => true]
]);
$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/prompts/assign_tags"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"prompt_ids\":[101,102],\"tag_names\":[\"priority\"],\"create_missing\":true}"))
            .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 '{"project_id":"PROJECT_ID","prompt_ids":[101,102],"tag_names":["priority"]}' \
  "https://api.llmpulse.ai/api/v1/prompts/remove_tags"

const response = await fetch("https://api.llmpulse.ai/api/v1/prompts/remove_tags", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","prompt_ids":[101,102],"tag_names":["priority"]})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/prompts/remove_tags",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID", "prompt_ids": [101, 102], "tag_names": ["priority"]}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/prompts/remove_tags",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID", "prompt_ids" => [101, 102], "tag_names" => ["priority"] }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/prompts/remove_tags", strings.NewReader(`{"project_id":"PROJECT_ID","prompt_ids":[101,102],"tag_names":["priority"]}`))
	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/prompts/remove_tags', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID', 'prompt_ids' => [101, 102], 'tag_names' => ['priority']]
]);
$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/prompts/remove_tags"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"prompt_ids\":[101,102],\"tag_names\":[\"priority\"]}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Collections & Tags

GET/dimensions/collections

GET/dimensions/tags

POST/collections

PATCH/DELETE /collections/:id

POST/prompts/assign_tags

POST/prompts/remove_tags

GET`/dimensions/collections`

GET`/dimensions/tags`

POST`/collections`

POST`/prompts/assign_tags`

POST`/prompts/remove_tags`