Menu
GETPOST data-studio/datatables/ User APIService tier

GET / POST datatables: workspace-nested or flat (backward compat).

URL

  • User APIhttps://automations.mattering.io/api/user/v1/data-studio/datatables/
  • Service tierhttps://automations.mattering.io/api/internal/data-studio/datatables/

Query parameters

NameDefault
statusactive
workspace_idnone

Body keys (JSON)

KeyRequiredDefault
descriptionoptional or conditionalnone
fieldsoptional or conditionalnone
nameoptional or conditionalnone

Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.

Responses

200 bare JSON object (no envelope)

{
  "results": [
    {
      "id": "...",
      "workspace_id": "...",
      "name": "...",
      "description": "...",
      "status": "...",
      "fields": [
        {
          "id": "...",
          "name": "...",
          "field_type": "...",
          "required": true,
          "default_value": "...",
          "description": "...",
          "order": 0,
          "related_datatable_id": "..."
        }
      ],
      "created_by_user_id": "...",
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-01T00:00:00Z"
    }
  ],
  "count": 0
}

201 bare JSON object (no envelope)

{
  "id": "...",
  "workspace_id": "...",
  "name": "...",
  "description": "...",
  "status": "...",
  "fields": [
    {
      "id": "...",
      "name": "...",
      "field_type": "...",
      "required": true,
      "default_value": "...",
      "description": "...",
      "order": 0,
      "related_datatable_id": "..."
    }
  ],
  "created_by_user_id": "...",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400'fields' must be a list. message
400'name' is required. message
400Request body must be a JSON object. message
401unauthorized

Example

curl -X POST "https://automations.mattering.io/api/user/v1/data-studio/datatables/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "...",
  "fields": "...",
  "name": "..."
}'

Source: AutomationsCore/data_studio/views.py (views.datatable_list_or_create)

GETPATCHDELETE data-studio/datatables/{datatable_id}/ User APIService tier

GET / PATCH / DELETE datatable: workspace-nested or flat.

URL

  • User APIhttps://automations.mattering.io/api/user/v1/data-studio/datatables/{datatable_id}/
  • Service tierhttps://automations.mattering.io/api/internal/data-studio/datatables/{datatable_id}/

Path parameters

NameType
datatable_iduuid

Body keys (JSON)

KeyRequiredDefault
descriptionoptional or conditionalnone
fieldsoptional or conditionalnone
nameoptional or conditionalnone
statusoptional or conditionalnone
workspace_idoptional or conditionalnone

Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.

Responses

200 bare JSON object (no envelope)

{
  "id": "...",
  "workspace_id": "...",
  "name": "...",
  "description": "...",
  "status": "...",
  "fields": [
    {
      "id": "...",
      "name": "...",
      "field_type": "...",
      "required": true,
      "default_value": "...",
      "description": "...",
      "order": 0,
      "related_datatable_id": "..."
    }
  ],
  "created_by_user_id": "...",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

204 non-JSON body

binary or text body

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400'fields' must be a list. message
400'name' cannot be empty. message
400'status' must be 'active' or 'archived'. message
400Request body must be a JSON object. message
400Workspace belongs to a different organization. message
401unauthorized

Example

curl -X PATCH "https://automations.mattering.io/api/user/v1/data-studio/datatables/DATATABLE_ID/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "...",
  "fields": "...",
  "name": "...",
  "status": "...",
  "workspace_id": "..."
}'

Source: AutomationsCore/data_studio/views.py (views.datatable_detail)

GETPOST data-studio/datatables/{datatable_id}/entries/ User APIService tier

GET / POST entries: workspace-nested or flat.

URL

  • User APIhttps://automations.mattering.io/api/user/v1/data-studio/datatables/{datatable_id}/entries/
  • Service tierhttps://automations.mattering.io/api/internal/data-studio/datatables/{datatable_id}/entries/

Path parameters

NameType
datatable_iduuid

Query parameters

NameDefault
filtersnone
page1
page_sizenone
sort_bynone
sort_orderdesc

Body keys (JSON)

KeyRequiredDefault
agent_execution_idoptional or conditionalnone
dataoptional or conditionalnone
execution_idoptional or conditionalnone

Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.

Responses

200 bare JSON object (no envelope)

