Data Records API: Create, Query, Update, and Delete Records

The Data API is the backbone of your Google workspace, giving you structured access to every record your team creates and manages. From simple documents to richly tagged, field-rich entries, you can query across your entire dataset with powerful filters, sort results by any field, and perform bulk operations to keep large collections in sync. All endpoints are authenticated via Bearer token and return JSON.

List Records

Retrieve a filtered, sorted, and paginated list of records from your workspace. GET https://api.google.com/v1/data

Query Parameters

type

string

Filter records by type (e.g., document, task, note).

status

string

Filter by record status. Common values: active, archived, draft.

page

integer

Page number to retrieve. Defaults to 1.

per_page

integer

default:20

Number of records to return per page. Defaults to 20. Maximum is 100.

sort

string

Field name to sort results by. Common values: created_at, updated_at, name.

order

string

Sort direction. Accepted values: asc, desc. Defaults to asc.

string

Full-text search query. Searches across record names and field values.

Example Request

curl -X GET "https://api.google.com/v1/data?type=document&status=active&sort=created_at&order=desc" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": [
    {
      "id": "rec_abc123",
      "name": "Q1 Report",
      "type": "document",
      "status": "active",
      "fields": {
        "priority": "high",
        "owner": "jane@example.com"
      },
      "tags": ["finance", "quarterly"],
      "created_at": "2024-03-01T09:00:00Z",
      "updated_at": "2024-03-05T14:30:00Z"
    },
    {
      "id": "rec_def456",
      "name": "Product Roadmap",
      "type": "document",
      "status": "active",
      "fields": {
        "priority": "medium",
        "owner": "alex@example.com"
      },
      "tags": ["product", "planning"],
      "created_at": "2024-02-20T11:15:00Z",
      "updated_at": "2024-03-08T10:00:00Z"
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 87 }
}

Get Record

Fetch a single record by its unique ID, including all fields and tags. GET https://api.google.com/v1/data/:id

Path Parameters

string

required

The unique identifier of the record to retrieve (e.g., rec_abc123).

Example Request

curl -X GET "https://api.google.com/v1/data/rec_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "id": "rec_abc123",
    "name": "Q1 Report",
    "type": "document",
    "status": "active",
    "fields": {
      "priority": "high",
      "owner": "jane@example.com"
    },
    "tags": ["finance", "quarterly"],
    "created_at": "2024-03-01T09:00:00Z",
    "updated_at": "2024-03-05T14:30:00Z"
  }
}

Create Record

Add a new record to your workspace. You can include custom key-value fields and any number of tags to keep records organized. POST https://api.google.com/v1/data

Body Parameters

name

string

required

A human-readable name for the record.

type

string

required

The record type (e.g., document, task, note). Used for filtering and categorization.

fields

object

An optional object of custom key-value pairs to attach to the record. Values must be strings.

Example Request

curl -X POST https://api.google.com/v1/data \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q1 Report",
    "type": "document",
    "fields": {
      "status": "draft",
      "priority": "high"
    },
    "tags": ["finance", "quarterly"]
  }'

Example Response

{
  "success": true,
  "data": {
    "id": "rec_abc123",
    "name": "Q1 Report",
    "type": "document",
    "status": "active",
    "fields": {
      "status": "draft",
      "priority": "high"
    },
    "tags": ["finance", "quarterly"],
    "created_at": "2024-06-01T12:00:00Z",
    "updated_at": "2024-06-01T12:00:00Z"
  }
}

Use consistent type values across your workspace to make filtering and reporting more effective. Consider establishing a naming convention for your team before you start creating records at scale.

Update Record

Apply partial updates to an existing record. You only need to include the fields you want to change — any omitted fields retain their current values. PATCH https://api.google.com/v1/data/:id

Path Parameters

string

required

The unique identifier of the record to update.

Body Parameters

name

string

Updated name for the record.

fields

object

Updated custom fields. Provided keys are merged with existing fields; existing keys not mentioned are preserved.

Example Request

curl -X PATCH "https://api.google.com/v1/data/rec_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "status": "final",
      "reviewed_by": "alex@example.com"
    },
    "tags": ["finance", "quarterly", "approved"]
  }'

Example Response

