# Add a playground

{generate_api_description(/realm/playgrounds:post)}

## Usage examples

{start_tabs}
{tab|python}

{generate_code_example(python)|/realm/playgrounds:post|example}

{tab|curl}

{generate_code_example(curl)|/realm/playgrounds:post|example}

{end_tabs}

## Parameters

{generate_api_arguments_table|zulip.yaml|/realm/playgrounds:post}

## Response

#### Return values

{generate_return_values_table|zulip.yaml|/realm/playgrounds:post}

#### Example response

A typical successful JSON response may look like:

{generate_code_example|/realm/playgrounds:post|fixture(200)}