{
  "results": [
    {
      "id": "...",
      "datatable_id": "...",
      "data": {
        "...": "..."
      },
      "created_by_execution": "...",
      "created_by_agent": "...",
      "created_by_user_id": "...",
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-01T00:00:00Z"
    }
  ],
  "count": 0,
  "pagination": "..."
}

201 bare JSON object (no envelope)

{
  "id": "...",
  "datatable_id": "...",
  "data": {
    "...": "..."
  },
  "created_by_execution": "...",
  "created_by_agent": "...",
  "created_by_user_id": "...",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400'data' must be a JSON object. message
400Request body must be a JSON object. message
401unauthorized

Example

curl -X POST "https://automations.mattering.io/api/user/v1/data-studio/datatables/DATATABLE_ID/entries/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "agent_execution_id": "...",
  "data": "...",
  "execution_id": "..."
}'

Source: AutomationsCore/data_studio/views.py (views.entry_list_or_create)

POST data-studio/datatables/{datatable_id}/entries/bulk/ User APIService tier

POST: bulk-insert entries into a datatable.

Body: {"entries": [{"data": {...}}, ...]}

Validates each row against the schema, skips invalid ones, and inserts valid rows in batches using bulk_create. Returns counts and per-row errors. Max 10,000 entries per call.

This read is not paginated. It returns at most 100 rows and does not report a total, so a result of exactly 100 may be truncated.

URL

  • User APIhttps://automations.mattering.io/api/user/v1/data-studio/datatables/{datatable_id}/entries/bulk/
  • Service tierhttps://automations.mattering.io/api/internal/data-studio/datatables/{datatable_id}/entries/bulk/

Path parameters

NameType
datatable_iduuid

Body keys (JSON)

KeyRequiredDefault
entriesoptional or conditionalnone

Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.

Responses

200 bare JSON object (no envelope)

{
  "created": 0,
  "error_count": 0,
  "errors": "..."
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400Request body must be a JSON object. message
400ValidationError message
401unauthorized

Example

curl -X POST "https://automations.mattering.io/api/user/v1/data-studio/datatables/DATATABLE_ID/entries/bulk/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "entries": "..."
}'

Source: AutomationsCore/data_studio/views.py (views.entry_bulk_create)

GETPATCHDELETE data-studio/entries/{entry_id}/ User APIService tier

GET / PATCH / DELETE /api/internal/data-studio/entries/<entry_id>/

URL

  • User APIhttps://automations.mattering.io/api/user/v1/data-studio/entries/{entry_id}/
  • Service tierhttps://automations.mattering.io/api/internal/data-studio/entries/{entry_id}/

Path parameters

NameType
entry_iduuid

Body keys (JSON)

KeyRequiredDefault
dataoptional or conditionalnone

Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.

Responses

200 bare JSON object (no envelope)

{
  "id": "...",
  "datatable_id": "...",
  "data": {
    "...": "..."
  },
  "created_by_execution": "...",
  "created_by_agent": "...",
  "created_by_user_id": "...",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

204 non-JSON body

binary or text body

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400'data' must be a JSON object. message
400Request body must be a JSON object. message
401unauthorized

Example

curl -X PATCH "https://automations.mattering.io/api/user/v1/data-studio/entries/ENTRY_ID/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "data": "..."
}'

Source: AutomationsCore/data_studio/views.py (views.entry_detail)

GETPOST workspaces/{workspace_id}/datatables/ User APIService tier

GET / POST datatables: workspace-nested or flat (backward compat).

URL

  • User APIhttps://automations.mattering.io/api/user/v1/workspaces/{workspace_id}/datatables/
  • Service tierhttps://automations.mattering.io/api/internal/workspaces/{workspace_id}/datatables/

Path parameters

NameType
workspace_idstr

Query parameters

NameDefault
statusactive
workspace_idnone

Body keys (JSON)

KeyRequiredDefault
descriptionoptional or conditionalnone
fieldsoptional or conditionalnone
nameoptional or conditionalnone

Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.

Responses

200 bare JSON object (no envelope)

{
  "results": [
    {
      "id": "...",
      "workspace_id": "...",
      "name": "...",
      "description": "...",
      "status": "...",
      "fields": [
        {
          "id": "...",
          "name": "...",
          "field_type": "...",
          "required": true,
          "default_value": "...",
          "description": "...",
          "order": 0,
          "related_datatable_id": "..."
        }
      ],
      "created_by_user_id": "...",
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-01T00:00:00Z"
    }
  ],
  "count": 0
}

