# Mobile ยท Sessions Session endpoints shaped for the mobile app: list and create, send a message, stream updates, answer permissions and questions, read diffs and todos, and teleport a session between hosts. Playground Send these requests to your own running server. Values stay in this browser. Not connected Base URL Directory _optional_ Bearer token _optional_ How this works Start a server with `nikcli serve --hostname 127.0.0.1 --port 4096`. Requests go straight from this page to that address โ€” the browser allows it because loopback counts as a secure origin, and the server allows it because `nikcli-ai.dev` is in its CORS allowlist. To try things without touching your real sessions or config, start the server with `NIKCLI_TEST_HOME` pointed at a throwaway directory โ€” see [the guided tour](/docs/guides/api-tour). ## Operations 21 endpoints, generated from the server's own [OpenAPI document](/docs/api). Every path also accepts the `directory` and `workspace` query parameters that select which instance handles the request.
get/mobile/sessionmobile.session.list
post/mobile/sessionmobile.session.create
get/mobile/session/{sessionID}mobile.session.detail
delete/mobile/session/{sessionID}mobile.session.delete
get/mobile/session/{sessionID}/diff/{messageID}mobile.session.diff
get/mobile/session/{sessionID}/commandmobile.session.command.list
post/mobile/session/{sessionID}/commandmobile.session.command
post/mobile/session/{sessionID}/messagemobile.session.message
post/mobile/session/{sessionID}/abortmobile.session.abort
post/mobile/session/{sessionID}/permissions/{permissionID}mobile.permission.respond
post/mobile/session/{sessionID}/question/{requestID}mobile.question.respond
delete/mobile/session/{sessionID}/question/{requestID}mobile.question.reject
post/mobile/session/{sessionID}/publishmobile.github.session.publish
post/mobile/session/{sessionID}/cleanupmobile.github.session.cleanup
get/mobile/session/{sessionID}/streammobile.session.stream
post/mobile/session/{sessionID}/renamemobile.session.rename
get/mobile/session/{sessionID}/todomobile.session.todo
post/mobile/teleport/uploadmobile.session.teleport.upload.begin
post/mobile/teleport/upload/{uploadID}mobile.session.teleport.upload.chunk
post/mobile/teleportmobile.session.teleport
post/mobile/session/{sessionID}/teleportmobile.session.teleport.out
### Session get /mobile/session [#](#op-get-mobile-session) `mobile.session.list` Parameters | Name | In | Type | Required | | --- | --- | --- | --- | | limit | query | string | null | optional | | search | query | string | null | optional | | directory | query | string | optional | | workspace | query | string | optional | Responses 200 Success application/json ({ info: [Session\_1](#schema-Session_1) status?: [SessionStatus](#schema-SessionStatus) | null })\[\] Example response from schema \[ { "info": { "id": "", "slug": "", "projectID": "", "directory": "", "parentID": "", "workspaceID": "", "summary": { "additions": null, "deletions": null, "files": null, "diffs": null }, "share": { "url": null }, "github": { "owner": null, "repo": null, "fullName": null, "baseBranch": null, "headBranch": null, "repositoryDirectory": null, "cloneUrl": null, "htmlUrl": null, "private": null, "worktree": null, "pullRequest": null, "lastCommitSha": null, "publishedAt": null, "publishError": null }, "worktree": { "name": null, "branch": null, "directory": null, "repositoryDirectory": null, "cleanedAt": null }, "mobile": { "platforms": null, "primaryPlatform": null, "method": null, "detectedAt": null, "buildStatus": null, "lastBuildAt": null, "artifacts": null }, "title": "", "activeCommand": "", "version": "", "time": { "created": null, "updated": null, "compacting": null, "archived": null }, "permission": \[\], "skills": \[\], "disabledInstructions": \[\], "disabledTools": {}, "revert": { "messageID": null, "partID": null, "snapshot": null, "diff": null }, "lastModel": { "providerID": null, "modelID": null } }, "status": { "type": "idle" } } \] Generated from the response schema โ€” field values are placeholders, the shape is real. SDK example mobile.session.list ts 1 2 3 4 5 6 ``` import { createNikcliClient } from "@nikcli-ai/sdk/httpapi" const client = createNikcliClient() await client.mobile.session.list({ ... }) ``` Try it limit _query_ search _query_ directory _query_ workspace _query_ --- Source: https://nikcli-ai.dev/docs/api/mobile-session