Data Structure Notes

Create structure note by external data structure id

post

Creates a structure note for the specified external data structure ID.

Body

application/json

Responses

201

Structure note created

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post/api/data_structure_notes

HTTPcURLJavaScriptPython

POST /api/data_structure_notes HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "structure_note": {
    "data_structure_external_id": "ds_customer_email",
    "df_content": {
      "field_name": "value"
    }
  }
}

{
  "_actions": {
    "draft": {
      "href": "/api/data_structures/123/notes",
      "input": {
        "df_content": {}
      },
      "method": "POST"
    }
  },
  "data": {
    "data_structure_id": 123,
    "df_content": {
      "field_name": "value"
    },
    "id": 1,
    "status": "published",
    "updated_at": "2026-06-18T10:00:00Z",
    "version": 2
  }
}

Get note suggestions

get

Returns AI-generated note suggestions for the specified data structure.

Path parameters

data_structure_idintegerRequired

Data structure ID

Query parameters

languagestringOptional

Language for suggestions (e.g., 'en', 'es')

Responses

200

Suggestions

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

get/api/data_structures/{data_structure_id}/note_suggestions

HTTPcURLJavaScriptPython

GET /api/data_structures/{data_structure_id}/note_suggestions HTTP/1.1
Accept: */*

{
  "data": {
    "field_name": [
      "suggestion1",
      "suggestion2"
    ]
  }
}

Search structure notes

post

Searches structure notes using the provided filters and returns matching results.

Body

application/json

data_structure_idinteger · nullableOptional

Filter by data structure ID

querystring · nullableOptional

Search query text

sizeinteger · min: 1 · max: 100 · nullableOptional

Number of results per page

statusstring · enum · nullableOptional

Filter by status

Possible values:

system_idinteger · nullableOptional

Filter by system ID

untilstring · nullableOptional

Filter by update timestamp (upper bound)

updated_atstring · nullableOptional

Filter by update timestamp

Responses

200

Structure note search response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

post/api/data_structure_notes/search

HTTPcURLJavaScriptPython

POST /api/data_structure_notes/search HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "query": "customer",
  "size": 20,
  "status": "published"
}

{
  "data": [
    {
      "data_structure_external_id": "ds_customer_email",
      "data_structure_id": 123,
      "df_content": {
        "field_name": "value"
      },
      "id": 1,
      "status": "published",
      "updated_at": "2026-06-18T10:00:00Z",
      "version": 2
    }
  ]
}

List structure notes

get

Lists all structure notes for the specified data structure and includes available actions for the current user.

Path parameters

data_structure_idintegerRequired

Data structure ID

Responses

200

Structure notes

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

get/api/data_structures/{data_structure_id}/notes

HTTPcURLJavaScriptPython

GET /api/data_structures/{data_structure_id}/notes HTTP/1.1
Accept: */*

{
  "_actions": {
    "draft": {
      "href": "/api/data_structures/123/notes",
      "input": {
        "df_content": {}
      },
      "method": "POST"
    }
  },
  "data": [
    {
      "data_structure_id": 123,
      "df_content": {
        "field_name": "value"
      },
      "id": 1,
      "status": "published",
      "updated_at": "2026-06-18T10:00:00Z",
      "version": 2
    }
  ]
}

Create structure note

post

Creates a new structure note for the specified data structure.

Path parameters

data_structure_idintegerRequired

Data structure ID

Body

application/json

Responses

201

Structure note

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post/api/data_structures/{data_structure_id}/notes

HTTPcURLJavaScriptPython

POST /api/data_structures/{data_structure_id}/notes HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "structure_note": {
    "df_content": {
      "field_name": "value"
    }
  }
}

{
  "_actions": {
    "draft": {
      "href": "/api/data_structures/123/notes",
      "input": {
        "df_content": {}
      },
      "method": "POST"
    }
  },
  "data": {
    "data_structure_id": 123,
    "df_content": {
      "field_name": "value"
    },
    "id": 1,
    "status": "published",
    "updated_at": "2026-06-18T10:00:00Z",
    "version": 2
  }
}

Show structure note

get

Retrieves the specified structure note and returns its details.

Path parameters

data_structure_idintegerRequired

Data structure ID

idintegerRequired

Structure note ID

Responses

200

Structure note

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

get/api/data_structures/{data_structure_id}/notes/{id}

HTTPcURLJavaScriptPython

GET /api/data_structures/{data_structure_id}/notes/{id} HTTP/1.1
Accept: */*

{
  "_actions": {
    "draft": {
      "href": "/api/data_structures/123/notes",
      "input": {
        "df_content": {}
      },
      "method": "POST"
    }
  },
  "data": {
    "data_structure_id": 123,
    "df_content": {
      "field_name": "value"
    },
    "id": 1,
    "status": "published",
    "updated_at": "2026-06-18T10:00:00Z",
    "version": 2
  }
}

Update structure note

put

Updates the specified structure note with the provided payload.

Path parameters

data_structure_idintegerRequired

Data structure ID

idintegerRequired

Structure note ID

Body

application/json

Responses

200

Structure note updated

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

put/api/data_structures/{data_structure_id}/notes/{id}

HTTPcURLJavaScriptPython

PUT /api/data_structures/{data_structure_id}/notes/{id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "structure_note": {
    "df_content": {
      "field_name": "updated_value"
    },
    "status": "published"
  }
}

{
  "_actions": {
    "draft": {
      "href": "/api/data_structures/123/notes",
      "input": {
        "df_content": {}
      },
      "method": "POST"
    }
  },
  "data": {
    "data_structure_id": 123,
    "df_content": {
      "field_name": "value"
    },
    "id": 1,
    "status": "published",
    "updated_at": "2026-06-18T10:00:00Z",
    "version": 2
  }
}

Delete structure note

delete

Deletes the specified structure note.

Path parameters

data_structure_idintegerRequired

Data structure ID

idintegerRequired

Structure note ID

Responses

204

Structure note deleted

No content

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

delete/api/data_structures/{data_structure_id}/notes/{id}

HTTPcURLJavaScriptPython

DELETE /api/data_structures/{data_structure_id}/notes/{id} HTTP/1.1
Accept: */*

No content

Update structure note

patch

Updates the specified structure note with the provided payload.

Path parameters

data_structure_idintegerRequired

Data structure ID

idintegerRequired

Structure note ID

Body

application/json

Responses

200

Structure note updated

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

patch/api/data_structures/{data_structure_id}/notes/{id}

HTTPcURLJavaScriptPython

PATCH /api/data_structures/{data_structure_id}/notes/{id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "structure_note": {
    "df_content": {
      "field_name": "updated_value"
    },
    "status": "published"
  }
}

{
  "_actions": {
    "draft": {
      "href": "/api/data_structures/123/notes",
      "input": {
        "df_content": {}
      },
      "method": "POST"
    }
  },
  "data": {
    "data_structure_id": 123,
    "df_content": {
      "field_name": "value"
    },
    "id": 1,
    "status": "published",
    "updated_at": "2026-06-18T10:00:00Z",
    "version": 2
  }
}