getTableRow

Fetches a specific row from a table using the row's unique identifier.

GET/v1/tables/{table}/row

Authorization

AuthorizationBearerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Header parameters

x-bot-idstringrequired

Bot id

x-integration-idstring

Integration id

x-integration-aliasstring

Integration alias

x-integration-namestring

Integration name

x-user-idstring

User Id

x-user-rolestring

User Role

Path parameters

tablestringrequired

The table's name or unique identifier for targeting specific table operations.

Query parameters

idintegerrequired

Identifier of the row within the table.

Response

application/json

The requested row object.

The response is of type getTableRowResponse · object.

rowobjectrequired

Request

curl --request GET \ \
  --url https://api.botpress.cloud/v1/tables/{table}/row \
  --header 'x-bot-id: <x-bot-id>' \
  --header 'Authorization: Bearer <token>'

Response

{
  "row": {
    "id": 0,
    "createdAt": "2025-01-15T12:00:00Z",
    "updatedAt": "2025-01-15T12:00:00Z",
    "computed": {
      "key": {
        "status": "string",
        "error": "string",
        "updatedBy": "string",
        "updatedAt": "string"
      }
    },
    "stale": [
      "string"
    ],
    "similarity": 0
  }
}