Stay organized with collections
Save and categorize content based on your preferences.
Version 4.0.25.14 (latest)
For some data actions, the remote server may supply a form requesting further user input. This endpoint takes a data action, asks the remote server to generate a form for it, and returns that form to you for presentation to the user.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[],[],null,["# Fetch Remote Data Action Form\n\nVersion 4.0.25.14 (latest)\n\nFor some data actions, the remote server may supply a form requesting further user input. This endpoint takes a data action, asks the remote server to generate a form for it, and returns that form to you for presentation to the user.\n\nRequest\n-------\n\nPOST /data_actions/form \nDatatype \nDescription \nRequest \nHTTP Request \nbody \nHTTP Body \nExpand HTTP Body definition... \nbody \nobject \nData Action Request\n\nResponse\n--------\n\n### 200: Data Action Form\n\nDatatype \nDescription \n(object) \n[DataActionForm](/looker/docs/reference/looker-api/latest/types/DataActionForm) \nstate \n*lock* \n[DataActionUserState](/looker/docs/reference/looker-api/latest/types/DataActionUserState) \nUser state\nExpand DataActionUserState definition... \ndata \n*lock* \nstring \nUser state data \nrefresh_time \n*lock* \ninteger \nTime in seconds until the state needs to be refreshed \nfields \n[DataActionFormField](/looker/docs/reference/looker-api/latest/types/DataActionFormField)\\[\\] \nExpand DataActionFormField definition... \nname \n*lock* \nstring \nName \nlabel \n*lock* \nstring \nHuman-readable label \ndescription \n*lock* \nstring \nDescription of field \ntype \n*lock* \nstring \nType of field. \ndefault \n*lock* \nstring \nDefault value of the field. \noauth_url \n*lock* \nstring \nThe URL for an oauth link, if type is 'oauth_link'. \ninteractive \n*lock* \nboolean \nWhether or not a field supports interactive forms. \nrequired \n*lock* \nboolean \nWhether or not the field is required. This is a user-interface hint. A user interface displaying this form should not submit it without a value for this field. The action server must also perform this validation. \noptions \n[DataActionFormSelectOption](/looker/docs/reference/looker-api/latest/types/DataActionFormSelectOption)\\[\\] \nExpand DataActionFormSelectOption definition... \nname \n*lock* \nstring \nName \nlabel \n*lock* \nstring \nHuman-readable label\n\n### 400: Bad Request\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 404: Not Found\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 422: Validation Error\n\nDatatype \nDescription \n(object) \n[ValidationError](/looker/docs/reference/looker-api/latest/types/ValidationError) \nmessage \n*lock* \nstring \nError details \nerrors \n[ValidationErrorDetail](/looker/docs/reference/looker-api/latest/types/ValidationErrorDetail)\\[\\] \nExpand ValidationErrorDetail definition... \nfield \n*lock* \nstring \nField with error \ncode \n*lock* \nstring \nError code \nmessage \n*lock* \nstring \nError info message \ndocumentation_url \n*lock* \nstring \nDocumentation link \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 429: Too Many Requests\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link"]]
