Haijun Platform Docs
ID

Add Session Resource

POST /v1/sessions/{session_id}/resources

Add Session Resource

Path parameters

  • session_id: string

Headers

  • "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

  • string
  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
  • "message-batches-2024-09-24"
  • "prompt-caching-2024-07-31"
  • "computer-use-2024-10-22"
  • "computer-use-2025-01-24"
  • "pdfs-2024-09-25"
  • "token-counting-2024-11-01"
  • "token-efficient-tools-2025-02-19"
  • "output-128k-2025-02-19"
  • "files-api-2025-04-14"
  • "mcp-client-2025-04-04"
  • "mcp-client-2025-11-20"
  • "dev-full-thinking-2025-05-14"
  • "interleaved-thinking-2025-05-14"
  • "code-execution-2025-05-22"
  • "extended-cache-ttl-2025-04-11"
  • "context-1m-2025-08-07"
  • "context-management-2025-06-27"
  • "model-context-window-exceeded-2025-08-26"
  • "tracks-2025-10-02"
  • "fast-mode-2026-02-01"
  • "output-300k-2026-03-24"
  • "user-profiles-2026-03-24"
  • "user-profiles-2026-08-18"
  • "user-profiles-2026-09-04"
  • "advisor-tool-2026-03-01"
  • "managed-agents-2026-04-01"
  • "cache-diagnosis-2026-04-07"
  • "dreaming-2026-04-21"
  • "thinking-token-count-2026-05-13"
  • "server-side-fallback-2026-06-01"
  • "server-side-fallback-2026-07-01"
  • "fallback-credit-2026-06-01"
  • "fallback-credit-2026-07-01"
  • "agent-memory-2026-07-22"
  • "mid-conversation-tool-changes-2026-07-01"
  • "compact-2026-01-12"
  • "computer-use-2025-11-24"
  • "mcp-tunnels-2026-06-22"
  • "structured-outputs-2025-11-13"
  • "task-budgets-2026-03-13"
  • "thinking-display-updates-2026-08-18"
  • "ce-user-management-2026-07-13"
  • "mid-conversation-output-config-2026-07-01"
  • "thinking-binding-controls-2026-08-01"
  • "mid-conversation-system-clear-at-2026-08-21"
  • "compact-2026-09-04"
  • "inline-tools-2026-09-15"
  • "mcp-client-2026-09-15"
  • "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Body parameters

  • file_id: string

ID of a previously uploaded file.

minLength: 1, maxLength: 128

  • type: "file"
  • mount_path: optional string or null

Mount path in the container. Defaults to /mnt/session/uploads/.

minLength: 1, maxLength: 4096

Returns

  • BetaManagedAgentsFileResource object
  • type: "file"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • file_id: string
  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

Example

bash
curl https://haijun.my.id/v1/sessions/$SESSION_ID/resources \
    -H 'Content-Type: application/json' \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $JUGLOW_API_KEY" \
    -d '{
          "file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
          "type": "file",
          "mount_path": "/uploads/receipt.pdf"
        }'

Response (200)

json
{
  "id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",
  "created_at": "2026-03-15T10:00:00Z",
  "file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
  "mount_path": "/uploads/receipt.pdf",
  "type": "file",
  "updated_at": "2026-03-15T10:00:00Z"
}

List Session Resources

GET /v1/sessions/{session_id}/resources

List Session Resources

Path parameters

  • session_id: string

Query parameters

  • limit: optional number

Maximum number of resources to return per page (max 1000). If omitted, returns all resources.

format: int32

  • page: optional string

Opaque cursor from a previous response's next_page field.

