1
0
Fork 0
mirror of synced 2024-09-30 00:57:16 +13:00

Add operationIds to public API

This commit is contained in:
Andrew Kingston 2022-09-20 11:24:54 +01:00
parent 8a219fa0e6
commit 3e050e965f
8 changed files with 549 additions and 447 deletions

View file

@ -1792,6 +1792,7 @@
"paths": { "paths": {
"/applications": { "/applications": {
"post": { "post": {
"operationId": "createApplication",
"summary": "Create an application", "summary": "Create an application",
"tags": [ "tags": [
"applications" "applications"
@ -1832,6 +1833,7 @@
}, },
"/applications/{appId}": { "/applications/{appId}": {
"put": { "put": {
"operationId": "updateApplication",
"summary": "Update an application", "summary": "Update an application",
"tags": [ "tags": [
"applications" "applications"
@ -1870,6 +1872,7 @@
} }
}, },
"delete": { "delete": {
"operationId": "deleteApplication",
"summary": "Delete an application", "summary": "Delete an application",
"tags": [ "tags": [
"applications" "applications"
@ -1898,6 +1901,7 @@
} }
}, },
"get": { "get": {
"operationId": "getApplicationById",
"summary": "Retrieve an application", "summary": "Retrieve an application",
"tags": [ "tags": [
"applications" "applications"
@ -1928,6 +1932,7 @@
}, },
"/applications/search": { "/applications/search": {
"post": { "post": {
"operationId": "searchApplications",
"summary": "Search for applications", "summary": "Search for applications",
"description": "Based on application properties (currently only name) search for applications.", "description": "Based on application properties (currently only name) search for applications.",
"tags": [ "tags": [
@ -1964,6 +1969,7 @@
}, },
"/queries/{queryId}": { "/queries/{queryId}": {
"post": { "post": {
"operationId": "executeQuery",
"summary": "Execute a query", "summary": "Execute a query",
"description": "Queries which have been created within a Budibase app can be executed using this,", "description": "Queries which have been created within a Budibase app can be executed using this,",
"tags": [ "tags": [
@ -2011,6 +2017,7 @@
}, },
"/queries/search": { "/queries/search": {
"post": { "post": {
"operationId": "searchQueries",
"summary": "Search for queries", "summary": "Search for queries",
"description": "Based on query properties (currently only name) search for queries.", "description": "Based on query properties (currently only name) search for queries.",
"tags": [ "tags": [
@ -2052,6 +2059,7 @@
}, },
"/tables/{tableId}/rows": { "/tables/{tableId}/rows": {
"post": { "post": {
"operationId": "createRow",
"summary": "Create a row", "summary": "Create a row",
"description": "Creates a row within the specified table.", "description": "Creates a row within the specified table.",
"tags": [ "tags": [
@ -2101,6 +2109,7 @@
}, },
"/tables/{tableId}/rows/{rowId}": { "/tables/{tableId}/rows/{rowId}": {
"put": { "put": {
"operationId": "updateRow",
"summary": "Update a row", "summary": "Update a row",
"description": "Updates a row within the specified table.", "description": "Updates a row within the specified table.",
"tags": [ "tags": [
@ -2151,6 +2160,7 @@
} }
}, },
"delete": { "delete": {
"operationId": "deleteRow",
"summary": "Delete a row", "summary": "Delete a row",
"description": "Deletes a row within the specified table.", "description": "Deletes a row within the specified table.",
"tags": [ "tags": [
@ -2186,6 +2196,7 @@
} }
}, },
"get": { "get": {
"operationId": "getRowById",
"summary": "Retrieve a row", "summary": "Retrieve a row",
"description": "This gets a single row, it will be enriched with the full related rows, rather than the squashed \"primaryDisplay\" format returned by the search endpoint.", "description": "This gets a single row, it will be enriched with the full related rows, rather than the squashed \"primaryDisplay\" format returned by the search endpoint.",
"tags": [ "tags": [
@ -2223,6 +2234,7 @@
}, },
"/tables/{tableId}/rows/search": { "/tables/{tableId}/rows/search": {
"post": { "post": {
"operationId": "searchRows",
"summary": "Search for rows", "summary": "Search for rows",
"tags": [ "tags": [
"rows" "rows"
@ -2266,6 +2278,7 @@
}, },
"/tables": { "/tables": {
"post": { "post": {
"operationId": "createTable",
"summary": "Create a table", "summary": "Create a table",
"description": "Create a table, this could be internal or external.", "description": "Create a table, this could be internal or external.",
"tags": [ "tags": [
@ -2311,6 +2324,7 @@
}, },
"/tables/{tableId}": { "/tables/{tableId}": {
"put": { "put": {
"operationId": "updateTable",
"summary": "Update a table", "summary": "Update a table",
"description": "Update a table, this could be internal or external.", "description": "Update a table, this could be internal or external.",
"tags": [ "tags": [
@ -2357,6 +2371,7 @@
} }
}, },
"delete": { "delete": {
"operationId": "deleteTable",
"summary": "Delete a table", "summary": "Delete a table",
"description": "Delete a table, this could be internal or external.", "description": "Delete a table, this could be internal or external.",
"tags": [ "tags": [
@ -2389,6 +2404,7 @@
} }
}, },
"get": { "get": {
"operationId": "getTableById",
"summary": "Retrieve a table", "summary": "Retrieve a table",
"description": "Lookup a table, this could be internal or external.", "description": "Lookup a table, this could be internal or external.",
"tags": [ "tags": [
@ -2423,6 +2439,7 @@
}, },
"/tables/search": { "/tables/search": {
"post": { "post": {
"operationId": "searchTables",
"summary": "Search for tables", "summary": "Search for tables",
"description": "Based on table properties (currently only name) search for tables. This could be an internal or an external table.", "description": "Based on table properties (currently only name) search for tables. This could be an internal or an external table.",
"tags": [ "tags": [
@ -2464,6 +2481,7 @@
}, },
"/users": { "/users": {
"post": { "post": {
"operationId": "createUser",
"summary": "Create a user", "summary": "Create a user",
"tags": [ "tags": [
"users" "users"
@ -2499,6 +2517,7 @@
}, },
"/users/{userId}": { "/users/{userId}": {
"put": { "put": {
"operationId": "updateUser",
"summary": "Update a user", "summary": "Update a user",
"tags": [ "tags": [
"users" "users"
@ -2537,6 +2556,7 @@
} }
}, },
"delete": { "delete": {
"operationId": "deleteUser",
"summary": "Delete a user", "summary": "Delete a user",
"tags": [ "tags": [
"users" "users"
@ -2565,6 +2585,7 @@
} }
}, },
"get": { "get": {
"operationId": "getUserById",
"summary": "Retrieve a user", "summary": "Retrieve a user",
"tags": [ "tags": [
"users" "users"
@ -2595,6 +2616,7 @@
}, },
"/users/search": { "/users/search": {
"post": { "post": {
"operationId": "searchUsers",
"summary": "Search for users", "summary": "Search for users",
"description": "Based on user properties (currently only name) search for users.", "description": "Based on user properties (currently only name) search for users.",
"tags": [ "tags": [

View file

@ -1370,6 +1370,7 @@ security:
paths: paths:
/applications: /applications:
post: post:
operationId: createApplication
summary: Create an application summary: Create an application
tags: tags:
- applications - applications
@ -1393,6 +1394,7 @@ paths:
$ref: "#/components/examples/application" $ref: "#/components/examples/application"
"/applications/{appId}": "/applications/{appId}":
put: put:
operationId: updateApplication
summary: Update an application summary: Update an application
tags: tags:
- applications - applications
@ -1415,6 +1417,7 @@ paths:
application: application:
$ref: "#/components/examples/application" $ref: "#/components/examples/application"
delete: delete:
operationId: deleteApplication
summary: Delete an application summary: Delete an application
tags: tags:
- applications - applications
@ -1431,6 +1434,7 @@ paths:
application: application:
$ref: "#/components/examples/application" $ref: "#/components/examples/application"
get: get:
operationId: getApplicationById
summary: Retrieve an application summary: Retrieve an application
tags: tags:
- applications - applications
@ -1448,6 +1452,7 @@ paths:
$ref: "#/components/examples/application" $ref: "#/components/examples/application"
/applications/search: /applications/search:
post: post:
operationId: searchApplications
summary: Search for applications summary: Search for applications
description: Based on application properties (currently only name) search for description: Based on application properties (currently only name) search for
applications. applications.
@ -1472,6 +1477,7 @@ paths:
$ref: "#/components/examples/applications" $ref: "#/components/examples/applications"
"/queries/{queryId}": "/queries/{queryId}":
post: post:
operationId: executeQuery
summary: Execute a query summary: Execute a query
description: Queries which have been created within a Budibase app can be description: Queries which have been created within a Budibase app can be
executed using this, executed using this,
@ -1500,6 +1506,7 @@ paths:
$ref: "#/components/examples/sqlResponse" $ref: "#/components/examples/sqlResponse"
/queries/search: /queries/search:
post: post:
operationId: searchQueries
summary: Search for queries summary: Search for queries
description: Based on query properties (currently only name) search for queries. description: Based on query properties (currently only name) search for queries.
tags: tags:
@ -1524,6 +1531,7 @@ paths:
$ref: "#/components/examples/queries" $ref: "#/components/examples/queries"
"/tables/{tableId}/rows": "/tables/{tableId}/rows":
post: post:
operationId: createRow
summary: Create a row summary: Create a row
description: Creates a row within the specified table. description: Creates a row within the specified table.
tags: tags:
@ -1554,6 +1562,7 @@ paths:
$ref: "#/components/examples/row" $ref: "#/components/examples/row"
"/tables/{tableId}/rows/{rowId}": "/tables/{tableId}/rows/{rowId}":
put: put:
operationId: updateRow
summary: Update a row summary: Update a row
description: Updates a row within the specified table. description: Updates a row within the specified table.
tags: tags:
@ -1583,6 +1592,7 @@ paths:
row: row:
$ref: "#/components/examples/row" $ref: "#/components/examples/row"
delete: delete:
operationId: deleteRow
summary: Delete a row summary: Delete a row
description: Deletes a row within the specified table. description: Deletes a row within the specified table.
tags: tags:
@ -1603,6 +1613,7 @@ paths:
row: row:
$ref: "#/components/examples/row" $ref: "#/components/examples/row"
get: get:
operationId: getRowById
summary: Retrieve a row summary: Retrieve a row
description: This gets a single row, it will be enriched with the full related description: This gets a single row, it will be enriched with the full related
rows, rather than the squashed "primaryDisplay" format returned by the rows, rather than the squashed "primaryDisplay" format returned by the
@ -1625,6 +1636,7 @@ paths:
$ref: "#/components/examples/enrichedRow" $ref: "#/components/examples/enrichedRow"
"/tables/{tableId}/rows/search": "/tables/{tableId}/rows/search":
post: post:
operationId: searchRows
summary: Search for rows summary: Search for rows
tags: tags:
- rows - rows
@ -1650,6 +1662,7 @@ paths:
$ref: "#/components/examples/rows" $ref: "#/components/examples/rows"
/tables: /tables:
post: post:
operationId: createTable
summary: Create a table summary: Create a table
description: Create a table, this could be internal or external. description: Create a table, this could be internal or external.
tags: tags:
@ -1677,6 +1690,7 @@ paths:
$ref: "#/components/examples/table" $ref: "#/components/examples/table"
"/tables/{tableId}": "/tables/{tableId}":
put: put:
operationId: updateTable
summary: Update a table summary: Update a table
description: Update a table, this could be internal or external. description: Update a table, this could be internal or external.
tags: tags:
@ -1703,6 +1717,7 @@ paths:
table: table:
$ref: "#/components/examples/table" $ref: "#/components/examples/table"
delete: delete:
operationId: deleteTable
summary: Delete a table summary: Delete a table
description: Delete a table, this could be internal or external. description: Delete a table, this could be internal or external.
tags: tags:
@ -1721,6 +1736,7 @@ paths:
table: table:
$ref: "#/components/examples/table" $ref: "#/components/examples/table"
get: get:
operationId: getTableById
summary: Retrieve a table summary: Retrieve a table
description: Lookup a table, this could be internal or external. description: Lookup a table, this could be internal or external.
tags: tags:
@ -1740,6 +1756,7 @@ paths:
$ref: "#/components/examples/table" $ref: "#/components/examples/table"
/tables/search: /tables/search:
post: post:
operationId: searchTables
summary: Search for tables summary: Search for tables
description: Based on table properties (currently only name) search for tables. description: Based on table properties (currently only name) search for tables.
This could be an internal or an external table. This could be an internal or an external table.
@ -1765,6 +1782,7 @@ paths:
$ref: "#/components/examples/tables" $ref: "#/components/examples/tables"
/users: /users:
post: post:
operationId: createUser
summary: Create a user summary: Create a user
tags: tags:
- users - users
@ -1786,6 +1804,7 @@ paths:
$ref: "#/components/examples/user" $ref: "#/components/examples/user"
"/users/{userId}": "/users/{userId}":
put: put:
operationId: updateUser
summary: Update a user summary: Update a user
tags: tags:
- users - users
@ -1808,6 +1827,7 @@ paths:
user: user:
$ref: "#/components/examples/user" $ref: "#/components/examples/user"
delete: delete:
operationId: deleteUser
summary: Delete a user summary: Delete a user
tags: tags:
- users - users
@ -1824,6 +1844,7 @@ paths:
user: user:
$ref: "#/components/examples/user" $ref: "#/components/examples/user"
get: get:
operationId: getUserById
summary: Retrieve a user summary: Retrieve a user
tags: tags:
- users - users
@ -1841,6 +1862,7 @@ paths:
$ref: "#/components/examples/user" $ref: "#/components/examples/user"
/users/search: /users/search:
post: post:
operationId: searchUsers
summary: Search for users summary: Search for users
description: Based on user properties (currently only name) search for users. description: Based on user properties (currently only name) search for users.
tags: tags:

View file

@ -9,6 +9,7 @@ const read = [],
* @openapi * @openapi
* /applications: * /applications:
* post: * post:
* operationId: createApplication
* summary: Create an application * summary: Create an application
* tags: * tags:
* - applications * - applications
@ -41,6 +42,7 @@ write.push(
* @openapi * @openapi
* /applications/{appId}: * /applications/{appId}:
* put: * put:
* operationId: updateApplication
* summary: Update an application * summary: Update an application
* tags: * tags:
* - applications * - applications
@ -73,6 +75,7 @@ write.push(
* @openapi * @openapi
* /applications/{appId}: * /applications/{appId}:
* delete: * delete:
* operationId: deleteApplication
* summary: Delete an application * summary: Delete an application
* tags: * tags:
* - applications * - applications
@ -95,6 +98,7 @@ write.push(new Endpoint("delete", "/applications/:appId", controller.destroy))
* @openapi * @openapi
* /applications/{appId}: * /applications/{appId}:
* get: * get:
* operationId: getApplicationById
* summary: Retrieve an application * summary: Retrieve an application
* tags: * tags:
* - applications * - applications
@ -117,6 +121,7 @@ read.push(new Endpoint("get", "/applications/:appId", controller.read))
* @openapi * @openapi
* /applications/search: * /applications/search:
* post: * post:
* operationId: searchApplications
* summary: Search for applications * summary: Search for applications
* description: Based on application properties (currently only name) search for applications. * description: Based on application properties (currently only name) search for applications.
* tags: * tags:

View file

@ -9,6 +9,7 @@ const read = [],
* @openapi * @openapi
* /queries/{queryId}: * /queries/{queryId}:
* post: * post:
* operationId: executeQuery
* summary: Execute a query * summary: Execute a query
* description: Queries which have been created within a Budibase app can be executed using this, * description: Queries which have been created within a Budibase app can be executed using this,
* tags: * tags:
@ -42,6 +43,7 @@ write.push(new Endpoint("post", "/queries/:queryId", controller.execute))
* @openapi * @openapi
* /queries/search: * /queries/search:
* post: * post:
* operationId: searchQueries
* summary: Search for queries * summary: Search for queries
* description: Based on query properties (currently only name) search for queries. * description: Based on query properties (currently only name) search for queries.
* tags: * tags:

View file

@ -9,6 +9,7 @@ const read = [],
* @openapi * @openapi
* /tables/{tableId}/rows: * /tables/{tableId}/rows:
* post: * post:
* operationId: createRow
* summary: Create a row * summary: Create a row
* description: Creates a row within the specified table. * description: Creates a row within the specified table.
* tags: * tags:
@ -43,6 +44,7 @@ write.push(new Endpoint("post", "/tables/:tableId/rows", controller.create))
* @openapi * @openapi
* /tables/{tableId}/rows/{rowId}: * /tables/{tableId}/rows/{rowId}:
* put: * put:
* operationId: updateRow
* summary: Update a row * summary: Update a row
* description: Updates a row within the specified table. * description: Updates a row within the specified table.
* tags: * tags:
@ -79,6 +81,7 @@ write.push(
* @openapi * @openapi
* /tables/{tableId}/rows/{rowId}: * /tables/{tableId}/rows/{rowId}:
* delete: * delete:
* operationId: deleteRow
* summary: Delete a row * summary: Delete a row
* description: Deletes a row within the specified table. * description: Deletes a row within the specified table.
* tags: * tags:
@ -106,6 +109,7 @@ write.push(
* @openapi * @openapi
* /tables/{tableId}/rows/{rowId}: * /tables/{tableId}/rows/{rowId}:
* get: * get:
* operationId: getRowById
* summary: Retrieve a row * summary: Retrieve a row
* description: This gets a single row, it will be enriched with the full related rows, rather than * description: This gets a single row, it will be enriched with the full related rows, rather than
* the squashed "primaryDisplay" format returned by the search endpoint. * the squashed "primaryDisplay" format returned by the search endpoint.
@ -132,6 +136,7 @@ read.push(new Endpoint("get", "/tables/:tableId/rows/:rowId", controller.read))
* @openapi * @openapi
* /tables/{tableId}/rows/search: * /tables/{tableId}/rows/search:
* post: * post:
* operationId: searchRows
* summary: Search for rows * summary: Search for rows
* tags: * tags:
* - rows * - rows

View file

@ -9,6 +9,7 @@ const read = [],
* @openapi * @openapi
* /tables: * /tables:
* post: * post:
* operationId: createTable
* summary: Create a table * summary: Create a table
* description: Create a table, this could be internal or external. * description: Create a table, this could be internal or external.
* tags: * tags:
@ -45,6 +46,7 @@ write.push(
* @openapi * @openapi
* /tables/{tableId}: * /tables/{tableId}:
* put: * put:
* operationId: updateTable
* summary: Update a table * summary: Update a table
* description: Update a table, this could be internal or external. * description: Update a table, this could be internal or external.
* tags: * tags:
@ -81,6 +83,7 @@ write.push(
* @openapi * @openapi
* /tables/{tableId}: * /tables/{tableId}:
* delete: * delete:
* operationId: deleteTable
* summary: Delete a table * summary: Delete a table
* description: Delete a table, this could be internal or external. * description: Delete a table, this could be internal or external.
* tags: * tags:
@ -105,6 +108,7 @@ write.push(new Endpoint("delete", "/tables/:tableId", controller.destroy))
* @openapi * @openapi
* /tables/{tableId}: * /tables/{tableId}:
* get: * get:
* operationId: getTableById
* summary: Retrieve a table * summary: Retrieve a table
* description: Lookup a table, this could be internal or external. * description: Lookup a table, this could be internal or external.
* tags: * tags:
@ -129,6 +133,7 @@ read.push(new Endpoint("get", "/tables/:tableId", controller.read))
* @openapi * @openapi
* /tables/search: * /tables/search:
* post: * post:
* operationId: searchTables
* summary: Search for tables * summary: Search for tables
* description: Based on table properties (currently only name) search for tables. This could be * description: Based on table properties (currently only name) search for tables. This could be
* an internal or an external table. * an internal or an external table.

View file

@ -9,6 +9,7 @@ const read = [],
* @openapi * @openapi
* /users: * /users:
* post: * post:
* operationId: createUser
* summary: Create a user * summary: Create a user
* tags: * tags:
* - users * - users
@ -35,6 +36,7 @@ write.push(new Endpoint("post", "/users", controller.create))
* @openapi * @openapi
* /users/{userId}: * /users/{userId}:
* put: * put:
* operationId: updateUser
* summary: Update a user * summary: Update a user
* tags: * tags:
* - users * - users
@ -63,6 +65,7 @@ write.push(new Endpoint("put", "/users/:userId", controller.update))
* @openapi * @openapi
* /users/{userId}: * /users/{userId}:
* delete: * delete:
* operationId: deleteUser
* summary: Delete a user * summary: Delete a user
* tags: * tags:
* - users * - users
@ -85,6 +88,7 @@ write.push(new Endpoint("delete", "/users/:userId", controller.destroy))
* @openapi * @openapi
* /users/{userId}: * /users/{userId}:
* get: * get:
* operationId: getUserById
* summary: Retrieve a user * summary: Retrieve a user
* tags: * tags:
* - users * - users
@ -107,6 +111,7 @@ read.push(new Endpoint("get", "/users/:userId", controller.read))
* @openapi * @openapi
* /users/search: * /users/search:
* post: * post:
* operationId: searchUsers
* summary: Search for users * summary: Search for users
* description: Based on user properties (currently only name) search for users. * description: Based on user properties (currently only name) search for users.
* tags: * tags:

View file

@ -5,491 +5,67 @@
export interface paths { export interface paths {
"/applications": { "/applications": {
post: { post: operations["createApplication"];
parameters: {
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the created application. */
200: {
content: {
"application/json": components["schemas"]["applicationOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["application"];
};
};
};
}; };
"/applications/{appId}": { "/applications/{appId}": {
get: { get: operations["getApplicationById"];
parameters: { put: operations["updateApplication"];
path: { delete: operations["deleteApplication"];
/** The ID of the app which this request is targeting. */
appId: components["parameters"]["appIdUrl"];
};
};
responses: {
/** Returns the retrieved application. */
200: {
content: {
"application/json": components["schemas"]["applicationOutput"];
};
};
};
};
put: {
parameters: {
path: {
/** The ID of the app which this request is targeting. */
appId: components["parameters"]["appIdUrl"];
};
};
responses: {
/** Returns the updated application. */
200: {
content: {
"application/json": components["schemas"]["applicationOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["application"];
};
};
};
delete: {
parameters: {
path: {
/** The ID of the app which this request is targeting. */
appId: components["parameters"]["appIdUrl"];
};
};
responses: {
/** Returns the deleted application. */
200: {
content: {
"application/json": components["schemas"]["applicationOutput"];
};
};
};
};
}; };
"/applications/search": { "/applications/search": {
/** Based on application properties (currently only name) search for applications. */ /** Based on application properties (currently only name) search for applications. */
post: { post: operations["searchApplications"];
responses: {
/** Returns the applications that were found based on the search parameters. */
200: {
content: {
"application/json": components["schemas"]["applicationSearch"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["nameSearch"];
};
};
};
}; };
"/queries/{queryId}": { "/queries/{queryId}": {
/** Queries which have been created within a Budibase app can be executed using this, */ /** Queries which have been created within a Budibase app can be executed using this, */
post: { post: operations["executeQuery"];
parameters: {
path: {
/** The ID of the query which this request is targeting. */
queryId: components["parameters"]["queryId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the result of the query execution. */
200: {
content: {
"application/json": components["schemas"]["executeQueryOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["executeQuery"];
};
};
};
}; };
"/queries/search": { "/queries/search": {
/** Based on query properties (currently only name) search for queries. */ /** Based on query properties (currently only name) search for queries. */
post: { post: operations["searchQueries"];
parameters: {
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the queries found based on the search parameters. */
200: {
content: {
"application/json": components["schemas"]["querySearch"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["nameSearch"];
};
};
};
}; };
"/tables/{tableId}/rows": { "/tables/{tableId}/rows": {
/** Creates a row within the specified table. */ /** Creates a row within the specified table. */
post: { post: operations["createRow"];
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the created row, including the ID which has been generated for it. This can be found in the Budibase portal, viewed under the developer information. */
200: {
content: {
"application/json": components["schemas"]["rowOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["row"];
};
};
};
}; };
"/tables/{tableId}/rows/{rowId}": { "/tables/{tableId}/rows/{rowId}": {
/** This gets a single row, it will be enriched with the full related rows, rather than the squashed "primaryDisplay" format returned by the search endpoint. */ /** This gets a single row, it will be enriched with the full related rows, rather than the squashed "primaryDisplay" format returned by the search endpoint. */
get: { get: operations["getRowById"];
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
/** The ID of the row which this request is targeting. */
rowId: components["parameters"]["rowId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the retrieved row. */
200: {
content: {
"application/json": components["schemas"]["rowOutput"];
};
};
};
};
/** Updates a row within the specified table. */ /** Updates a row within the specified table. */
put: { put: operations["updateRow"];
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
/** The ID of the row which this request is targeting. */
rowId: components["parameters"]["rowId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the created row, including the ID which has been generated for it. */
200: {
content: {
"application/json": components["schemas"]["rowOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["row"];
};
};
};
/** Deletes a row within the specified table. */ /** Deletes a row within the specified table. */
delete: { delete: operations["deleteRow"];
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
/** The ID of the row which this request is targeting. */
rowId: components["parameters"]["rowId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the deleted row, including the ID which has been generated for it. */
200: {
content: {
"application/json": components["schemas"]["rowOutput"];
};
};
};
};
}; };
"/tables/{tableId}/rows/search": { "/tables/{tableId}/rows/search": {
post: { post: operations["searchRows"];
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** The response will contain an array of rows that match the search parameters. */
200: {
content: {
"application/json": components["schemas"]["searchOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["rowSearch"];
};
};
};
}; };
"/tables": { "/tables": {
/** Create a table, this could be internal or external. */ /** Create a table, this could be internal or external. */
post: { post: operations["createTable"];
parameters: {
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the created table, including the ID which has been generated for it. This can be internal or external datasources. */
200: {
content: {
"application/json": components["schemas"]["tableOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["table"];
};
};
};
}; };
"/tables/{tableId}": { "/tables/{tableId}": {
/** Lookup a table, this could be internal or external. */ /** Lookup a table, this could be internal or external. */
get: { get: operations["getTableById"];
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the retrieved table. */
200: {
content: {
"application/json": components["schemas"]["tableOutput"];
};
};
};
};
/** Update a table, this could be internal or external. */ /** Update a table, this could be internal or external. */
put: { put: operations["updateTable"];
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the updated table. */
200: {
content: {
"application/json": components["schemas"]["tableOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["table"];
};
};
};
/** Delete a table, this could be internal or external. */ /** Delete a table, this could be internal or external. */
delete: { delete: operations["deleteTable"];
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the deleted table. */
200: {
content: {
"application/json": components["schemas"]["tableOutput"];
};
};
};
};
}; };
"/tables/search": { "/tables/search": {
/** Based on table properties (currently only name) search for tables. This could be an internal or an external table. */ /** Based on table properties (currently only name) search for tables. This could be an internal or an external table. */
post: { post: operations["searchTables"];
parameters: {
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the found tables, based on the search parameters. */
200: {
content: {
"application/json": components["schemas"]["tableSearch"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["nameSearch"];
};
};
};
}; };
"/users": { "/users": {
post: { post: operations["createUser"];
responses: {
/** Returns the created user. */
200: {
content: {
"application/json": components["schemas"]["userOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["user"];
};
};
};
}; };
"/users/{userId}": { "/users/{userId}": {
get: { get: operations["getUserById"];
parameters: { put: operations["updateUser"];
path: { delete: operations["deleteUser"];
/** The ID of the user which this request is targeting. */
userId: components["parameters"]["userId"];
};
};
responses: {
/** Returns the retrieved user. */
200: {
content: {
"application/json": components["schemas"]["userOutput"];
};
};
};
};
put: {
parameters: {
path: {
/** The ID of the user which this request is targeting. */
userId: components["parameters"]["userId"];
};
};
responses: {
/** Returns the updated user. */
200: {
content: {
"application/json": components["schemas"]["userOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["user"];
};
};
};
delete: {
parameters: {
path: {
/** The ID of the user which this request is targeting. */
userId: components["parameters"]["userId"];
};
};
responses: {
/** Returns the deleted user. */
200: {
content: {
"application/json": components["schemas"]["userOutput"];
};
};
};
};
}; };
"/users/search": { "/users/search": {
/** Based on user properties (currently only name) search for users. */ /** Based on user properties (currently only name) search for users. */
post: { post: operations["searchUsers"];
responses: {
/** Returns the found users based on search parameters. */
200: {
content: {
"application/json": components["schemas"]["userSearch"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["nameSearch"];
};
};
};
}; };
} }
@ -1127,6 +703,466 @@ export interface components {
}; };
} }
export interface operations {} export interface operations {
createApplication: {
parameters: {
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the created application. */
200: {
content: {
"application/json": components["schemas"]["applicationOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["application"];
};
};
};
getApplicationById: {
parameters: {
path: {
/** The ID of the app which this request is targeting. */
appId: components["parameters"]["appIdUrl"];
};
};
responses: {
/** Returns the retrieved application. */
200: {
content: {
"application/json": components["schemas"]["applicationOutput"];
};
};
};
};
updateApplication: {
parameters: {
path: {
/** The ID of the app which this request is targeting. */
appId: components["parameters"]["appIdUrl"];
};
};
responses: {
/** Returns the updated application. */
200: {
content: {
"application/json": components["schemas"]["applicationOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["application"];
};
};
};
deleteApplication: {
parameters: {
path: {
/** The ID of the app which this request is targeting. */
appId: components["parameters"]["appIdUrl"];
};
};
responses: {
/** Returns the deleted application. */
200: {
content: {
"application/json": components["schemas"]["applicationOutput"];
};
};
};
};
/** Based on application properties (currently only name) search for applications. */
searchApplications: {
responses: {
/** Returns the applications that were found based on the search parameters. */
200: {
content: {
"application/json": components["schemas"]["applicationSearch"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["nameSearch"];
};
};
};
/** Queries which have been created within a Budibase app can be executed using this, */
executeQuery: {
parameters: {
path: {
/** The ID of the query which this request is targeting. */
queryId: components["parameters"]["queryId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the result of the query execution. */
200: {
content: {
"application/json": components["schemas"]["executeQueryOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["executeQuery"];
};
};
};
/** Based on query properties (currently only name) search for queries. */
searchQueries: {
parameters: {
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the queries found based on the search parameters. */
200: {
content: {
"application/json": components["schemas"]["querySearch"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["nameSearch"];
};
};
};
/** Creates a row within the specified table. */
createRow: {
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the created row, including the ID which has been generated for it. This can be found in the Budibase portal, viewed under the developer information. */
200: {
content: {
"application/json": components["schemas"]["rowOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["row"];
};
};
};
/** This gets a single row, it will be enriched with the full related rows, rather than the squashed "primaryDisplay" format returned by the search endpoint. */
getRowById: {
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
/** The ID of the row which this request is targeting. */
rowId: components["parameters"]["rowId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the retrieved row. */
200: {
content: {
"application/json": components["schemas"]["rowOutput"];
};
};
};
};
/** Updates a row within the specified table. */
updateRow: {
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
/** The ID of the row which this request is targeting. */
rowId: components["parameters"]["rowId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the created row, including the ID which has been generated for it. */
200: {
content: {
"application/json": components["schemas"]["rowOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["row"];
};
};
};
/** Deletes a row within the specified table. */
deleteRow: {
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
/** The ID of the row which this request is targeting. */
rowId: components["parameters"]["rowId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the deleted row, including the ID which has been generated for it. */
200: {
content: {
"application/json": components["schemas"]["rowOutput"];
};
};
};
};
searchRows: {
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** The response will contain an array of rows that match the search parameters. */
200: {
content: {
"application/json": components["schemas"]["searchOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["rowSearch"];
};
};
};
/** Create a table, this could be internal or external. */
createTable: {
parameters: {
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the created table, including the ID which has been generated for it. This can be internal or external datasources. */
200: {
content: {
"application/json": components["schemas"]["tableOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["table"];
};
};
};
/** Lookup a table, this could be internal or external. */
getTableById: {
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the retrieved table. */
200: {
content: {
"application/json": components["schemas"]["tableOutput"];
};
};
};
};
/** Update a table, this could be internal or external. */
updateTable: {
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the updated table. */
200: {
content: {
"application/json": components["schemas"]["tableOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["table"];
};
};
};
/** Delete a table, this could be internal or external. */
deleteTable: {
parameters: {
path: {
/** The ID of the table which this request is targeting. */
tableId: components["parameters"]["tableId"];
};
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the deleted table. */
200: {
content: {
"application/json": components["schemas"]["tableOutput"];
};
};
};
};
/** Based on table properties (currently only name) search for tables. This could be an internal or an external table. */
searchTables: {
parameters: {
header: {
/** The ID of the app which this request is targeting. */
"x-budibase-app-id": components["parameters"]["appId"];
};
};
responses: {
/** Returns the found tables, based on the search parameters. */
200: {
content: {
"application/json": components["schemas"]["tableSearch"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["nameSearch"];
};
};
};
createUser: {
responses: {
/** Returns the created user. */
200: {
content: {
"application/json": components["schemas"]["userOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["user"];
};
};
};
getUserById: {
parameters: {
path: {
/** The ID of the user which this request is targeting. */
userId: components["parameters"]["userId"];
};
};
responses: {
/** Returns the retrieved user. */
200: {
content: {
"application/json": components["schemas"]["userOutput"];
};
};
};
};
updateUser: {
parameters: {
path: {
/** The ID of the user which this request is targeting. */
userId: components["parameters"]["userId"];
};
};
responses: {
/** Returns the updated user. */
200: {
content: {
"application/json": components["schemas"]["userOutput"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["user"];
};
};
};
deleteUser: {
parameters: {
path: {
/** The ID of the user which this request is targeting. */
userId: components["parameters"]["userId"];
};
};
responses: {
/** Returns the deleted user. */
200: {
content: {
"application/json": components["schemas"]["userOutput"];
};
};
};
};
/** Based on user properties (currently only name) search for users. */
searchUsers: {
responses: {
/** Returns the found users based on search parameters. */
200: {
content: {
"application/json": components["schemas"]["userSearch"];
};
};
};
requestBody: {
content: {
"application/json": components["schemas"]["nameSearch"];
};
};
};
}
export interface external {} export interface external {}