Get Prompts

List, create, update, and delete prompts for a brand. Prompts are the questions asked to AI models.

Requires authentication

60 req/min

List Prompts

GET/get-prompts

Returns all prompts for a brand. Use active_only=true to filter to only active prompts.

This endpoint uses Supabase UUIDs. Use the brand UUID from the Supabase database, not the Bubble ID from /get-brands.

Query Parameters

brand_idstringrequired

Brand UUID from /get-brands

active_onlyboolean

Only return active prompts

Default: false

tag_idsstring

Comma-separated tag UUIDs to filter prompts by tag

limitinteger

Results per page (1-500)

Default: 100

offsetinteger

Pagination offset

Default: 0

Create Prompt

POST/get-prompts

Create a new prompt for tracking. New prompts are included in the next research run.

Body Parameters

brand_idstringrequired

Brand UUID

textstringrequired

Prompt text (max 500 characters)

activeboolean

Enable tracking immediately

Default: true

focus_areastring

Topic category (see enum below)

intentstring

User intent type (see enum below)

audiencestring

Target audience (see enum below)

Create Prompt

1curl -X POST 'https://api.trakkr.ai/get-prompts' \
2  -H 'Authorization: Bearer $TRAKKR_API_KEY' \
3  -H 'Content-Type: application/json' \
4  -d '{
5    "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
6    "text": "What are the best CRM tools for healthcare?",
7    "active": true,
8    "focus_area": "industry",
9    "intent": "recommendation"
10  }'

Update Prompt

PUT/get-prompts

Update an existing prompt. Include prompt_id in the request body.

Delete Prompt

DELETE/get-prompts?prompt_id={id}

Delete a prompt. Historical data for this prompt will be retained.

Response Fields

Prompt Object

idstring

Unique prompt identifier (UUID)

brand_idstring

Parent brand UUID

textstring

The prompt text sent to AI models

activeboolean

Whether this prompt is being tracked

focus_areastringnullable

Topic category

intentstringnullable

User intent type

audiencestringnullable

Target audience

specificityintegernullable

How specific (1-5)

quality_scoreintegernullable

Effectiveness score (0-100)

sourcestring

"generated", "manual", or "api"

created_atstring

ISO 8601 creation timestamp

updated_atstring

ISO 8601 last update timestamp

tagsarraynullable

Tags assigned to this prompt [{id, name, colour}]

Enum Values

focus_area

generalbudgetenterprisefeaturesuxintegrationscomparisonsindustrygeographictrends

intent

recommendationcomparisonalternativediscoverybest_for

audience

enterprisesmbconsumerdevelopergeneral

Rate Limits

Rate limit: 60 requests/minute for GET. Write operations (POST, PUT, DELETE) are limited to 30 requests/minute.

Code Example

List Prompts

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-prompts?brand_id=c3d4e5f6-a7b8-9012-cdef-345678901234'

200 OK

1{
2  "prompts": [
3    {
4      "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
5      "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
6      "text": "What are the best CRM tools for enterprise?",
7      "active": true,
8      "focus_area": "enterprise",
9      "intent": "recommendation",
10      "audience": "enterprise",
11      "specificity": 3,
12      "quality_score": 85,
13      "source": "generated",
14      "created_at": "2026-01-05T08:00:00Z",
15      "updated_at": "2026-01-08T14:30:00Z",
16      "tags": [
17        { "id": "a1b2c3d4-...", "name": "Enterprise", "colour": "#0e9373" }
18      ]
19    }
20  ],
21  "total": 25,
22  "limit": 100,
23  "offset": 0
24}

List Prompts

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-prompts?brand_id=c3d4e5f6-a7b8-9012-cdef-345678901234'

200 OK

1{
2  "prompts": [
3    {
4      "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
5      "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
6      "text": "What are the best CRM tools for enterprise?",
7      "active": true,
8      "focus_area": "enterprise",
9      "intent": "recommendation",
10      "audience": "enterprise",
11      "specificity": 3,
12      "quality_score": 85,
13      "source": "generated",
14      "created_at": "2026-01-05T08:00:00Z",
15      "updated_at": "2026-01-08T14:30:00Z",
16      "tags": [
17        { "id": "a1b2c3d4-...", "name": "Enterprise", "colour": "#0e9373" }
18      ]
19    }
20  ],
21  "total": 25,
22  "limit": 100,
23  "offset": 0
24}