Headers

  • "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

  • string
  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
  • "message-batches-2024-09-24"
  • "prompt-caching-2024-07-31"
  • "computer-use-2024-10-22"
  • "computer-use-2025-01-24"
  • "pdfs-2024-09-25"
  • "token-counting-2024-11-01"
  • "token-efficient-tools-2025-02-19"
  • "output-128k-2025-02-19"
  • "files-api-2025-04-14"
  • "mcp-client-2025-04-04"
  • "mcp-client-2025-11-20"
  • "dev-full-thinking-2025-05-14"
  • "interleaved-thinking-2025-05-14"
  • "code-execution-2025-05-22"
  • "extended-cache-ttl-2025-04-11"
  • "context-1m-2025-08-07"
  • "context-management-2025-06-27"
  • "model-context-window-exceeded-2025-08-26"
  • "tracks-2025-10-02"
  • "fast-mode-2026-02-01"
  • "output-300k-2026-03-24"
  • "user-profiles-2026-03-24"
  • "user-profiles-2026-08-18"
  • "user-profiles-2026-09-04"
  • "advisor-tool-2026-03-01"
  • "managed-agents-2026-04-01"
  • "cache-diagnosis-2026-04-07"
  • "dreaming-2026-04-21"
  • "thinking-token-count-2026-05-13"
  • "server-side-fallback-2026-06-01"
  • "server-side-fallback-2026-07-01"
  • "fallback-credit-2026-06-01"
  • "fallback-credit-2026-07-01"
  • "agent-memory-2026-07-22"
  • "mid-conversation-tool-changes-2026-07-01"
  • "compact-2026-01-12"
  • "computer-use-2025-11-24"
  • "mcp-tunnels-2026-06-22"
  • "structured-outputs-2025-11-13"
  • "task-budgets-2026-03-13"
  • "thinking-display-updates-2026-08-18"
  • "ce-user-management-2026-07-13"
  • "mid-conversation-output-config-2026-07-01"
  • "thinking-binding-controls-2026-08-01"
  • "mid-conversation-system-clear-at-2026-08-21"
  • "compact-2026-09-04"
  • "inline-tools-2026-09-15"
  • "mcp-client-2026-09-15"
  • "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns

  • data: array of BetaManagedAgentsSessionResource

Resources for the session, ordered by created_at.

  • BetaManagedAgentsGitHubRepositoryResource object
  • type: "github_repository"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • url: string
  • checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null
  • BetaManagedAgentsBranchCheckout object
  • type: "branch"
  • name: string

Branch name to check out.

minLength: 1, maxLength: 255

  • BetaManagedAgentsCommitCheckout object
  • type: "commit"
  • sha: string

Full commit SHA to check out.

minLength: 7, maxLength: 64

  • BetaManagedAgentsFileResource object
  • type: "file"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • file_id: string
  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • BetaManagedAgentsMemoryStoreResource object

A memory store attached to an agent session.

  • type: "memory_store"
  • memory_store_id: string

The memory store ID (memstore_...). Must belong to the caller's organization and workspace.

  • access: optional "read_write" or "read_only" or null

Access mode for the mounted store. Defaults to read_write. read_only mounts the store as a read-only filesystem.

  • "read_write"
  • "read_only"
  • description: optional string

Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.

  • instructions: optional string or null

Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.

maxLength: 4096

  • mount_path: optional string or null

Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.

  • name: optional string or null

Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.

  • next_page: optional string or null

Opaque cursor for the next page. Null when no more results.

Example

bash
curl https://haijun.my.id/v1/sessions/$SESSION_ID/resources \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $JUGLOW_API_KEY"

Response (200)

