---
title: "Create a live query token"
method: POST
path: "/v1/org/{orgId}/query"
tags: ["query"]
---

# Create a live query token

`POST /v1/org/{orgId}/query`

## Path parameters

- `orgId` string, required

## Request body

- CreateQueryToken
  - `type` string, required — query type
  - `params` object, required — query params

## Response `200`

successful operation

- QueryToken
  - `id` string, required — globally unique id for query token
  - `token` string, required — globally unique random token string
  - `orgId` string, required — id of org
  - `userId` string, required — id of user
  - `label` string — query details on data that is being synced
  - `type` string, required — query type
  - `path` string — query path (deprecated)
  - `params` object, required — query params
  - `accessCount` integer — total number of uses
  - `createAt` string — created timestamp
  - `expireAt` string — expire timestamp
  - `activeAt` string — last active timestamp

## Other responses

- `400` — bad request
- `401` — not authorized
- `404` — not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/2de21f45f447/schema)