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
​
modelFallbacks
string[]

Optional ordered availability fallbacks for this session. Requires an explicit model. An empty array disables fallbacks; omission preserves existing runtime behavior. Linc switches within the same session, preserving context.

Maximum array length: 8
Maximum string length: 100
​
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
​
runtimeRetentionDays
integer
default:1

Days the runtime and its saved state are kept after the last activity. Defaults to 1 for standalone sessions; workspace-mode conversations (workspaceKey) and the C3 system key default to indefinite (see runtimeRetention). Once they are deleted, commands to the session answer 410 linc_runtime_expired; its events stay readable. A workspace keeps the value it was created with; a larger value on a later conversation raises it. Applies to Vercel Sandbox runtimes; accepted and stored on Daytona, where it has no effect. Mutually exclusive with runtimeRetention.

Required range: 1 <= x <= 30
​
runtimeRetention
enum<string>

indefinite keeps the runtime and its saved state until the session (or, in workspace mode, its last conversation) is deleted, so a chat can resume after any idle gap. The default in workspace mode; standalone chats opt in with it, one-off runs leave it unset. Raises an existing workspace to indefinite. Mutually exclusive with runtimeRetentionDays.

Available options:
indefinite
​
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.

​
skillsDelivery
enum<string>

Defaults to local preinstallation. MCP is an opt-in, org-allowlisted rollout on a separately pinned image; requires a new standalone session and no skillSlugs preinstallation. Execution remains content-approval gated.

Available options:
local,
mcp
​
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.

​
extensions
object[] | null

Optional caller-supplied executable tool files to install into .linc/extensions/ before the agent starts. Only supported for standalone sessions without capabilityPolicy: read_only. Rejected with a 400 on persistent (workspaceKey/conversationKey) or read_only sessions. At most 10 files, 64KB each, 256KB total. Extension destinations and content hashes are recorded in the session-created audit event; raw code is not logged.

Maximum array length: 10

Response

Linc session created