---
title: "POST /api/{org_id}/playground/run"
method: POST
path: "/api/{org_id}/playground/run"
tags: ["Playground"]
---

# POST /api/{org_id}/playground/run

`POST /api/{org_id}/playground/run`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/playground/run`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/playground/run/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org_id` string, required

## Request body

- object
  - `column` PlaygroundColumnBody, required
    - `messages` PlaygroundMessageBody[], required
      - `content` unknown
      - `reasoningContent` string, nullable
      - `role` string, required
      - `toolCallId` string, nullable
      - `toolCalls` PlaygroundToolCallBody[]
        - `arguments` string, required
        - `id` string, required
        - `name` string, required
    - `model` string, nullable
    - `params` object: Sampling parameters, passed to the provider verbatim. `temperature` and `max_tokens` are read out for the provider's own fields; the rest ride through untouched, which is how a caller reaches provider-specific options without a schema change here.
    - `providerId` string, required
    - `responseFormat` unknown
    - `tools` unknown
  - `row` PlaygroundRowBody
    - `expectedOutput` unknown
    - `input` unknown
    - `metadata` unknown

## Response `200`

Server-Sent Events carrying the model's answer

## Other responses

- `400`: Column or row is not runnable
- `403`: Provider is not visible to the caller
- `404`: Provider not found
- `429`: The provider rate limited the request
- `500`: The request could not be started
- `502`: The provider failed before streaming
- `504`: The provider timed out before streaming

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)