---
title: "Create a new terminal"
method: POST
path: "/api/terminals"
tags: ["terminals"]
---

# Create a new terminal

`POST /api/terminals`

## Response `200`

Successfully created a new terminal

- Terminal — A Terminal object
  - `name` string, required — name of terminal
  - `last_activity` string — ISO 8601 timestamp for the last-seen activity on this terminal. Use this to identify which terminals have been inactive since a given time. Timestamps will be UTC, indicated 'Z' suffix.

## Other responses

- `403` — Forbidden to access
- `404` — Not found

## Changes

> 2 revisions in range; 1 could not be searched.

- **2025-12-10** `e9ae9d653401` — 1 breaking
  - removed the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/google/apis/jupyter-server-api/changes/api/terminals/post.md)

---

[API](https://skmtc.dev/google/apis/jupyter-server-api.md) · [All operations](https://skmtc.dev/google/apis/jupyter-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/jupyter-server-api/revisions/b6f1ce06c896/schema)