Skip to content
Plune Plune Docs

Create a snippet

POST
/v1/snippets
 
curl --request POST \
  --url https://beta-api.plune.ai/v1/snippets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "title": "Refund — checklist", "text": "## Steps\n* Open the order and choose “Refund”.\n* Enter the amount and confirm.\n\n## Expected result\nThe refund is listed with the entered amount.", "template": true }'

A titled piece of Markdown. The title is unique within the project (409 otherwise); the text is up to 16 384 bytes. template marks it as a starting point for a new case.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json
object
title
required
string
>= 1 characters <= 200 characters
text
required
string
>= 1 characters
template
boolean
Example 
{
  "title": "Refund — checklist",
  "text": "## Steps\n* Open the order and choose “Refund”.\n* Enter the amount and confirm.\n\n## Expected result\nThe refund is listed with the entered amount.",
  "template": true
}

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Created

Media type application/json
object
id
required
string format: uuid
projectId
required
string
title
required

Unique within the project — the name in the «Insert snippet» menu.

string
>= 1 characters <= 200 characters
text
required

Markdown, up to 16 384 bytes. Inserted into a case as a copy: editing the snippet later changes no case.

string
>= 1 characters
template
required

Listed under «Start from» on a new case when true.

boolean
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
Example 
{
  "id": "6f1c2b3a-0000-4000-8000-0000000000f2",
  "projectId": "u-shop::default",
  "title": "Refund — checklist",
  "text": "## Steps\n* Open the order and choose “Refund”.\n* Enter the amount and confirm.\n\n## Expected result\nThe refund is listed with the entered amount.",
  "template": true,
  "createdAt": "2026-09-16T09:12:04.151Z",
  "updatedAt": "2026-09-16T09:12:04.151Z"
}

400

Section titled “400 ”

Invalid body

Media type application/json
object
error
required
string
Example generated
{
  "error": "example"
}

401

Section titled “401 ”

No / invalid token or session

409

Section titled “409 ”

A snippet of that title exists

Media type application/json
object
error
required
string
Example 
{
  "error": "a snippet titled 'Refund — checklist' already exists"
}

429

Section titled “429 ”

Rate-limited: either the per-route throttle or a tenant quota. Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
  "error": "example"
}

Headers

Section titled “Headers ”
Retry-After
integer

Seconds until the window rolls over