{
  "success": true,
  "data": {
    "id": "rec_abc123",
    "name": "Q1 Report",
    "type": "document",
    "status": "active",
    "fields": {
      "status": "final",
      "priority": "high",
      "reviewed_by": "alex@example.com"
    },
    "tags": ["finance", "quarterly", "approved"],
    "created_at": "2024-03-01T09:00:00Z",
    "updated_at": "2024-06-01T15:45:00Z"
  }
}

Delete Record

Permanently delete a single record from your workspace. DELETE https://api.google.com/v1/data/:id

Record deletion is permanent and cannot be undone. All fields, tags, and associated metadata are immediately removed. If you want to retain the data but remove it from active views, consider setting status to archived via the Update Record endpoint instead.

Path Parameters

string

required

The unique identifier of the record to delete.

Example Request

curl -X DELETE "https://api.google.com/v1/data/rec_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

A successful deletion returns HTTP 204 No Content with an empty body.

Bulk Operations

When you need to create or delete many records at once, bulk endpoints let you perform those operations in a single API call rather than looping through individual requests.

Bulk Create

Create multiple records in one request by sending an array of record objects. The response contains an array of the newly created records in the same order. POST https://api.google.com/v1/data/bulk-create

Example Request

curl -X POST "https://api.google.com/v1/data/bulk-create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {
        "name": "March Expenses",
        "type": "document",
        "fields": { "status": "draft" },
        "tags": ["finance"]
      },
      {
        "name": "April Expenses",
        "type": "document",
        "fields": { "status": "draft" },
        "tags": ["finance"]
      }
    ]
  }'

Example Response

{
  "success": true,
  "data": [
    {
      "id": "rec_ghi789",
      "name": "March Expenses",
      "type": "document",
      "status": "active",
      "fields": { "status": "draft" },
      "tags": ["finance"],
      "created_at": "2024-06-01T16:00:00Z",
      "updated_at": "2024-06-01T16:00:00Z"
    },
    {
      "id": "rec_jkl012",
      "name": "April Expenses",
      "type": "document",
      "status": "active",
      "fields": { "status": "draft" },
      "tags": ["finance"],
      "created_at": "2024-06-01T16:00:00Z",
      "updated_at": "2024-06-01T16:00:00Z"
    }
  ],
  "meta": { "created": 2 }
}

Bulk Delete

Delete multiple records in one request by providing an array of record IDs. DELETE https://api.google.com/v1/data/bulk-delete

Bulk deletion is permanent. All specified records and their associated data will be immediately and irreversibly removed.

Example Request

curl -X DELETE "https://api.google.com/v1/data/bulk-delete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["rec_ghi789", "rec_jkl012", "rec_mno345"]
  }'

Example Response

{
  "success": true,
  "meta": {
    "deleted": 3,
    "failed": 0
  }
}

Error Reference

400 Bad Request

The request body is missing required fields (name or type) or contains invalid values. Check the request structure and try again.

401 Unauthorized

Your API key is missing or invalid. Ensure you include a valid Bearer token in the Authorization header.

404 Not Found

No record exists with the specified id. Verify the ID is correct.

422 Unprocessable Entity

The request is well-formed but contains semantic errors, such as unrecognized field types or empty required values.

429 Too Many Requests

You have exceeded the API rate limit. Wait before retrying. Check the Retry-After response header for the cooldown period.

​List Records

​Query Parameters

​Example Request

​Example Response

​Get Record

​Path Parameters

​Example Request

​Example Response

​Create Record

​Body Parameters

​Example Request

​Example Response

​Update Record

​Path Parameters

​Body Parameters

​Example Request

​Example Response

​Delete Record

​Path Parameters

​Example Request

​Bulk Operations

​Bulk Create

​Example Request

​Example Response

​Bulk Delete

​Example Request

​Example Response

​Error Reference

List Records

Query Parameters

Example Request

Example Response

Get Record

Path Parameters

Example Request

Example Response

Create Record

Body Parameters

Example Request

Example Response

Update Record

Path Parameters

Body Parameters

Example Request

Example Response

Delete Record

Path Parameters

Example Request

Bulk Operations

Bulk Create

Example Request

Example Response

Bulk Delete

Example Request

Example Response

Error Reference