Types & Categories

Get elemental types, categories, and topics

Retrieve available elemental types, categories, and topics for organizing and creating content.

Get Elemental Types

get

Fetch a list of elemental types available in the system.

Type ID	Name	Description
1	Prompt	AI prompt templates with variable tags
2	Snippet	Reusable text blocks
3	Document	Long-form content

Authorizations

ApiKeyAuth

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Responses

200Success

No content

401

Unauthorized

application/json

get

/v1/elemental/types

cURL

curl -X GET "https://api-integrations.snackprompt.com/v1/elemental/types" \
  -H "x-api-key: YOUR_API_KEY"

No content

Get Type Categories

get

Returns available categories for a specific elemental type.

How to Use

Pass the elemental type ID as a path parameter to get categories for that type.

Type ID	Name
1	Prompt
2	Snippet
3	Document

Authorizations

ApiKeyAuth

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Path parameters

type_idinteger · enumRequired

The elemental type ID (1=Prompt, 2=Snippet, 3=Document)

Possible values:

Responses

200

List of categories

application/json

codeintegerOptional

HTTP status code

Example: 200

responseanyOptional

Response data (varies by endpoint)

401

Unauthorized

404

Type not found

application/json

get

/v1/elemental/type/{type_id}/categories

cURL

curl -X GET "https://api-integrations.snackprompt.com/v1/elemental/type/1/categories" \
  -H "x-api-key: YOUR_API_KEY"

{
  "code": 200,
  "meta": {
    "version": "v1.0.2",
    "is_authenticaded": true,
    "limit": 1,
    "offset": 1,
    "total": 1
  },
  "response": null
}

Get Category Topics

get

Returns available topics for a specific category.

Topics are required when creating prompts (type_id=1). Use this endpoint to get valid topic IDs.

Authorizations

ApiKeyAuth

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Path parameters

category_idintegerRequired

Category ID

Responses

200

List of topics

application/json

codeintegerOptional

HTTP status code

Example: 200

responseanyOptional

Response data (varies by endpoint)

401

Unauthorized

404

Category not found

application/json

get

/v1/elemental/type/category/{category_id}/topics

cURL

curl -X GET "https://api-integrations.snackprompt.com/v1/elemental/type/category/1/topics" \
  -H "x-api-key: YOUR_API_KEY"

{
  "code": 200,
  "meta": {
    "version": "v1.0.2",
    "is_authenticaded": true,
    "limit": 1,
    "offset": 1,
    "total": 1
  },
  "response": null
}