Presets

Content generation presets

List all presets

get

Returns a list of AI instruction presets that can be used when creating content.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Query parameters

pageintegerOptional

Page number for pagination

Responses

200

A list of presets

application/json

get

/v1/presets

HTTPcURLJavaScriptPython

GET /v1/presets HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

A list of presets

[
  {
    "id": 1,
    "name": "text",
    "description": "text",
    "target_content_type": "general",
    "created_at": "2026-02-04T17:14:58.146Z",
    "updated_at": "2026-02-04T17:14:58.146Z"
  }
]

Create a new preset

post

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

namestring · max: 100Required

descriptionstring · max: 500Optional

presetsobjectOptional

Responses

201

Preset created

application/json

post

/v1/presets

HTTPcURLJavaScriptPython

POST /v1/presets HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 49

{
  "name": "text",
  "description": "text",
  "presets": {}
}

201

Preset created

{
  "id": 1,
  "name": "text",
  "description": "text",
  "target_content_type": "general",
  "created_at": "2026-02-04T17:14:58.146Z",
  "updated_at": "2026-02-04T17:14:58.146Z",
  "presets": {
    "language": "text",
    "location": "text",
    "tone": "text",
    "pov": "text",
    "article_type": "text",
    "extra_prompt": "text",
    "knowledge_sources": [
      1
    ]
  }
}

Get a preset by ID

get

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

idintegerRequired

The preset ID

Responses

200

The preset with full settings

application/json

get

/v1/presets/{id}

HTTPcURLJavaScriptPython

GET /v1/presets/{id} HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

The preset with full settings

{
  "id": 1,
  "name": "text",
  "description": "text",
  "target_content_type": "general",
  "created_at": "2026-02-04T17:14:58.146Z",
  "updated_at": "2026-02-04T17:14:58.146Z",
  "presets": {
    "language": "text",
    "location": "text",
    "tone": "text",
    "pov": "text",
    "article_type": "text",
    "extra_prompt": "text",
    "knowledge_sources": [
      1
    ]
  }
}

Update a preset

put

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

idintegerRequired

The preset ID

Body

application/json

namestring · max: 100Required

descriptionstring · max: 500Optional

presetsobjectOptional

Responses

200

Preset updated

application/json

put

/v1/presets/{id}

HTTPcURLJavaScriptPython

PUT /v1/presets/{id} HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 49

{
  "name": "text",
  "description": "text",
  "presets": {}
}

200

Preset updated

{
  "id": 1,
  "name": "text",
  "description": "text",
  "target_content_type": "general",
  "created_at": "2026-02-04T17:14:58.146Z",
  "updated_at": "2026-02-04T17:14:58.146Z",
  "presets": {
    "language": "text",
    "location": "text",
    "tone": "text",
    "pov": "text",
    "article_type": "text",
    "extra_prompt": "text",
    "knowledge_sources": [
      1
    ]
  }
}

Delete a preset

delete

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

idintegerRequired

The preset ID

Responses

204

Preset deleted

delete

/v1/presets/{id}

HTTPcURLJavaScriptPython

DELETE /v1/presets/{id} HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

204

Preset deleted

No content