Table preferences

>>>

GET /api/users/:user_id/table_preferences
List of table preferences for a user

Examples

GET /api/users/988725677/table_preferences
403
{
  "error": {
    "message": "Access denied",
    "details": "You are trying access the preferences of a different user",
    "missing_permissions": null
  }
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Must be a Integer
organization_id
optional

Set the current organization context for the request

Validations:

  • Must be a Integer
>>>

GET /api/users/:user_id/table_preferences/:name
Table preference details of a given table

Examples

GET /api/users/135138680/table_preferences/test_subscriptions_resource
200
{
  "id": 3,
  "name": "test_subscriptions_resource",
  "columns": [
    "1",
    "2",
    "3"
  ],
  "created_at": "2021-09-01 14:09:56 UTC",
  "updated_at": "2021-09-01 14:09:56 UTC"
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Must be a Integer
organization_id
optional

Set the current organization context for the request

Validations:

  • Must be a Integer
name
required

Validations:

  • Must be a String
>>>

POST /api/users/:user_id/table_preferences
Creates a table preference for a given table

Examples

POST /api/users/135138680/table_preferences
{
  "name": "test_subscriptions_resource",
  "columns": [
    "1",
    "2",
    "3"
  ],
  "table_preference": {
    "name": "test_subscriptions_resource",
    "columns": [
      "1",
      "2",
      "3"
    ]
  }
}
201
{
  "id": 4,
  "name": "test_subscriptions_resource",
  "columns": [
    "1",
    "2",
    "3"
  ],
  "created_at": "2021-09-01 14:09:57 UTC",
  "updated_at": "2021-09-01 14:09:57 UTC"
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Must be a Integer
organization_id
optional

Set the current organization context for the request

Validations:

  • Must be a Integer
table_preferences
required

Validations:

  • Must be a Hash
table_preferences[name]
required

Name of the table

Validations:

  • Must be a String
table_preferences[columns]
optional

List of user selected columns

Validations:

  • Must be an array of any type
>>>

PUT /api/users/:user_id/table_preferences/:name
Updates a table preference for a given table

Examples

PUT /api/users/135138680/table_preferences/test_subscriptions_resource
{
  "columns": [
    "1",
    "2",
    "3"
  ],
  "table_preference": {
    "columns": [
      "1",
      "2",
      "3"
    ]
  }
}
200
{
  "id": 5,
  "name": "test_subscriptions_resource",
  "columns": [
    "1",
    "2",
    "3"
  ],
  "created_at": "2021-09-01 14:09:57 UTC",
  "updated_at": "2021-09-01 14:09:57 UTC"
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Must be a Integer
organization_id
optional

Set the current organization context for the request

Validations:

  • Must be a Integer
table_preferences
required

Validations:

  • Must be a Hash
table_preferences[name]
required

Name of the table

Validations:

  • Must be a String
table_preferences[columns]
optional

List of user selected columns

Validations:

  • Must be an array of any type
>>>

DELETE /api/users/:user_id/table_preferences/:name
Delete a table preference for a given table

Examples

DELETE /api/users/135138680/table_preferences/test_subscriptions_resource
{
  "table_preference": {}
}
200
{
  "id": 1,
  "name": "test_subscriptions_resource",
  "columns": [
    "1",
    "2",
    "3"
  ],
  "created_at": "2021-09-01 14:09:56 UTC",
  "updated_at": "2021-09-01 14:09:56 UTC"
}

Params

Param name Description
location_id
optional

Set the current location context for the request

Validations:

  • Must be a Integer
organization_id
optional

Set the current organization context for the request

Validations:

  • Must be a Integer
name
required

name of the table

Validations:

  • Must be a String