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

# POST /v1/{+parent}/debugsessions

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

Creates a debug session for a deployed API Proxy revision.

## Path parameters

- `parent` string, required

## Query parameters

- `timeout` string

## Request body

- GoogleCloudApigeeV1DebugSession
  - `name` string — A unique ID for this DebugSession.
  - `validity` integer — Optional. The length of time, in seconds, that this debug session is valid, starting from when it's received in the control plane. Min = 1, Max = 15, Default = 10.
  - `timeout` string, int64 — Optional. The time in seconds after which this DebugSession should end. This value will override the value in query param, if both are provided.
  - `createTime` string, google-datetime — Output only. The first transaction creation timestamp, recorded by UAP.
  - `count` integer — Optional. The number of request to be traced. Min = 1, Max = 15, Default = 10.
  - `filter` string — Optional. A conditional statement which is evaluated against the request message to determine if it should be traced. Syntax matches that of on API Proxy bundle flow Condition.
  - `tracesize` integer — Optional. The maximum number of bytes captured from the response payload. Min = 0, Max = 5120, Default = 5120.

## Response `200`

Successful response

---

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