> For the complete documentation index, see [llms.txt](https://docs.ecosuite.io/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ecosuite.io/api/ecosuite-project-data-api/widgetconfigs.md).

# WidgetConfigs

## GET /widgetConfigs

>

```json
{"openapi":"3.1.0","info":{"title":"Api","version":"0.0.1"},"tags":[{"name":"widgetConfigs"}],"security":[{"bearer":[]},{"apiKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"},"apiKey":{"type":"apiKey","name":"X-API-Key","in":"header"}},"schemas":{"WidgetConfigRecord":{"type":"object","required":["id","application","organizationId","createdAt","updatedAt","lastUpdatedBy"],"properties":{"id":{"$ref":"#/components/schemas/WidgetConfigRecordId"},"application":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Application"}},{"type":"null"}],"description":"Array of applications with their widget configs","title":"Applications"},"organizationId":{"type":"string","description":"a Universally Unique Identifier","title":"Organization ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"userId":{"anyOf":[{"$ref":"#/components/schemas/UUID"},{"type":"null"}],"title":"User ID","description":"User ID for per-user widget configs. Null for organization-level configs."},"createdAt":{"type":"string","description":"ISO datetime string of when the widget config was created","title":"Created At"},"updatedAt":{"type":"string","description":"ISO datetime string of when the widget config was last updated","title":"Updated At"},"lastUpdatedBy":{"type":"string","description":"ID or email of the user who last updated this record","title":"Last Updated By"}},"additionalProperties":false,"description":"Represents a widget config record in the database","title":"Widget Config Record"},"WidgetConfigRecordId":{"type":"string","description":"Unique identifier for the widget config record","title":"Widget Config Record ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"Application":{"type":"object","required":["name","widgets"],"properties":{"name":{"type":"string","description":"Name of the application","title":"Application Name"},"widgets":{"type":"array","items":{"$ref":"#/components/schemas/WidgetConfig"},"description":"Array of widget configs belonging to this application","title":"Widget Configs"}},"additionalProperties":false,"description":"Represents an application containing multiple widget configs","title":"Application"},"WidgetConfig":{"type":"object","required":["name","location","enable"],"properties":{"name":{"type":"string","description":"Name of the widget config","title":"Widget Config Name"},"location":{"type":"number","description":"Location or placement of the widget config","title":"Widget Config Location"},"enable":{"type":"boolean","description":"Whether the widget config is enabled or disabled","title":"Widget Config Enabled"}},"additionalProperties":false,"description":"Represents a widget config within an application","title":"Widget Config"},"UUID":{"type":"string","description":"a Universally Unique Identifier","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"HttpApiDecodeError":{"type":"object","required":["issues","message","_tag"],"properties":{"issues":{"type":"array","items":{"$ref":"#/components/schemas/Issue"}},"message":{"type":"string"},"_tag":{"type":"string","enum":["HttpApiDecodeError"]}},"additionalProperties":false,"description":"The request did not match the expected schema"},"Issue":{"type":"object","required":["_tag","path","message"],"properties":{"_tag":{"type":"string","enum":["Pointer","Unexpected","Missing","Composite","Refinement","Transformation","Type","Forbidden"],"description":"The tag identifying the type of parse issue"},"path":{"type":"array","items":{"$ref":"#/components/schemas/PropertyKey"},"description":"The path to the property where the issue occurred"},"message":{"type":"string","description":"A descriptive message explaining the issue"}},"additionalProperties":false,"description":"Represents an error encountered while parsing a value to match the schema"},"PropertyKey":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","required":["_tag","key"],"properties":{"_tag":{"type":"string","enum":["symbol"]},"key":{"type":"string"}},"additionalProperties":false,"description":"an object to be decoded into a globally shared symbol"}]},"BadRequest":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["BadRequest"]}},"additionalProperties":false,"description":"The request was invalid or cannot be otherwise served"},"Unauthorized":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Unauthorized"]}},"additionalProperties":false,"description":"Authentication is required and has failed or has not been provided"},"Forbidden":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Forbidden"]}},"additionalProperties":false,"description":"The server understood the request but refuses to authorize it"},"UserAccessNotWithinAllowedWindowHttpError":{"type":"object","required":["message","_tag"],"properties":{"message":{"type":"string"},"_tag":{"type":"string","enum":["UserAccessNotWithinAllowedWindowHttpError"]}},"additionalProperties":false,"description":"User access is not within the allowed time window"},"TooManyRequests":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"retryAfterSeconds":{"type":"number"},"_tag":{"type":"string","enum":["TooManyRequests"]}},"additionalProperties":false,"description":"The user has sent too many requests in a given amount of time"},"InternalServerError":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["InternalServerError"]}},"additionalProperties":false,"description":"The server has encountered a situation it doesn't know how to handle"},"ServiceUnavailable":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["ServiceUnavailable"]}},"additionalProperties":false,"description":"The server is not ready to handle the request"}}},"paths":{"/widgetConfigs":{"get":{"tags":["widgetConfigs"],"operationId":"widgetConfigs.getWidgetConfigs","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WidgetConfigRecord"}}}}},"400":{"description":"The request did not match the expected schema","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/HttpApiDecodeError"},{"$ref":"#/components/schemas/BadRequest"}]}}}},"401":{"description":"Authentication is required and has failed or has not been provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"The server understood the request but refuses to authorize it","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Forbidden"},{"$ref":"#/components/schemas/UserAccessNotWithinAllowedWindowHttpError"}]}}}},"429":{"description":"The user has sent too many requests in a given amount of time","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}}}},"500":{"description":"The server has encountered a situation it doesn't know how to handle","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}},"503":{"description":"The server is not ready to handle the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailable"}}}}}}}}}
```

## POST /widgetConfigs

>

```json
{"openapi":"3.1.0","info":{"title":"Api","version":"0.0.1"},"tags":[{"name":"widgetConfigs"}],"security":[{"bearer":[]},{"apiKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"},"apiKey":{"type":"apiKey","name":"X-API-Key","in":"header"}},"schemas":{"WidgetConfigRecord":{"type":"object","required":["id","application","organizationId","createdAt","updatedAt","lastUpdatedBy"],"properties":{"id":{"$ref":"#/components/schemas/WidgetConfigRecordId"},"application":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Application"}},{"type":"null"}],"description":"Array of applications with their widget configs","title":"Applications"},"organizationId":{"type":"string","description":"a Universally Unique Identifier","title":"Organization ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"userId":{"anyOf":[{"$ref":"#/components/schemas/UUID"},{"type":"null"}],"title":"User ID","description":"User ID for per-user widget configs. Null for organization-level configs."},"createdAt":{"type":"string","description":"ISO datetime string of when the widget config was created","title":"Created At"},"updatedAt":{"type":"string","description":"ISO datetime string of when the widget config was last updated","title":"Updated At"},"lastUpdatedBy":{"type":"string","description":"ID or email of the user who last updated this record","title":"Last Updated By"}},"additionalProperties":false,"description":"Represents a widget config record in the database","title":"Widget Config Record"},"WidgetConfigRecordId":{"type":"string","description":"Unique identifier for the widget config record","title":"Widget Config Record ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"Application":{"type":"object","required":["name","widgets"],"properties":{"name":{"type":"string","description":"Name of the application","title":"Application Name"},"widgets":{"type":"array","items":{"$ref":"#/components/schemas/WidgetConfig"},"description":"Array of widget configs belonging to this application","title":"Widget Configs"}},"additionalProperties":false,"description":"Represents an application containing multiple widget configs","title":"Application"},"WidgetConfig":{"type":"object","required":["name","location","enable"],"properties":{"name":{"type":"string","description":"Name of the widget config","title":"Widget Config Name"},"location":{"type":"number","description":"Location or placement of the widget config","title":"Widget Config Location"},"enable":{"type":"boolean","description":"Whether the widget config is enabled or disabled","title":"Widget Config Enabled"}},"additionalProperties":false,"description":"Represents a widget config within an application","title":"Widget Config"},"UUID":{"type":"string","description":"a Universally Unique Identifier","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"HttpApiDecodeError":{"type":"object","required":["issues","message","_tag"],"properties":{"issues":{"type":"array","items":{"$ref":"#/components/schemas/Issue"}},"message":{"type":"string"},"_tag":{"type":"string","enum":["HttpApiDecodeError"]}},"additionalProperties":false,"description":"The request did not match the expected schema"},"Issue":{"type":"object","required":["_tag","path","message"],"properties":{"_tag":{"type":"string","enum":["Pointer","Unexpected","Missing","Composite","Refinement","Transformation","Type","Forbidden"],"description":"The tag identifying the type of parse issue"},"path":{"type":"array","items":{"$ref":"#/components/schemas/PropertyKey"},"description":"The path to the property where the issue occurred"},"message":{"type":"string","description":"A descriptive message explaining the issue"}},"additionalProperties":false,"description":"Represents an error encountered while parsing a value to match the schema"},"PropertyKey":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","required":["_tag","key"],"properties":{"_tag":{"type":"string","enum":["symbol"]},"key":{"type":"string"}},"additionalProperties":false,"description":"an object to be decoded into a globally shared symbol"}]},"BadRequest":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["BadRequest"]}},"additionalProperties":false,"description":"The request was invalid or cannot be otherwise served"},"Unauthorized":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Unauthorized"]}},"additionalProperties":false,"description":"Authentication is required and has failed or has not been provided"},"Forbidden":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Forbidden"]}},"additionalProperties":false,"description":"The server understood the request but refuses to authorize it"},"UserAccessNotWithinAllowedWindowHttpError":{"type":"object","required":["message","_tag"],"properties":{"message":{"type":"string"},"_tag":{"type":"string","enum":["UserAccessNotWithinAllowedWindowHttpError"]}},"additionalProperties":false,"description":"User access is not within the allowed time window"},"Conflict":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Conflict"]}},"additionalProperties":false,"description":"The resource already exists"},"TooManyRequests":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"retryAfterSeconds":{"type":"number"},"_tag":{"type":"string","enum":["TooManyRequests"]}},"additionalProperties":false,"description":"The user has sent too many requests in a given amount of time"},"InternalServerError":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["InternalServerError"]}},"additionalProperties":false,"description":"The server has encountered a situation it doesn't know how to handle"},"ServiceUnavailable":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["ServiceUnavailable"]}},"additionalProperties":false,"description":"The server is not ready to handle the request"}}},"paths":{"/widgetConfigs":{"post":{"tags":["widgetConfigs"],"operationId":"widgetConfigs.createWidgetConfig","parameters":[],"responses":{"200":{"description":"Represents a widget config record in the database","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetConfigRecord"}}}},"400":{"description":"The request did not match the expected schema","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/HttpApiDecodeError"},{"$ref":"#/components/schemas/BadRequest"}]}}}},"401":{"description":"Authentication is required and has failed or has not been provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"The server understood the request but refuses to authorize it","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Forbidden"},{"$ref":"#/components/schemas/UserAccessNotWithinAllowedWindowHttpError"}]}}}},"409":{"description":"The resource already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conflict"}}}},"429":{"description":"The user has sent too many requests in a given amount of time","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}}}},"500":{"description":"The server has encountered a situation it doesn't know how to handle","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}},"503":{"description":"The server is not ready to handle the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailable"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["application"],"properties":{"application":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Application"}},{"type":"null"}],"description":"Array of applications with their widget configs","title":"Applications"}},"additionalProperties":false}}},"required":true}}}}}
```

## GET /widgetConfigs/me

>

```json
{"openapi":"3.1.0","info":{"title":"Api","version":"0.0.1"},"tags":[{"name":"widgetConfigs"}],"security":[{"bearer":[]},{"apiKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"},"apiKey":{"type":"apiKey","name":"X-API-Key","in":"header"}},"schemas":{"WidgetConfigRecord":{"type":"object","required":["id","application","organizationId","createdAt","updatedAt","lastUpdatedBy"],"properties":{"id":{"$ref":"#/components/schemas/WidgetConfigRecordId"},"application":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Application"}},{"type":"null"}],"description":"Array of applications with their widget configs","title":"Applications"},"organizationId":{"type":"string","description":"a Universally Unique Identifier","title":"Organization ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"userId":{"anyOf":[{"$ref":"#/components/schemas/UUID"},{"type":"null"}],"title":"User ID","description":"User ID for per-user widget configs. Null for organization-level configs."},"createdAt":{"type":"string","description":"ISO datetime string of when the widget config was created","title":"Created At"},"updatedAt":{"type":"string","description":"ISO datetime string of when the widget config was last updated","title":"Updated At"},"lastUpdatedBy":{"type":"string","description":"ID or email of the user who last updated this record","title":"Last Updated By"}},"additionalProperties":false,"description":"Represents a widget config record in the database","title":"Widget Config Record"},"WidgetConfigRecordId":{"type":"string","description":"Unique identifier for the widget config record","title":"Widget Config Record ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"Application":{"type":"object","required":["name","widgets"],"properties":{"name":{"type":"string","description":"Name of the application","title":"Application Name"},"widgets":{"type":"array","items":{"$ref":"#/components/schemas/WidgetConfig"},"description":"Array of widget configs belonging to this application","title":"Widget Configs"}},"additionalProperties":false,"description":"Represents an application containing multiple widget configs","title":"Application"},"WidgetConfig":{"type":"object","required":["name","location","enable"],"properties":{"name":{"type":"string","description":"Name of the widget config","title":"Widget Config Name"},"location":{"type":"number","description":"Location or placement of the widget config","title":"Widget Config Location"},"enable":{"type":"boolean","description":"Whether the widget config is enabled or disabled","title":"Widget Config Enabled"}},"additionalProperties":false,"description":"Represents a widget config within an application","title":"Widget Config"},"UUID":{"type":"string","description":"a Universally Unique Identifier","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"HttpApiDecodeError":{"type":"object","required":["issues","message","_tag"],"properties":{"issues":{"type":"array","items":{"$ref":"#/components/schemas/Issue"}},"message":{"type":"string"},"_tag":{"type":"string","enum":["HttpApiDecodeError"]}},"additionalProperties":false,"description":"The request did not match the expected schema"},"Issue":{"type":"object","required":["_tag","path","message"],"properties":{"_tag":{"type":"string","enum":["Pointer","Unexpected","Missing","Composite","Refinement","Transformation","Type","Forbidden"],"description":"The tag identifying the type of parse issue"},"path":{"type":"array","items":{"$ref":"#/components/schemas/PropertyKey"},"description":"The path to the property where the issue occurred"},"message":{"type":"string","description":"A descriptive message explaining the issue"}},"additionalProperties":false,"description":"Represents an error encountered while parsing a value to match the schema"},"PropertyKey":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","required":["_tag","key"],"properties":{"_tag":{"type":"string","enum":["symbol"]},"key":{"type":"string"}},"additionalProperties":false,"description":"an object to be decoded into a globally shared symbol"}]},"BadRequest":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["BadRequest"]}},"additionalProperties":false,"description":"The request was invalid or cannot be otherwise served"},"Unauthorized":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Unauthorized"]}},"additionalProperties":false,"description":"Authentication is required and has failed or has not been provided"},"Forbidden":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Forbidden"]}},"additionalProperties":false,"description":"The server understood the request but refuses to authorize it"},"UserAccessNotWithinAllowedWindowHttpError":{"type":"object","required":["message","_tag"],"properties":{"message":{"type":"string"},"_tag":{"type":"string","enum":["UserAccessNotWithinAllowedWindowHttpError"]}},"additionalProperties":false,"description":"User access is not within the allowed time window"},"NotFound":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["NotFound"]}},"additionalProperties":false,"description":"The requested resource could not be found"},"TooManyRequests":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"retryAfterSeconds":{"type":"number"},"_tag":{"type":"string","enum":["TooManyRequests"]}},"additionalProperties":false,"description":"The user has sent too many requests in a given amount of time"},"InternalServerError":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["InternalServerError"]}},"additionalProperties":false,"description":"The server has encountered a situation it doesn't know how to handle"},"ServiceUnavailable":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["ServiceUnavailable"]}},"additionalProperties":false,"description":"The server is not ready to handle the request"}}},"paths":{"/widgetConfigs/me":{"get":{"tags":["widgetConfigs"],"operationId":"widgetConfigs.getMyWidgetConfig","parameters":[],"responses":{"200":{"description":"Represents a widget config record in the database","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetConfigRecord"}}}},"400":{"description":"The request did not match the expected schema","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/HttpApiDecodeError"},{"$ref":"#/components/schemas/BadRequest"}]}}}},"401":{"description":"Authentication is required and has failed or has not been provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"The server understood the request but refuses to authorize it","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Forbidden"},{"$ref":"#/components/schemas/UserAccessNotWithinAllowedWindowHttpError"}]}}}},"404":{"description":"The requested resource could not be found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"429":{"description":"The user has sent too many requests in a given amount of time","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}}}},"500":{"description":"The server has encountered a situation it doesn't know how to handle","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}},"503":{"description":"The server is not ready to handle the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailable"}}}}}}}}}
```

## PUT /widgetConfigs/me

>

```json
{"openapi":"3.1.0","info":{"title":"Api","version":"0.0.1"},"tags":[{"name":"widgetConfigs"}],"security":[{"bearer":[]},{"apiKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"},"apiKey":{"type":"apiKey","name":"X-API-Key","in":"header"}},"schemas":{"WidgetConfigRecord":{"type":"object","required":["id","application","organizationId","createdAt","updatedAt","lastUpdatedBy"],"properties":{"id":{"$ref":"#/components/schemas/WidgetConfigRecordId"},"application":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Application"}},{"type":"null"}],"description":"Array of applications with their widget configs","title":"Applications"},"organizationId":{"type":"string","description":"a Universally Unique Identifier","title":"Organization ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"userId":{"anyOf":[{"$ref":"#/components/schemas/UUID"},{"type":"null"}],"title":"User ID","description":"User ID for per-user widget configs. Null for organization-level configs."},"createdAt":{"type":"string","description":"ISO datetime string of when the widget config was created","title":"Created At"},"updatedAt":{"type":"string","description":"ISO datetime string of when the widget config was last updated","title":"Updated At"},"lastUpdatedBy":{"type":"string","description":"ID or email of the user who last updated this record","title":"Last Updated By"}},"additionalProperties":false,"description":"Represents a widget config record in the database","title":"Widget Config Record"},"WidgetConfigRecordId":{"type":"string","description":"Unique identifier for the widget config record","title":"Widget Config Record ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"Application":{"type":"object","required":["name","widgets"],"properties":{"name":{"type":"string","description":"Name of the application","title":"Application Name"},"widgets":{"type":"array","items":{"$ref":"#/components/schemas/WidgetConfig"},"description":"Array of widget configs belonging to this application","title":"Widget Configs"}},"additionalProperties":false,"description":"Represents an application containing multiple widget configs","title":"Application"},"WidgetConfig":{"type":"object","required":["name","location","enable"],"properties":{"name":{"type":"string","description":"Name of the widget config","title":"Widget Config Name"},"location":{"type":"number","description":"Location or placement of the widget config","title":"Widget Config Location"},"enable":{"type":"boolean","description":"Whether the widget config is enabled or disabled","title":"Widget Config Enabled"}},"additionalProperties":false,"description":"Represents a widget config within an application","title":"Widget Config"},"UUID":{"type":"string","description":"a Universally Unique Identifier","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"HttpApiDecodeError":{"type":"object","required":["issues","message","_tag"],"properties":{"issues":{"type":"array","items":{"$ref":"#/components/schemas/Issue"}},"message":{"type":"string"},"_tag":{"type":"string","enum":["HttpApiDecodeError"]}},"additionalProperties":false,"description":"The request did not match the expected schema"},"Issue":{"type":"object","required":["_tag","path","message"],"properties":{"_tag":{"type":"string","enum":["Pointer","Unexpected","Missing","Composite","Refinement","Transformation","Type","Forbidden"],"description":"The tag identifying the type of parse issue"},"path":{"type":"array","items":{"$ref":"#/components/schemas/PropertyKey"},"description":"The path to the property where the issue occurred"},"message":{"type":"string","description":"A descriptive message explaining the issue"}},"additionalProperties":false,"description":"Represents an error encountered while parsing a value to match the schema"},"PropertyKey":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","required":["_tag","key"],"properties":{"_tag":{"type":"string","enum":["symbol"]},"key":{"type":"string"}},"additionalProperties":false,"description":"an object to be decoded into a globally shared symbol"}]},"BadRequest":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["BadRequest"]}},"additionalProperties":false,"description":"The request was invalid or cannot be otherwise served"},"Unauthorized":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Unauthorized"]}},"additionalProperties":false,"description":"Authentication is required and has failed or has not been provided"},"Forbidden":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Forbidden"]}},"additionalProperties":false,"description":"The server understood the request but refuses to authorize it"},"UserAccessNotWithinAllowedWindowHttpError":{"type":"object","required":["message","_tag"],"properties":{"message":{"type":"string"},"_tag":{"type":"string","enum":["UserAccessNotWithinAllowedWindowHttpError"]}},"additionalProperties":false,"description":"User access is not within the allowed time window"},"Conflict":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Conflict"]}},"additionalProperties":false,"description":"The resource already exists"},"TooManyRequests":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"retryAfterSeconds":{"type":"number"},"_tag":{"type":"string","enum":["TooManyRequests"]}},"additionalProperties":false,"description":"The user has sent too many requests in a given amount of time"},"InternalServerError":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["InternalServerError"]}},"additionalProperties":false,"description":"The server has encountered a situation it doesn't know how to handle"},"ServiceUnavailable":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["ServiceUnavailable"]}},"additionalProperties":false,"description":"The server is not ready to handle the request"}}},"paths":{"/widgetConfigs/me":{"put":{"tags":["widgetConfigs"],"operationId":"widgetConfigs.updateMyWidgetConfig","parameters":[],"responses":{"200":{"description":"Represents a widget config record in the database","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetConfigRecord"}}}},"400":{"description":"The request did not match the expected schema","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/HttpApiDecodeError"},{"$ref":"#/components/schemas/BadRequest"}]}}}},"401":{"description":"Authentication is required and has failed or has not been provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"The server understood the request but refuses to authorize it","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Forbidden"},{"$ref":"#/components/schemas/UserAccessNotWithinAllowedWindowHttpError"}]}}}},"409":{"description":"The resource already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conflict"}}}},"429":{"description":"The user has sent too many requests in a given amount of time","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}}}},"500":{"description":"The server has encountered a situation it doesn't know how to handle","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}},"503":{"description":"The server is not ready to handle the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailable"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["application"],"properties":{"application":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Application"}},{"type":"null"}],"description":"Array of applications with their widget configs","title":"Applications"}},"additionalProperties":false}}},"required":true}}}}}
```

## GET /widgetConfigs/{id}

>

```json
{"openapi":"3.1.0","info":{"title":"Api","version":"0.0.1"},"tags":[{"name":"widgetConfigs"}],"security":[{"bearer":[]},{"apiKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"},"apiKey":{"type":"apiKey","name":"X-API-Key","in":"header"}},"schemas":{"UUID":{"type":"string","description":"a Universally Unique Identifier","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"WidgetConfigRecord":{"type":"object","required":["id","application","organizationId","createdAt","updatedAt","lastUpdatedBy"],"properties":{"id":{"$ref":"#/components/schemas/WidgetConfigRecordId"},"application":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Application"}},{"type":"null"}],"description":"Array of applications with their widget configs","title":"Applications"},"organizationId":{"type":"string","description":"a Universally Unique Identifier","title":"Organization ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"userId":{"anyOf":[{"$ref":"#/components/schemas/UUID"},{"type":"null"}],"title":"User ID","description":"User ID for per-user widget configs. Null for organization-level configs."},"createdAt":{"type":"string","description":"ISO datetime string of when the widget config was created","title":"Created At"},"updatedAt":{"type":"string","description":"ISO datetime string of when the widget config was last updated","title":"Updated At"},"lastUpdatedBy":{"type":"string","description":"ID or email of the user who last updated this record","title":"Last Updated By"}},"additionalProperties":false,"description":"Represents a widget config record in the database","title":"Widget Config Record"},"WidgetConfigRecordId":{"type":"string","description":"Unique identifier for the widget config record","title":"Widget Config Record ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"Application":{"type":"object","required":["name","widgets"],"properties":{"name":{"type":"string","description":"Name of the application","title":"Application Name"},"widgets":{"type":"array","items":{"$ref":"#/components/schemas/WidgetConfig"},"description":"Array of widget configs belonging to this application","title":"Widget Configs"}},"additionalProperties":false,"description":"Represents an application containing multiple widget configs","title":"Application"},"WidgetConfig":{"type":"object","required":["name","location","enable"],"properties":{"name":{"type":"string","description":"Name of the widget config","title":"Widget Config Name"},"location":{"type":"number","description":"Location or placement of the widget config","title":"Widget Config Location"},"enable":{"type":"boolean","description":"Whether the widget config is enabled or disabled","title":"Widget Config Enabled"}},"additionalProperties":false,"description":"Represents a widget config within an application","title":"Widget Config"},"HttpApiDecodeError":{"type":"object","required":["issues","message","_tag"],"properties":{"issues":{"type":"array","items":{"$ref":"#/components/schemas/Issue"}},"message":{"type":"string"},"_tag":{"type":"string","enum":["HttpApiDecodeError"]}},"additionalProperties":false,"description":"The request did not match the expected schema"},"Issue":{"type":"object","required":["_tag","path","message"],"properties":{"_tag":{"type":"string","enum":["Pointer","Unexpected","Missing","Composite","Refinement","Transformation","Type","Forbidden"],"description":"The tag identifying the type of parse issue"},"path":{"type":"array","items":{"$ref":"#/components/schemas/PropertyKey"},"description":"The path to the property where the issue occurred"},"message":{"type":"string","description":"A descriptive message explaining the issue"}},"additionalProperties":false,"description":"Represents an error encountered while parsing a value to match the schema"},"PropertyKey":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","required":["_tag","key"],"properties":{"_tag":{"type":"string","enum":["symbol"]},"key":{"type":"string"}},"additionalProperties":false,"description":"an object to be decoded into a globally shared symbol"}]},"BadRequest":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["BadRequest"]}},"additionalProperties":false,"description":"The request was invalid or cannot be otherwise served"},"Unauthorized":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Unauthorized"]}},"additionalProperties":false,"description":"Authentication is required and has failed or has not been provided"},"Forbidden":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Forbidden"]}},"additionalProperties":false,"description":"The server understood the request but refuses to authorize it"},"UserAccessNotWithinAllowedWindowHttpError":{"type":"object","required":["message","_tag"],"properties":{"message":{"type":"string"},"_tag":{"type":"string","enum":["UserAccessNotWithinAllowedWindowHttpError"]}},"additionalProperties":false,"description":"User access is not within the allowed time window"},"NotFound":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["NotFound"]}},"additionalProperties":false,"description":"The requested resource could not be found"},"TooManyRequests":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"retryAfterSeconds":{"type":"number"},"_tag":{"type":"string","enum":["TooManyRequests"]}},"additionalProperties":false,"description":"The user has sent too many requests in a given amount of time"},"InternalServerError":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["InternalServerError"]}},"additionalProperties":false,"description":"The server has encountered a situation it doesn't know how to handle"},"ServiceUnavailable":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["ServiceUnavailable"]}},"additionalProperties":false,"description":"The server is not ready to handle the request"}}},"paths":{"/widgetConfigs/{id}":{"get":{"tags":["widgetConfigs"],"operationId":"widgetConfigs.getWidgetConfig","parameters":[{"name":"id","in":"path","schema":{"$ref":"#/components/schemas/UUID"},"required":true}],"responses":{"200":{"description":"Represents a widget config record in the database","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetConfigRecord"}}}},"400":{"description":"The request did not match the expected schema","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/HttpApiDecodeError"},{"$ref":"#/components/schemas/BadRequest"}]}}}},"401":{"description":"Authentication is required and has failed or has not been provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"The server understood the request but refuses to authorize it","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Forbidden"},{"$ref":"#/components/schemas/UserAccessNotWithinAllowedWindowHttpError"}]}}}},"404":{"description":"The requested resource could not be found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"429":{"description":"The user has sent too many requests in a given amount of time","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}}}},"500":{"description":"The server has encountered a situation it doesn't know how to handle","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}},"503":{"description":"The server is not ready to handle the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailable"}}}}}}}}}
```

## PUT /widgetConfigs/{id}

>

```json
{"openapi":"3.1.0","info":{"title":"Api","version":"0.0.1"},"tags":[{"name":"widgetConfigs"}],"security":[{"bearer":[]},{"apiKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"},"apiKey":{"type":"apiKey","name":"X-API-Key","in":"header"}},"schemas":{"UUID":{"type":"string","description":"a Universally Unique Identifier","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"WidgetConfigRecord":{"type":"object","required":["id","application","organizationId","createdAt","updatedAt","lastUpdatedBy"],"properties":{"id":{"$ref":"#/components/schemas/WidgetConfigRecordId"},"application":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Application"}},{"type":"null"}],"description":"Array of applications with their widget configs","title":"Applications"},"organizationId":{"type":"string","description":"a Universally Unique Identifier","title":"Organization ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"userId":{"anyOf":[{"$ref":"#/components/schemas/UUID"},{"type":"null"}],"title":"User ID","description":"User ID for per-user widget configs. Null for organization-level configs."},"createdAt":{"type":"string","description":"ISO datetime string of when the widget config was created","title":"Created At"},"updatedAt":{"type":"string","description":"ISO datetime string of when the widget config was last updated","title":"Updated At"},"lastUpdatedBy":{"type":"string","description":"ID or email of the user who last updated this record","title":"Last Updated By"}},"additionalProperties":false,"description":"Represents a widget config record in the database","title":"Widget Config Record"},"WidgetConfigRecordId":{"type":"string","description":"Unique identifier for the widget config record","title":"Widget Config Record ID","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"Application":{"type":"object","required":["name","widgets"],"properties":{"name":{"type":"string","description":"Name of the application","title":"Application Name"},"widgets":{"type":"array","items":{"$ref":"#/components/schemas/WidgetConfig"},"description":"Array of widget configs belonging to this application","title":"Widget Configs"}},"additionalProperties":false,"description":"Represents an application containing multiple widget configs","title":"Application"},"WidgetConfig":{"type":"object","required":["name","location","enable"],"properties":{"name":{"type":"string","description":"Name of the widget config","title":"Widget Config Name"},"location":{"type":"number","description":"Location or placement of the widget config","title":"Widget Config Location"},"enable":{"type":"boolean","description":"Whether the widget config is enabled or disabled","title":"Widget Config Enabled"}},"additionalProperties":false,"description":"Represents a widget config within an application","title":"Widget Config"},"HttpApiDecodeError":{"type":"object","required":["issues","message","_tag"],"properties":{"issues":{"type":"array","items":{"$ref":"#/components/schemas/Issue"}},"message":{"type":"string"},"_tag":{"type":"string","enum":["HttpApiDecodeError"]}},"additionalProperties":false,"description":"The request did not match the expected schema"},"Issue":{"type":"object","required":["_tag","path","message"],"properties":{"_tag":{"type":"string","enum":["Pointer","Unexpected","Missing","Composite","Refinement","Transformation","Type","Forbidden"],"description":"The tag identifying the type of parse issue"},"path":{"type":"array","items":{"$ref":"#/components/schemas/PropertyKey"},"description":"The path to the property where the issue occurred"},"message":{"type":"string","description":"A descriptive message explaining the issue"}},"additionalProperties":false,"description":"Represents an error encountered while parsing a value to match the schema"},"PropertyKey":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","required":["_tag","key"],"properties":{"_tag":{"type":"string","enum":["symbol"]},"key":{"type":"string"}},"additionalProperties":false,"description":"an object to be decoded into a globally shared symbol"}]},"BadRequest":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["BadRequest"]}},"additionalProperties":false,"description":"The request was invalid or cannot be otherwise served"},"Unauthorized":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Unauthorized"]}},"additionalProperties":false,"description":"Authentication is required and has failed or has not been provided"},"Forbidden":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Forbidden"]}},"additionalProperties":false,"description":"The server understood the request but refuses to authorize it"},"UserAccessNotWithinAllowedWindowHttpError":{"type":"object","required":["message","_tag"],"properties":{"message":{"type":"string"},"_tag":{"type":"string","enum":["UserAccessNotWithinAllowedWindowHttpError"]}},"additionalProperties":false,"description":"User access is not within the allowed time window"},"NotFound":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["NotFound"]}},"additionalProperties":false,"description":"The requested resource could not be found"},"Conflict":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Conflict"]}},"additionalProperties":false,"description":"The resource already exists"},"TooManyRequests":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"retryAfterSeconds":{"type":"number"},"_tag":{"type":"string","enum":["TooManyRequests"]}},"additionalProperties":false,"description":"The user has sent too many requests in a given amount of time"},"InternalServerError":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["InternalServerError"]}},"additionalProperties":false,"description":"The server has encountered a situation it doesn't know how to handle"},"ServiceUnavailable":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["ServiceUnavailable"]}},"additionalProperties":false,"description":"The server is not ready to handle the request"}}},"paths":{"/widgetConfigs/{id}":{"put":{"tags":["widgetConfigs"],"operationId":"widgetConfigs.updateWidgetConfig","parameters":[{"name":"id","in":"path","schema":{"$ref":"#/components/schemas/UUID"},"required":true}],"responses":{"200":{"description":"Represents a widget config record in the database","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetConfigRecord"}}}},"400":{"description":"The request did not match the expected schema","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/HttpApiDecodeError"},{"$ref":"#/components/schemas/BadRequest"}]}}}},"401":{"description":"Authentication is required and has failed or has not been provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"The server understood the request but refuses to authorize it","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Forbidden"},{"$ref":"#/components/schemas/UserAccessNotWithinAllowedWindowHttpError"}]}}}},"404":{"description":"The requested resource could not be found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"409":{"description":"The resource already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conflict"}}}},"429":{"description":"The user has sent too many requests in a given amount of time","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}}}},"500":{"description":"The server has encountered a situation it doesn't know how to handle","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}},"503":{"description":"The server is not ready to handle the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailable"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["application"],"properties":{"application":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Application"}},{"type":"null"}],"description":"Array of applications with their widget configs","title":"Applications"}},"additionalProperties":false}}},"required":true}}}}}
```

## DELETE /widgetConfigs/{id}

>

```json
{"openapi":"3.1.0","info":{"title":"Api","version":"0.0.1"},"tags":[{"name":"widgetConfigs"}],"security":[{"bearer":[]},{"apiKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"},"apiKey":{"type":"apiKey","name":"X-API-Key","in":"header"}},"schemas":{"UUID":{"type":"string","description":"a Universally Unique Identifier","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"HttpApiDecodeError":{"type":"object","required":["issues","message","_tag"],"properties":{"issues":{"type":"array","items":{"$ref":"#/components/schemas/Issue"}},"message":{"type":"string"},"_tag":{"type":"string","enum":["HttpApiDecodeError"]}},"additionalProperties":false,"description":"The request did not match the expected schema"},"Issue":{"type":"object","required":["_tag","path","message"],"properties":{"_tag":{"type":"string","enum":["Pointer","Unexpected","Missing","Composite","Refinement","Transformation","Type","Forbidden"],"description":"The tag identifying the type of parse issue"},"path":{"type":"array","items":{"$ref":"#/components/schemas/PropertyKey"},"description":"The path to the property where the issue occurred"},"message":{"type":"string","description":"A descriptive message explaining the issue"}},"additionalProperties":false,"description":"Represents an error encountered while parsing a value to match the schema"},"PropertyKey":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","required":["_tag","key"],"properties":{"_tag":{"type":"string","enum":["symbol"]},"key":{"type":"string"}},"additionalProperties":false,"description":"an object to be decoded into a globally shared symbol"}]},"BadRequest":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["BadRequest"]}},"additionalProperties":false,"description":"The request was invalid or cannot be otherwise served"},"Unauthorized":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Unauthorized"]}},"additionalProperties":false,"description":"Authentication is required and has failed or has not been provided"},"Forbidden":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["Forbidden"]}},"additionalProperties":false,"description":"The server understood the request but refuses to authorize it"},"UserAccessNotWithinAllowedWindowHttpError":{"type":"object","required":["message","_tag"],"properties":{"message":{"type":"string"},"_tag":{"type":"string","enum":["UserAccessNotWithinAllowedWindowHttpError"]}},"additionalProperties":false,"description":"User access is not within the allowed time window"},"TooManyRequests":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"retryAfterSeconds":{"type":"number"},"_tag":{"type":"string","enum":["TooManyRequests"]}},"additionalProperties":false,"description":"The user has sent too many requests in a given amount of time"},"InternalServerError":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["InternalServerError"]}},"additionalProperties":false,"description":"The server has encountered a situation it doesn't know how to handle"},"ServiceUnavailable":{"type":"object","required":["message","cause","_tag"],"properties":{"message":{"type":"string"},"cause":{"$id":"/schemas/unknown","title":"unknown"},"_tag":{"type":"string","enum":["ServiceUnavailable"]}},"additionalProperties":false,"description":"The server is not ready to handle the request"}}},"paths":{"/widgetConfigs/{id}":{"delete":{"tags":["widgetConfigs"],"operationId":"widgetConfigs.deleteWidgetConfig","parameters":[{"name":"id","in":"path","schema":{"$ref":"#/components/schemas/UUID"},"required":true}],"responses":{"204":{"description":"Success"},"400":{"description":"The request did not match the expected schema","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/HttpApiDecodeError"},{"$ref":"#/components/schemas/BadRequest"}]}}}},"401":{"description":"Authentication is required and has failed or has not been provided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"The server understood the request but refuses to authorize it","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Forbidden"},{"$ref":"#/components/schemas/UserAccessNotWithinAllowedWindowHttpError"}]}}}},"429":{"description":"The user has sent too many requests in a given amount of time","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequests"}}}},"500":{"description":"The server has encountered a situation it doesn't know how to handle","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}},"503":{"description":"The server is not ready to handle the request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailable"}}}}}}}}}
```