201 bare JSON object (no envelope)

{
  "id": "...",
  "workspace_id": "...",
  "name": "...",
  "description": "...",
  "status": "...",
  "fields": [
    {
      "id": "...",
      "name": "...",
      "field_type": "...",
      "required": true,
      "default_value": "...",
      "description": "...",
      "order": 0,
      "related_datatable_id": "..."
    }
  ],
  "created_by_user_id": "...",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400'fields' must be a list. message
400'name' is required. message
400Request body must be a JSON object. message
401unauthorized

Example

curl -X POST "https://automations.mattering.io/api/user/v1/workspaces/WORKSPACE_ID/datatables/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "...",
  "fields": "...",
  "name": "..."
}'

Source: AutomationsCore/data_studio/views.py (views.datatable_list_or_create)

GETPATCHDELETE workspaces/{workspace_id}/datatables/{datatable_id}/ User APIService tier

GET / PATCH / DELETE datatable: workspace-nested or flat.

URL

  • User APIhttps://automations.mattering.io/api/user/v1/workspaces/{workspace_id}/datatables/{datatable_id}/
  • Service tierhttps://automations.mattering.io/api/internal/workspaces/{workspace_id}/datatables/{datatable_id}/

Path parameters

NameType
workspace_idstr
datatable_iduuid

Body keys (JSON)

KeyRequiredDefault
descriptionoptional or conditionalnone
fieldsoptional or conditionalnone
nameoptional or conditionalnone
statusoptional or conditionalnone
workspace_idoptional or conditionalnone

Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.

Responses

200 bare JSON object (no envelope)

{
  "id": "...",
  "workspace_id": "...",
  "name": "...",
  "description": "...",
  "status": "...",
  "fields": [
    {
      "id": "...",
      "name": "...",
      "field_type": "...",
      "required": true,
      "default_value": "...",
      "description": "...",
      "order": 0,
      "related_datatable_id": "..."
    }
  ],
  "created_by_user_id": "...",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

204 non-JSON body

binary or text body

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400'fields' must be a list. message
400'name' cannot be empty. message
400'status' must be 'active' or 'archived'. message
400Request body must be a JSON object. message
400Workspace belongs to a different organization. message
401unauthorized

Example

curl -X PATCH "https://automations.mattering.io/api/user/v1/workspaces/WORKSPACE_ID/datatables/DATATABLE_ID/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "...",
  "fields": "...",
  "name": "...",
  "status": "...",
  "workspace_id": "..."
}'

Source: AutomationsCore/data_studio/views.py (views.datatable_detail)

GETPOST workspaces/{workspace_id}/datatables/{datatable_id}/entries/ User APIService tier

GET / POST entries: workspace-nested or flat.

URL

  • User APIhttps://automations.mattering.io/api/user/v1/workspaces/{workspace_id}/datatables/{datatable_id}/entries/
  • Service tierhttps://automations.mattering.io/api/internal/workspaces/{workspace_id}/datatables/{datatable_id}/entries/

Path parameters

NameType
workspace_idstr
datatable_iduuid

Query parameters

NameDefault
filtersnone
page1
page_sizenone
sort_bynone
sort_orderdesc

Body keys (JSON)

KeyRequiredDefault
agent_execution_idoptional or conditionalnone
dataoptional or conditionalnone
execution_idoptional or conditionalnone

Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.

Responses

200 bare JSON object (no envelope)

{
  "results": [
    {
      "id": "...",
      "datatable_id": "...",
      "data": {
        "...": "..."
      },
      "created_by_execution": "...",
      "created_by_agent": "...",
      "created_by_user_id": "...",
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-01T00:00:00Z"
    }
  ],
  "count": 0,
  "pagination": "..."
}

201 bare JSON object (no envelope)

{
  "id": "...",
  "datatable_id": "...",
  "data": {
    "...": "..."
  },
  "created_by_execution": "...",
  "created_by_agent": "...",
  "created_by_user_id": "...",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400'data' must be a JSON object. message
400Request body must be a JSON object. message
401unauthorized

Example

curl -X POST "https://automations.mattering.io/api/user/v1/workspaces/WORKSPACE_ID/datatables/DATATABLE_ID/entries/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "agent_execution_id": "...",
  "data": "...",
  "execution_id": "..."
}'

Source: AutomationsCore/data_studio/views.py (views.entry_list_or_create)

All Automations resources
Start Free Explore our Products