# Azure Tables API

> Azure Tables API on Apizie: 9 endpoints (Queries entities under the given table., Retrieve a single entity., Update entity in a table., Merge entity in a table., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:azure-cosmos-db-tables`
- Category: Cloud
- Status: byok
- Source: https://learn.microsoft.com/rest/api/azure/
- Page: https://zieapi.vercel.app/api/cloud/azure-cosmos-db-tables
- OpenAPI: https://zieapi.vercel.app/api/cloud/azure-cosmos-db-tables/openapi.json



## Endpoints

### Queries entities under the given table.
`GET https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/table-query-entities` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The host name of the tables account, e.g. accountName.table.core.windows.net |
| DataServiceVersion | string | yes | DataServiceVersion header |
| x-ms-version | string | yes | The API version. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| table | string | yes | The name of the table. |
| $format | string | no | Specifies the metadata format for the response. |
| $top | integer | no | Specifies the maximum number of records to return. |
| $select | string | no | Select expression using OData notation. Limits the columns on each record to just those requested. |
| $filter | string | no | OData filter expression. |
| timeout | integer | no | The timeout parameter is expressed in seconds. |
| NextPartitionKey | string | no | An entity partition key query continuation token from a previous call. |
| NextRowKey | string | no | An entity row key query continuation token from a previous call. |

### Retrieve a single entity.
`GET https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/table-query-entity-with-partition-and-row-key` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The host name of the tables account, e.g. accountName.table.core.windows.net |
| DataServiceVersion | string | yes | DataServiceVersion header |
| x-ms-version | string | yes | The API version. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| table | string | yes | The name of the table. |
| timeout | integer | no | The timeout parameter is expressed in seconds. |
| $format | string | no | Specifies the metadata format for the response. |
| $select | string | no | Select expression using OData notation. Limits the columns on each record to just those requested. |
| $filter | string | no | OData filter expression. |
| partitionKey | string | yes | The partition key of the entity. |
| rowKey | string | yes | The row key of the entity. |

### Update entity in a table.
`POST https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/table-update-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The host name of the tables account, e.g. accountName.table.core.windows.net |
| DataServiceVersion | string | yes | DataServiceVersion header |
| x-ms-version | string | yes | The API version. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| table | string | yes | The name of the table. |
| timeout | integer | no | The timeout parameter is expressed in seconds. |
| If-Match | string | no | Match condition for an entity to be deleted. If specified and a matching entity is not found, an error will be raised. To force an… |
| partitionKey | string | yes | The partition key of the entity. |
| rowKey | string | yes | The row key of the entity. |
| body | object | no | JSON request body |

### Merge entity in a table.
`POST https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/table-merge-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The host name of the tables account, e.g. accountName.table.core.windows.net |
| DataServiceVersion | string | yes | DataServiceVersion header |
| x-ms-version | string | yes | The API version. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| table | string | yes | The name of the table. |
| timeout | integer | no | The timeout parameter is expressed in seconds. |
| If-Match | string | no | Match condition for an entity to be deleted. If specified and a matching entity is not found, an error will be raised. To force an… |
| partitionKey | string | yes | The partition key of the entity. |
| rowKey | string | yes | The row key of the entity. |
| body | object | no | JSON request body |

### Deletes the specified entity in a table.
`POST https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/table-delete-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The host name of the tables account, e.g. accountName.table.core.windows.net |
| DataServiceVersion | string | yes | DataServiceVersion header |
| x-ms-version | string | yes | The API version. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| table | string | yes | The name of the table. |
| timeout | integer | no | The timeout parameter is expressed in seconds. |
| If-Match | string | yes | Match condition for an entity to be deleted. If specified and a matching entity is not found, an error will be raised. To force an… |
| partitionKey | string | yes | The partition key of the entity. |
| rowKey | string | yes | The row key of the entity. |

### Insert entity in a table.
`POST https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/table-insert-entity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The host name of the tables account, e.g. accountName.table.core.windows.net |
| DataServiceVersion | string | yes | DataServiceVersion header |
| x-ms-version | string | yes | The API version. |
| table | string | yes | The name of the table. |
| timeout | integer | no | The timeout parameter is expressed in seconds. |
| $format | string | no | Specifies the metadata format for the response. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| Prefer | string | no | Specifies whether the response should include the inserted entity in the payload. Possible values are return-no-content and return-content. |
| body | object | no | JSON request body |

### Queries tables under the given account.
`GET https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/table-query` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The host name of the tables account, e.g. accountName.table.core.windows.net |
| DataServiceVersion | string | yes | DataServiceVersion header |
| x-ms-version | string | yes | The API version. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| $format | string | no | Specifies the metadata format for the response. |
| $top | integer | no | Specifies the maximum number of records to return. |
| $select | string | no | Select expression using OData notation. Limits the columns on each record to just those requested. |
| $filter | string | no | OData filter expression. |
| NextTableName | string | no | A table query continuation token from a previous call. |

### Creates a new table under the given account.
`POST https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/table-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The host name of the tables account, e.g. accountName.table.core.windows.net |
| DataServiceVersion | string | yes | DataServiceVersion header |
| x-ms-version | string | yes | The API version. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| $format | string | no | Specifies the metadata format for the response. |
| Prefer | string | no | Specifies whether the response should include the created table in the payload. Possible values are return-no-content and return-content. |
| body | object | yes | JSON request body |

### Deletes an existing table.
`POST https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/table-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The host name of the tables account, e.g. accountName.table.core.windows.net |
| x-ms-version | string | yes | The API version. |
| x-ms-client-request-id | string | no | An opaque, globally-unique, client-generated string identifier for the request. |
| table | string | yes | The name of the table. |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/table-query-entities" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Azure Tables API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:azure-cosmos-db-tables/table-query-entities with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Azure Tables API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Azure Tables itself also needs your own key from azure.com.

### Can AI agents use the Azure Tables API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-cosmos-db-tables.

### What is the status of the Azure Tables API?
Needs your own provider key (bring your own key)
