Stan Settings

Configure Stan's personality, inspect available skills, manage context usage and compaction, browse and resume past conversations, and send messages through the universal Stan message endpoint.

All endpoints require authentication via X-API-Key header and the appropriate scope.

---

Personality Object

{
  "personality": "professional"
}

Valid values: professional, friendly, concise.

---

GET /api/v1/stan/personality

Get the current personality preset for the authenticated user.

Scope: stan:execute

Response 200 OK

{
  "personality": "professional"
}

---

PUT /api/v1/stan/personality

Set the personality preset for the authenticated user.

Scope: stan:execute

Request Body

{
  "personality": "friendly"
}

Field	Type	Required	Description
personality	string	Yes	One of professional, friendly, concise

Response 200 OK

{
  "personality": "friendly"
}

---

GET /api/v1/stan/skills

List all skills available to Stan — both built-in system skills and user-defined skills.

Scope: stan:execute

Response 200 OK

{
  "system": [
    {
      "name": "workflow-builder",
      "category": "build",
      "description": "Build and edit workflows conversationally."
    }
  ],
  "user": [
    {
      "id": "skill_abc001",
      "name": "my-custom-skill",
      "category": "custom",
      "description": "A user-authored skill."
    }
  ]
}

---

GET /api/v1/stan/context

Get the current context-usage stats for the active Stan session.

Scope: stan:execute

Response 200 OK

When no session is active:

{
  "active": false,
  "message": "No active session"
}

When a session is active:

{
  "active": true,
  "totalTokens": 18234,
  "availableTokens": 181766,
  "maxTokens": 200000,
  "usagePercentage": 9,
  "needsCompaction": false
}

---

POST /api/v1/stan/compact

Trigger compaction of the active Stan session's conversation history. Requires an active LLM session.

Scope: stan:execute

Response 200 OK

{
  "compacted": true,
  "messagesCompacted": 24
}

---

GET /api/v1/stan/conversations

List past conversation sessions for the authenticated user.

Scope: stan:execute

Query Parameters

Parameter	Type	Required	Description
limit	integer	No	Number of sessions to return (default: 20)

Response 200 OK

[
  {
    "id": "conv_abc001",
    "title": "Webhook trigger setup",
    "mode": "workflows",
    "modelId": "model_abc123",
    "modelName": "Claude Opus 4.7",
    "messageCount": 14,
    "createdAt": "2025-02-10T10:00:00Z",
    "updatedAt": "2025-02-10T10:42:00Z"
  }
]

---

GET /api/v1/stan/conversations/:id

Get the full record of a past conversation, including all messages.

Scope: stan:execute

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Conversation ID

Response 200 OK

{
  "id": "conv_abc001",
  "title": "Webhook trigger setup",
  "mode": "workflows",
  "modelId": "model_abc123",
  "modelName": "Claude Opus 4.7",
  "messageCount": 14,
  "messages": [
    { "role": "user", "content": "Add a webhook trigger" },
    { "role": "assistant", "content": "Done — added webhook-trigger node." }
  ]
}

---

POST /api/v1/stan/conversations/:id/resume

Resume a past conversation. Restores the conversation's model and mode and reloads up to the last 50 messages into the active session.

Scope: stan:execute

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Conversation ID

Response 200 OK

{
  "resumed": true,
  "title": "Webhook trigger setup",
  "mode": "workflows",
  "modelName": "Claude Opus 4.7",
  "messageCount": 14
}

---

POST /api/v1/stan/message

Universal Stan message endpoint. Routes through stan.sendMessage with full slash-command support — the single entry point for any client (web, mobile) to interact with Stan.

Scope: stan:execute

Request Body

{
  "message": "/help",
  "source": "chat"
}

Field	Type	Required	Description
message	string	Yes	The user message or slash command to send
source	string	No	Originating client surface (default: chat)

Response 200 OK

Returns the full result from stan.sendMessage, including assistant content, tool calls, and any slash-command output.