projects

List Project Databases

Changed on

List databases available to a project (owned + shared + company-visible).

The third branch — a company-level dataset (project_id IS NULL) whose source_kind is in COMPANY_VISIBLE_SOURCE_KINDS, today the platform-maintained Users / User Groups directory datasets — is grant-gated, so this endpoint filters it per caller. Project VIEWER on the project is NOT enough to see one: the directory datasets are authorized by explicit per-user grant (domains/attribute_sync/CLAUDE.md), and this listing feeds the step editor's dataset picker, so an ungated row here would advertise the company's member emails and attribute values to every project member.

get/api/v1/projects/{project_id}/databases

Request

  • Base URL
    https://api.netter.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.netter.ai/api/v1/projects/{project_id}/databases
  • Auth
    none declared

Path parameters

project_idstring uuid required

Response

Successful Response

idstring uuid required
company_idstring uuid required
project_idstring uuid nullable
integration_idstring uuid nullable
user_idstring uuid required
namestring required
descriptionstring required
table_namestring required
storage_pathstring nullable required
schema_infoobject[] required
key_columnsstring[]
source_step_idstring uuid nullable
source_user_file_idstring uuid nullable
source_automation_idstring uuid nullable
source_sheet_namestring nullable
source_kindstring
is_sharedboolean required
is_suppressedboolean required
refresh_statusstring required
refresh_errorstring nullable
last_refreshed_atstring date-time nullable required
name_is_user_overriddenboolean
row_countinteger required
size_bytesinteger required
created_atstring date-time required
updated_atstring date-time required
doc_statusstring
doc_status_updated_atstring date-time nullable
doc_last_errorstring nullable

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status