Skip to main content
POST

Authorizations

​
Authorization
string
header
required

API key starting with sk_case_

Headers

​
ai-reporting-user
string

Stable internal user or customer identifier for AI Gateway cost reporting.

Maximum string length: 256
​
ai-reporting-tags
string

Comma-separated AI Gateway reporting tags. At most 10 unique tags, each 1–64 characters.

Body

application/json
​
title
string
​
model
string | null
​
serviceTier
enum<string>

Processing tier for eligible OpenAI GPT models. Priority provides lower latency at premium cost.

Available options:
default,
priority
​
idleTimeoutMs
integer | null
​
workspaceKey
string

Opt-in persistent workspace identity. Requires conversationKey. Omit both fields to preserve isolated legacy session behavior.

Maximum string length: 512
​
conversationKey
string

Stable conversation identity within workspaceKey. Required in workspace mode and idempotent for repeated creates.

Maximum string length: 512
​
capabilityPolicy
enum<string>

Optional server-enforced capability profile. read_only grants only retrieval/inference service reads; session event ingestion remains bound to the exact managed runtime credential.

Available options:
read_only
​
vaultIds
string[] | null

Legacy explicit whole-vault scope. Mutually exclusive with vaultScopes.

​
vaultScopes
object[] | null

Exact object allowlist per vault. Empty objectIds denies object access for that vault. Mutually exclusive with vaultIds.

​
scopedApiKey
string | null

Optional caller-provided scoped Case.dev API key for the runtime.

​
instructions
string | null

Privileged C3-only hidden app instructions to append to the sandbox AGENTS.md.

​
skillSlugs
string[] | null

Skills API slugs to install into the runtime sandbox before the native session starts.

​
includeDocumentTemplates
boolean | null

When true, inject all active org document templates into the using-document-templates skill.

​
documentTemplateSlugs
string[] | null

Specific document template slugs to inject into the using-document-templates skill.

Response

Linc session created