CAcasemark
Agents/Linc

Create native Linc session

Changed on

Creates a native Linc session in a sandboxed runtime with scoped Case.dev credentials. This endpoint starts the sandbox actor only; messages and event replay use separate endpoints.

post/linc/v1/sessions

Request

  • Base URL
    https://api.case.dev
  • URL
    https://api.case.dev/linc/v1/sessions
  • Auth
    HTTP bearer

Headers

ai-reporting-userstring

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

ai-reporting-tagsstring

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

Request body

titlestring
modelstring nullable
modelFallbacksstring[]

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.

serviceTier'default' | 'priority'

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

idleTimeoutMsinteger nullable
workspaceKeystring

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

conversationKeystring

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

runtimeRetentionDaysinteger

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.

runtimeRetention'indefinite'

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.

capabilityPolicy'read_only'

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

vaultIdsstring[] nullable

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

scopedApiKeystring nullable

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

instructionsstring nullable

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

skillSlugsstring[] nullable

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

skillsDelivery'local' | 'mcp'

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.

includeDocumentTemplatesboolean nullable

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

documentTemplateSlugsstring[] nullable

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

Response

Linc session created

Changes

  • 0342b8b0c63bRevision changes
    • breaking

      the response property became nullable for the status

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

  • 67fe26768ee0Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status