# Create table metadata

Endpoint: POST /table-metadata
Version: 5.1.41
Security: api_key

## Request fields (application/json):

  - `tableName` (string, required)
    The name of the table metadata. This name must match the name of a table in the ruleset it is created on. This name must be unique for the given ruleset; in other words, the same table cannot be added to a ruleset more than once.
    Example: "profile"

  - `rulesetId` (integer, required)
    The ID of the ruleset to create the table metadata on.
    Example: 1

  - `customSql` (string)
    Custom SQL for the table.

  - `whereClause` (string)
    SQL where clause for the table.

  - `havingClause` (string)
    SQL having clause for the table.

  - `keyColumn` (string)
    Key Column for the table.

## Response 201 fields (application/json):

  - `tableMetadataId` (integer)
    The ID of the table metadata. This field is set by the Masking Engine.

  - `tableName` (string, required)
    The name of the table metadata. This name must match the name of a table in the ruleset it is created on. This name must be unique for the given ruleset; in other words, the same table cannot be added to a ruleset more than once.
    Example: "profile"

  - `rulesetId` (integer, required)
    The ID of the ruleset to create the table metadata on.
    Example: 1

  - `customSql` (string)
    Custom SQL for the table.

  - `whereClause` (string)
    SQL where clause for the table.

  - `havingClause` (string)
    SQL having clause for the table.

  - `keyColumn` (string)
    Key Column for the table.

  - `isMasked` (boolean)
    This field is true if one or more data columns associated with this table have a masking assignment, and false otherwise. Results may be filtered by this field using the search API.

  - `rowCount` (integer)
    The last known row count of the table. This value is updated during rule set refresh and when a masking job is executed.

  - `lastRefreshTime` (string)
    The last time the table and column metadata for this rule set were refreshed.

  - `lastRowCountTime` (string)
    The last time table row counts for this rule set were fully refreshed.


## Response 400 fields

## Response 403 fields

## Response 404 fields

## Response 409 fields