Action

/api/action/ endpoints.

DELETE /api/action/:action-id

Delete an Action.

PARAMS:

• action-id value must be an integer greater than zero.

DELETE /api/action/:id/public_link

Delete the publicly-accessible link to this Dashboard.

PARAMS:

• id value must be an integer greater than zero.

GET /api/action/

Returns actions that can be used for QueryActions. By default lists all viewable actions. Pass optional ?model-id=<model-id> to limit to actions on a particular model.

PARAMS:

• model-id nullable value must be an integer greater than zero.

GET /api/action/:action-id

Fetch an Action.

PARAMS:

• action-id value must be an integer greater than zero.

GET /api/action/:action-id/execute

Fetches the values for filling in execution parameters. Pass PK parameters and values to select.

PARAMS:

• action-id value must be an integer greater than zero.

• parameters value must be a valid JSON string.

GET /api/action/public

Fetch a list of Actions with public UUIDs. These actions are publicly-accessible if public sharing is enabled.

POST /api/action/

Create a new action.

PARAMS:

• visualization_settings nullable map.

• parameters nullable sequence of map.

• description nullable string.

• error_handle nullable string, and must be a valid json-query, something like ‘.item.title’.

• database_id nullable value must be an integer greater than zero.

• name string.

• response_handle nullable string, and must be a valid json-query, something like ‘.item.title’.

• template nullable map where {:method -> <enum of GET, POST, PUT, DELETE, PATCH>, :url -> = 1>, :body (optional) -> , :headers (optional) -> , :parameters (optional) -> , :parameter_mappings (optional) -> } with no other keys.

• type nullable Unsupported action type.

• dataset_query nullable map.

• model_id value must be an integer greater than zero.

• kind nullable Unsupported implicit action kind.

• parameter_mappings nullable map.

• action

POST /api/action/:id/execute

Execute the Action.

parameters should be the mapped dashboard parameters with values.

PARAMS:

• id value must be an integer greater than zero.

• parameters nullable map from to .

• _body

POST /api/action/:id/public_link

Generate publicly-accessible links for this Action. Returns UUID to be used in public links. (If this Action has already been shared, it will return the existing public link rather than creating a new one.) Public sharing must be enabled.

You must be a superuser to do this.

PARAMS:

• id value must be an integer greater than zero.

PUT /api/action/:id

Update an Action.

PARAMS:

• id value must be an integer greater than zero.

• action map where {:archived (optional) -> , :database_id (optional) -> , :dataset_query (optional) -> , :description (optional) -> , :error_handle (optional) -> <nullable string, and must be a valid json-query, something like '.item.title'>, :kind (optional) -> , :model_id (optional) -> , :name (optional) -> , :parameter_mappings (optional) -> , :parameters (optional) -> , :response_handle (optional) -> <nullable string, and must be a valid json-query, something like '.item.title'>, :template (optional) -> <nullable map where {:method -> <enum of GET, POST, PUT, DELETE, PATCH>, :url -> = 1>, :body (optional) -> , :headers (optional) -> , :parameters (optional) -> , :parameter_mappings (optional) -> } with no other keys>, :type (optional) -> , :visualization_settings (optional) -> }.

---

« Back to API index