---
title: "POST /v1/{+parent}/sessions"
method: POST
path: "/v1/{+parent}/sessions"
tags: ["projects"]
---

# POST /v1/{+parent}/sessions

`POST /v1/{+parent}/sessions`

Creates a new Session.

## Path parameters

- `parent` string, required

## Query parameters

- `sessionId` string

## Request body

- GoogleCloudAiplatformV1Session — A session contains a set of actions between users and Vertex agents.
  - `updateTime` string, google-datetime — Output only. Timestamp when the session was updated.
  - `labels` object — The labels with user-defined metadata to organize your Sessions. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.
  - `expireTime` string, google-datetime — Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input. The minimum value is 24 hours from the time of creation.
  - `createTime` string, google-datetime — Output only. Timestamp when the session was created.
  - `displayName` string — Optional. The display name of the session.
  - `name` string — Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
  - `ttl` string, google-duration — Optional. Input only. The TTL for this session. The minimum value is 24 hours.
  - `userId` string — Required. Immutable. String id provided by the user
  - `sessionState` object — Optional. Session specific memory which stores key conversation points.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/aiplatform.md) · [All operations](https://skmtc.net/google/apis/aiplatform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/aiplatform/versions/b608d71b91f0/schema)