json
{
  "data": [
    {
      "id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",
      "created_at": "2026-03-15T10:00:00Z",
      "file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
      "mount_path": "/uploads/receipt.pdf",
      "type": "file",
      "updated_at": "2026-03-15T10:00:00Z"
    },
    {
      "id": "sesrsc_011CZkZCKr6eXyl0gWMOdQiu",
      "created_at": "2026-03-15T10:00:00Z",
      "mount_path": "/workspace/example-repo",
      "type": "github_repository",
      "updated_at": "2026-03-15T10:00:00Z",
      "url": "https://github.com/example-org/example-repo",
      "checkout": {
        "name": "main",
        "type": "branch"
      }
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

Get Session Resource

GET /v1/sessions/{session_id}/resources/{resource_id}

Get Session Resource

Path parameters

  • session_id: string
  • resource_id: string

Headers

  • "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

  • string
  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
  • "message-batches-2024-09-24"
  • "prompt-caching-2024-07-31"
  • "computer-use-2024-10-22"
  • "computer-use-2025-01-24"
  • "pdfs-2024-09-25"
  • "token-counting-2024-11-01"
  • "token-efficient-tools-2025-02-19"
  • "output-128k-2025-02-19"
  • "files-api-2025-04-14"
  • "mcp-client-2025-04-04"
  • "mcp-client-2025-11-20"
  • "dev-full-thinking-2025-05-14"
  • "interleaved-thinking-2025-05-14"
  • "code-execution-2025-05-22"
  • "extended-cache-ttl-2025-04-11"
  • "context-1m-2025-08-07"
  • "context-management-2025-06-27"
  • "model-context-window-exceeded-2025-08-26"
  • "tracks-2025-10-02"
  • "fast-mode-2026-02-01"
  • "output-300k-2026-03-24"
  • "user-profiles-2026-03-24"
  • "user-profiles-2026-08-18"
  • "user-profiles-2026-09-04"
  • "advisor-tool-2026-03-01"
  • "managed-agents-2026-04-01"
  • "cache-diagnosis-2026-04-07"
  • "dreaming-2026-04-21"
  • "thinking-token-count-2026-05-13"
  • "server-side-fallback-2026-06-01"
  • "server-side-fallback-2026-07-01"
  • "fallback-credit-2026-06-01"
  • "fallback-credit-2026-07-01"
  • "agent-memory-2026-07-22"
  • "mid-conversation-tool-changes-2026-07-01"
  • "compact-2026-01-12"
  • "computer-use-2025-11-24"
  • "mcp-tunnels-2026-06-22"
  • "structured-outputs-2025-11-13"
  • "task-budgets-2026-03-13"
  • "thinking-display-updates-2026-08-18"
  • "ce-user-management-2026-07-13"
  • "mid-conversation-output-config-2026-07-01"
  • "thinking-binding-controls-2026-08-01"
  • "mid-conversation-system-clear-at-2026-08-21"
  • "compact-2026-09-04"
  • "inline-tools-2026-09-15"
  • "mcp-client-2026-09-15"
  • "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns

  • BetaManagedAgentsGitHubRepositoryResource object
  • type: "github_repository"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • url: string
  • checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null
  • BetaManagedAgentsBranchCheckout object
  • type: "branch"
  • name: string

Branch name to check out.

minLength: 1, maxLength: 255

  • BetaManagedAgentsCommitCheckout object
  • type: "commit"
  • sha: string

Full commit SHA to check out.

minLength: 7, maxLength: 64

  • BetaManagedAgentsFileResource object
  • type: "file"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • file_id: string
  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • BetaManagedAgentsMemoryStoreResource object

A memory store attached to an agent session.

  • type: "memory_store"
  • memory_store_id: string

The memory store ID (memstore_...). Must belong to the caller's organization and workspace.

  • access: optional "read_write" or "read_only" or null

Access mode for the mounted store. Defaults to read_write. read_only mounts the store as a read-only filesystem.

  • "read_write"
  • "read_only"
  • description: optional string

Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.

  • instructions: optional string or null

Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.

maxLength: 4096

  • mount_path: optional string or null

Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.

  • name: optional string or null

Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.

Example

bash
curl https://haijun.my.id/v1/sessions/$SESSION_ID/resources/$RESOURCE_ID \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $JUGLOW_API_KEY"

Response (200)

json
{
  "id": "sesrsc_011CZkZCKr6eXyl0gWMOdQiu",
  "created_at": "2026-03-15T10:00:00Z",
  "mount_path": "/workspace/example-repo",
  "type": "github_repository",
  "updated_at": "2026-03-15T10:00:00Z",
  "url": "https://github.com/example-org/example-repo",
  "checkout": {
    "name": "main",
    "type": "branch"
  }
}

Update Session Resource

POST /v1/sessions/{session_id}/resources/{resource_id}

Update Session Resource

Path parameters

  • session_id: string
  • resource_id: string

Headers

  • "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

  • string
  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
  • "message-batches-2024-09-24"
  • "prompt-caching-2024-07-31"
  • "computer-use-2024-10-22"
  • "computer-use-2025-01-24"
  • "pdfs-2024-09-25"
  • "token-counting-2024-11-01"
  • "token-efficient-tools-2025-02-19"
  • "output-128k-2025-02-19"
  • "files-api-2025-04-14"
  • "mcp-client-2025-04-04"
  • "mcp-client-2025-11-20"
  • "dev-full-thinking-2025-05-14"
  • "interleaved-thinking-2025-05-14"
  • "code-execution-2025-05-22"
  • "extended-cache-ttl-2025-04-11"
  • "context-1m-2025-08-07"
  • "context-management-2025-06-27"
  • "model-context-window-exceeded-2025-08-26"
  • "tracks-2025-10-02"
  • "fast-mode-2026-02-01"
  • "output-300k-2026-03-24"
  • "user-profiles-2026-03-24"
  • "user-profiles-2026-08-18"
  • "user-profiles-2026-09-04"
  • "advisor-tool-2026-03-01"
  • "managed-agents-2026-04-01"
  • "cache-diagnosis-2026-04-07"
  • "dreaming-2026-04-21"
  • "thinking-token-count-2026-05-13"
  • "server-side-fallback-2026-06-01"
  • "server-side-fallback-2026-07-01"
  • "fallback-credit-2026-06-01"
  • "fallback-credit-2026-07-01"
  • "agent-memory-2026-07-22"
  • "mid-conversation-tool-changes-2026-07-01"
  • "compact-2026-01-12"
  • "computer-use-2025-11-24"
  • "mcp-tunnels-2026-06-22"
  • "structured-outputs-2025-11-13"
  • "task-budgets-2026-03-13"
  • "thinking-display-updates-2026-08-18"
  • "ce-user-management-2026-07-13"
  • "mid-conversation-output-config-2026-07-01"
  • "thinking-binding-controls-2026-08-01"
  • "mid-conversation-system-clear-at-2026-08-21"
  • "compact-2026-09-04"
  • "inline-tools-2026-09-15"
  • "mcp-client-2026-09-15"
  • "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Body parameters

  • authorization_token: string

New authorization token for the resource. Currently only github_repository resources support token rotation.

minLength: 1, maxLength: 4096

Returns

  • BetaManagedAgentsGitHubRepositoryResource object
  • type: "github_repository"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • url: string
  • checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null
  • BetaManagedAgentsBranchCheckout object
  • type: "branch"
  • name: string

Branch name to check out.

minLength: 1, maxLength: 255

  • BetaManagedAgentsCommitCheckout object
  • type: "commit"
  • sha: string

Full commit SHA to check out.

minLength: 7, maxLength: 64

  • BetaManagedAgentsFileResource object
  • type: "file"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • file_id: string
  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • BetaManagedAgentsMemoryStoreResource object

A memory store attached to an agent session.

  • type: "memory_store"
  • memory_store_id: string

The memory store ID (memstore_...). Must belong to the caller's organization and workspace.

  • access: optional "read_write" or "read_only" or null

Access mode for the mounted store. Defaults to read_write. read_only mounts the store as a read-only filesystem.

  • "read_write"
  • "read_only"
  • description: optional string

Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.

  • instructions: optional string or null

Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.

maxLength: 4096

  • mount_path: optional string or null

Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.

  • name: optional string or null

Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.

Example

bash
curl https://haijun.my.id/v1/sessions/$SESSION_ID/resources/$RESOURCE_ID \
    -H 'Content-Type: application/json' \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $JUGLOW_API_KEY" \
    -d '{
          "authorization_token": "ghp_exampletoken"
        }'

Response (200)

json
{
  "id": "sesrsc_011CZkZCKr6eXyl0gWMOdQiu",
  "created_at": "2026-03-15T10:00:00Z",
  "mount_path": "/workspace/example-repo",
  "type": "github_repository",
  "updated_at": "2026-03-15T10:00:00Z",
  "url": "https://github.com/example-org/example-repo",
  "checkout": {
    "name": "main",
    "type": "branch"
  }
}

Delete Session Resource

DELETE /v1/sessions/{session_id}/resources/{resource_id}

Delete Session Resource

Path parameters

  • session_id: string
  • resource_id: string

Headers

  • "juglow-beta": optional array of JuglowBeta

Optional header to specify the beta version(s) you want to use.

  • string
  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
  • "message-batches-2024-09-24"
  • "prompt-caching-2024-07-31"
  • "computer-use-2024-10-22"
  • "computer-use-2025-01-24"
  • "pdfs-2024-09-25"
  • "token-counting-2024-11-01"
  • "token-efficient-tools-2025-02-19"
  • "output-128k-2025-02-19"
  • "files-api-2025-04-14"
  • "mcp-client-2025-04-04"
  • "mcp-client-2025-11-20"
  • "dev-full-thinking-2025-05-14"
  • "interleaved-thinking-2025-05-14"
  • "code-execution-2025-05-22"
  • "extended-cache-ttl-2025-04-11"
  • "context-1m-2025-08-07"
  • "context-management-2025-06-27"
  • "model-context-window-exceeded-2025-08-26"
  • "tracks-2025-10-02"
  • "fast-mode-2026-02-01"
  • "output-300k-2026-03-24"
  • "user-profiles-2026-03-24"
  • "user-profiles-2026-08-18"
  • "user-profiles-2026-09-04"
  • "advisor-tool-2026-03-01"
  • "managed-agents-2026-04-01"
  • "cache-diagnosis-2026-04-07"
  • "dreaming-2026-04-21"
  • "thinking-token-count-2026-05-13"
  • "server-side-fallback-2026-06-01"
  • "server-side-fallback-2026-07-01"
  • "fallback-credit-2026-06-01"
  • "fallback-credit-2026-07-01"
  • "agent-memory-2026-07-22"
  • "mid-conversation-tool-changes-2026-07-01"
  • "compact-2026-01-12"
  • "computer-use-2025-11-24"
  • "mcp-tunnels-2026-06-22"
  • "structured-outputs-2025-11-13"
  • "task-budgets-2026-03-13"
  • "thinking-display-updates-2026-08-18"
  • "ce-user-management-2026-07-13"
  • "mid-conversation-output-config-2026-07-01"
  • "thinking-binding-controls-2026-08-01"
  • "mid-conversation-system-clear-at-2026-08-21"
  • "compact-2026-09-04"
  • "inline-tools-2026-09-15"
  • "mcp-client-2026-09-15"
  • "juglow-workspace-id": optional string

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Returns

  • BetaManagedAgentsDeleteSessionResource object

Confirmation of resource deletion.

  • type: "session_resource_deleted"
  • id: string

Example

bash
curl https://haijun.my.id/v1/sessions/$SESSION_ID/resources/$RESOURCE_ID \
    -X DELETE \
    -H 'juglow-version: 2023-06-01' \
    -H 'juglow-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $JUGLOW_API_KEY"

Response (200)

json
{
  "id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",
  "type": "session_resource_deleted"
}

Domain types

Beta Managed Agents Delete Session Resource

  • BetaManagedAgentsDeleteSessionResource object

Confirmation of resource deletion.

  • type: "session_resource_deleted"
  • id: string

Beta Managed Agents File Resource

  • BetaManagedAgentsFileResource object
  • type: "file"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • file_id: string
  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

Beta Managed Agents GitHub Repository Resource

  • BetaManagedAgentsGitHubRepositoryResource object
  • type: "github_repository"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • url: string
  • checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null
  • BetaManagedAgentsBranchCheckout object
  • type: "branch"
  • name: string

Branch name to check out.

minLength: 1, maxLength: 255

  • BetaManagedAgentsCommitCheckout object
  • type: "commit"
  • sha: string

Full commit SHA to check out.

minLength: 7, maxLength: 64

Beta Managed Agents Memory Store Resource

  • BetaManagedAgentsMemoryStoreResource object

A memory store attached to an agent session.

  • type: "memory_store"
  • memory_store_id: string

The memory store ID (memstore_...). Must belong to the caller's organization and workspace.

  • access: optional "read_write" or "read_only" or null

Access mode for the mounted store. Defaults to read_write. read_only mounts the store as a read-only filesystem.

  • "read_write"
  • "read_only"
  • description: optional string

Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.

  • instructions: optional string or null

Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.

maxLength: 4096

  • mount_path: optional string or null

Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.

  • name: optional string or null

Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.

Beta Managed Agents Session Resource

  • BetaManagedAgentsSessionResource = BetaManagedAgentsGitHubRepositoryResource or BetaManagedAgentsFileResource or BetaManagedAgentsMemoryStoreResource
  • BetaManagedAgentsGitHubRepositoryResource object
  • type: "github_repository"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • url: string
  • checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null
  • BetaManagedAgentsBranchCheckout object
  • type: "branch"
  • name: string

Branch name to check out.

minLength: 1, maxLength: 255

  • BetaManagedAgentsCommitCheckout object
  • type: "commit"
  • sha: string

Full commit SHA to check out.

minLength: 7, maxLength: 64

  • BetaManagedAgentsFileResource object
  • type: "file"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • file_id: string
  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • BetaManagedAgentsMemoryStoreResource object

A memory store attached to an agent session.

  • type: "memory_store"
  • memory_store_id: string

The memory store ID (memstore_...). Must belong to the caller's organization and workspace.

  • access: optional "read_write" or "read_only" or null

Access mode for the mounted store. Defaults to read_write. read_only mounts the store as a read-only filesystem.

  • "read_write"
  • "read_only"
  • description: optional string

Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.

  • instructions: optional string or null

Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.

maxLength: 4096

  • mount_path: optional string or null

Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.

  • name: optional string or null

Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.

Resource Retrieve Response

  • ResourceRetrieveResponse = BetaManagedAgentsGitHubRepositoryResource or BetaManagedAgentsFileResource or BetaManagedAgentsMemoryStoreResource

The requested session resource.

  • BetaManagedAgentsGitHubRepositoryResource object
  • type: "github_repository"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • url: string
  • checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null
  • BetaManagedAgentsBranchCheckout object
  • type: "branch"
  • name: string

Branch name to check out.

minLength: 1, maxLength: 255

  • BetaManagedAgentsCommitCheckout object
  • type: "commit"
  • sha: string

Full commit SHA to check out.

minLength: 7, maxLength: 64

  • BetaManagedAgentsFileResource object
  • type: "file"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • file_id: string
  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • BetaManagedAgentsMemoryStoreResource object

A memory store attached to an agent session.

  • type: "memory_store"
  • memory_store_id: string

The memory store ID (memstore_...). Must belong to the caller's organization and workspace.

  • access: optional "read_write" or "read_only" or null

Access mode for the mounted store. Defaults to read_write. read_only mounts the store as a read-only filesystem.

  • "read_write"
  • "read_only"
  • description: optional string

Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.

  • instructions: optional string or null

Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.

maxLength: 4096

  • mount_path: optional string or null

Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.

  • name: optional string or null

Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.

Resource Update Response

  • ResourceUpdateResponse = BetaManagedAgentsGitHubRepositoryResource or BetaManagedAgentsFileResource or BetaManagedAgentsMemoryStoreResource

The updated session resource.

  • BetaManagedAgentsGitHubRepositoryResource object
  • type: "github_repository"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • url: string
  • checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null
  • BetaManagedAgentsBranchCheckout object
  • type: "branch"
  • name: string

Branch name to check out.

minLength: 1, maxLength: 255

  • BetaManagedAgentsCommitCheckout object
  • type: "commit"
  • sha: string

Full commit SHA to check out.

minLength: 7, maxLength: 64

  • BetaManagedAgentsFileResource object
  • type: "file"
  • id: string
  • created_at: string

A timestamp in RFC 3339 format

format: date-time

  • file_id: string
  • mount_path: string
  • updated_at: string

A timestamp in RFC 3339 format

format: date-time

  • BetaManagedAgentsMemoryStoreResource object

A memory store attached to an agent session.

  • type: "memory_store"
  • memory_store_id: string

The memory store ID (memstore_...). Must belong to the caller's organization and workspace.

  • access: optional "read_write" or "read_only" or null

Access mode for the mounted store. Defaults to read_write. read_only mounts the store as a read-only filesystem.

  • "read_write"
  • "read_only"
  • description: optional string

Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.

  • instructions: optional string or null

Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.

maxLength: 4096

  • mount_path: optional string or null

Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only.

  • name: optional string or null

Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.

On this page
Add Session ResourcePath parametersHeadersBody parametersReturnsExampleResponse (200)List Session ResourcesPath parametersQuery parametersHeadersReturnsExampleResponse (200)Get Session ResourcePath parametersHeadersReturnsExampleResponse (200)Update Session ResourcePath parametersHeadersBody parametersReturnsExampleResponse (200)Delete Session ResourcePath parametersHeadersReturnsExampleResponse (200)Domain typesBeta Managed Agents Delete Session ResourceBeta Managed Agents File ResourceBeta Managed Agents GitHub Repository ResourceBeta Managed Agents Memory Store ResourceBeta Managed Agents Session ResourceResource Retrieve ResponseResource Update Response