Skip to content

Data API (earlier URL form) endpoints

11 endpoints at https://api.vaif.studio, generated from the API's OpenAPI document. The REST API page covers authentication, and All endpoints lists every group.

GET /generated/{table}

Dynamic table columns are preserved. List pagination uses offset; cursor is not implemented. API key and optional end-user Bearer token may be sent together to apply owner rules.

Authentication: a project API key or a bearer token (API keys).

ParameterInTypeRequired
tablepathstringYes
wherequerystringNo
filterquery{ [key: string]: string; }No
whereFieldquerystringNo
whereValuequerystringNo
limitquerynumberNo
offsetquerynumberNo
selectquerystringNo
orderByquerystringNo
orderDirquerystringNo
order_byquerystringNo
order_dirquerystringNo
includequerystringNo
filter[or]query{ [key: string]: string; }No
Response 200 (application/json)
{
  data: { [key: string]: any }[];
  count: number;
}

Errors: 400, 401, 403, 429, 500, with the error body.

POST /generated/{table}

Dynamic table columns are preserved. List pagination uses offset; cursor is not implemented. API key and optional end-user Bearer token may be sent together to apply owner rules.

Authentication: a project API key or a bearer token (API keys).

ParameterInTypeRequired
tablepathstringYes
Request body (application/json, required)
{ [key: string]: any }
Response 200 (application/json)
{
  data: { [key: string]: any };
} | {
  data: { [key: string]: any };
  action: string;
}

Errors: 400, 401, 403, 429, 500, with the error body.

Dynamic table columns are preserved. List pagination uses offset; cursor is not implemented. API key and optional end-user Bearer token may be sent together to apply owner rules.

Authentication: a project API key or a bearer token (API keys).

ParameterInTypeRequired
tablepathstringYes
qquerystringYes
fieldsquerystringNo
limitquerynumberNo
offsetquerynumberNo
Response 200 (application/json)
{
  data: { [key: string]: any }[];
  count: number;
}

Errors: 400, 401, 403, 429, 500, with the error body.

GET /generated/{table}/aggregate

Dynamic table columns are preserved. List pagination uses offset; cursor is not implemented. API key and optional end-user Bearer token may be sent together to apply owner rules.

Authentication: a project API key or a bearer token (API keys).

ParameterInTypeRequired
tablepathstringYes
fnquery"count" | "sum" | "avg" | "min" | "max"Yes
columnquerystringNo
group_byquerystringNo
wherequerystringNo
filterquery{ [key: string]: string; }No
whereFieldquerystringNo
whereValuequerystringNo
Response 200 (application/json)
{
  data: { [key: string]: any }[];
}

Errors: 400, 401, 403, 429, 500, with the error body.

POST /generated/{table}/query

Dynamic table columns are preserved. List pagination uses offset; cursor is not implemented. API key and optional end-user Bearer token may be sent together to apply owner rules.

Authentication: a project API key or a bearer token (API keys).

ParameterInTypeRequired
tablepathstringYes
Request body (application/json, required)
{
  filter?: {
    and?: {
      field: string;
      op: string;
      value: any;
    }[];
    or?: {
      field: string;
      op: string;
      value: any;
    }[];
  };
  select?: string[];
  orderBy?: {
    column: string;
    direction?: string;
  }[];
  limit?: number;
  offset?: number;
}
Response 200 (application/json)
{
  data: { [key: string]: any }[];
  count: number;
}

Errors: 400, 401, 403, 429, 500, with the error body.

GET /generated/{table}/{id}

Dynamic table columns are preserved. List pagination uses offset; cursor is not implemented. API key and optional end-user Bearer token may be sent together to apply owner rules.

Authentication: a project API key or a bearer token (API keys).

ParameterInTypeRequired
tablepathstringYes
idpathstringYes
Response 200 (application/json)
{
  data: { [key: string]: any };
}

Errors: 400, 401, 403, 429, 500, with the error body.

PATCH /generated/{table}/{id}

Dynamic table columns are preserved. List pagination uses offset; cursor is not implemented. API key and optional end-user Bearer token may be sent together to apply owner rules.

Authentication: a project API key or a bearer token (API keys).

ParameterInTypeRequired
tablepathstringYes
idpathstringYes
Request body (application/json, required)
{ [key: string]: any }
Response 200 (application/json)
{
  data: { [key: string]: any };
}

Errors: 400, 401, 403, 429, 500, with the error body.

DELETE /generated/{table}/{id}

Dynamic table columns are preserved. List pagination uses offset; cursor is not implemented. API key and optional end-user Bearer token may be sent together to apply owner rules.

Authentication: a project API key or a bearer token (API keys).

ParameterInTypeRequired
tablepathstringYes
idpathstringYes
Response 200 (application/json)
{
  data: {
    id: string;
  };
  deleted: boolean;
}

Errors: 400, 401, 403, 429, 500, with the error body.

POST /generated/{table}/bulk

Dynamic table columns are preserved. List pagination uses offset; cursor is not implemented. API key and optional end-user Bearer token may be sent together to apply owner rules.

Authentication: a project API key or a bearer token (API keys).

ParameterInTypeRequired
tablepathstringYes
Request body (application/json, required)
{ [key: string]: any }[]
Response 200 (application/json)
{
  data: { [key: string]: any }[];
  count: number;
}

Errors: 400, 401, 403, 429, 500, with the error body.

PATCH /generated/{table}/bulk

Dynamic table columns are preserved. List pagination uses offset; cursor is not implemented. API key and optional end-user Bearer token may be sent together to apply owner rules.

Authentication: a project API key or a bearer token (API keys).

ParameterInTypeRequired
tablepathstringYes
Request body (application/json, required)
{
  data: { [key: string]: any };
  filter?: { [key: string]: any };
}
Response 200 (application/json)
{
  data: { [key: string]: any }[];
  count: number;
}

Errors: 400, 401, 403, 429, 500, with the error body.

DELETE /generated/{table}/bulk

Dynamic table columns are preserved. List pagination uses offset; cursor is not implemented. API key and optional end-user Bearer token may be sent together to apply owner rules.

Authentication: a project API key or a bearer token (API keys).

ParameterInTypeRequired
tablepathstringYes
wherequerystringNo
filterquery{ [key: string]: string; }No
whereFieldquerystringNo
whereValuequerystringNo
idsquerystringNo
Response 200 (application/json)
{
  data: { [key: string]: any }[];
  count: number;
} | {
  deleted: number;
  ids: any[];
}

Errors: 400, 401, 403, 429, 500, with the error body.