Update Cells

Updates cell values in a dynamic table.

For common headers and authentication methods, see Access to the API. For sample scenarios, see API usage examples.

Request

POST

https://api.wiki.yandex.net/v1/grids/{idx}/cells

Path parameters

Name

Description

idx

Type: string<uuid4>

Dynamic table UUID. The value of idx is the same as the id field value in the response to POST /v1/grids, or results[].id in the response to GET /v1/pages/{idx}/grids. In /v1/pages/{idx}/grids, idx is the numeric page ID.

Example: ``

Body

application/json

{
  "revision": "example",
  "cells": [
    {
      "row_id": 0,
      "column_slug": "example",
      "value": 0
    }
  ]
}

Name

Description

cells

Type: UpdateCellSchema[]

Cells to update. The list must contain at least one cell.

Example

[
  {
    "row_id": 0,
    "column_slug": "example",
    "value": 0
  }
]

revision

Type: string

The table version on which the change is based. Concurrent changes to the same cell may cause a conflict. Changes to other cells may be merged.

Example: example

UserIdentityExtended

Extended user identifier with additional fields

Name	Description
cloud_uid	Type: string User identifier in Yandex Cloud Example: `example`
uid	Type: string Yandex user ID Example: `example`
username	Type: string User login Example: `example`

Example

{
  "uid": "example",
  "cloud_uid": "example",
  "username": "example"
}

UpdateCellSchema

New value for a dynamic table cell.

Name	Description
column_slug	Type: string The column slug. Example: `example`
row_id	Type: integer The row ID.
value	Any of 6 types Type: integer Type: number Type: boolean Type: string Example: `example` Type: string[] Example `[ "example" ]` Type: UserIdentityExtended[] Example `[ { "uid": "example", "cloud_uid": "example", "username": "example" } ]` The cell value in the format that corresponds to the column type. Example: `0`

Example

{
  "row_id": 0,
  "column_slug": "example",
  "value": 0
}

Responses

200 OK

Body

application/json

{
  "revision": "example",
  "cells": [
    {
      "row_id": "example",
      "column_slug": "example",
      "value": 0
    }
  ]
}

Name

Description

cells

Type: CellSchema[]

Updated cells with their values after processing by the service.

Example

[
  {
    "row_id": "example",
    "column_slug": "example",
    "value": 0
  }
]

revision

Type: string

Table revision after the operation.

Example: example

TicketSchema

Yandex Tracker issue schema

Name

Description

key

Type: string

Issue key (for example, WIKI-123)

Example: example

resolved

Type: boolean

The issue is resolved (closed).

Example

{
  "key": "example",
  "resolved": true
}

UserIdentity

User identifier

Name

Description

cloud_uid

Type: string

User identifier in the cloud

Example: example

uid

Type: string

Yandex user ID

Example: example

Example

{
  "uid": "example",
  "cloud_uid": "example"
}

UserSchema

User information

Name	Description
affiliation	Type: string User affiliation Example: `example`
display_name	Type: string User display name Example: `example`
id	Type: integer Internal user identifier
is_dismissed	Type: boolean The user is dismissed
username	Type: string User login Example: `example`
identity	All of 1 type UserIdentity Type: UserIdentity User identifier Example `{ "uid": "example", "cloud_uid": "example" }` User identifier in the system Example `{ "uid": "example", "cloud_uid": "example" }`

Example

{
  "id": 0,
  "identity": {
    "uid": "example",
    "cloud_uid": "example"
  },
  "username": "example",
  "display_name": "example",
  "is_dismissed": true,
  "affiliation": "example"
}

UnresolvedUserSchema

Schema for a user that was not found in the system

Name

Description

identity

All of 1 type

UserIdentity

Type: UserIdentity

User identifier

Example

{
  "uid": "example",
  "cloud_uid": "example"
}

User ID

Example

{
  "uid": "example",
  "cloud_uid": "example"
}

username

Type: string

User login

Example: example

Example

{
  "username": "example",
  "identity": {
    "uid": "example",
    "cloud_uid": "example"
  }
}

TrackerEnumField

Enum field from Yandex Tracker

Name

Description

display

Type: string

Displayed value of the field

Example: example

key

Type: string

Field value key

Example: example

Example

{
  "display": "example",
  "key": "example"
}

CellSchema

A dynamic table cell.

Name	Description
column_slug	Type: string The column slug. Example: `example`
row_id	Type: string The row ID. Example: `example`
value	Any of 10 types Type: integer Type: number Type: boolean Type: string Example: `example` TicketSchema Type: TicketSchema Yandex Tracker issue schema Example `{ "key": "example", "resolved": true }` Type: string[] Example `[ "example" ]` Type: array Any of 2 types UserSchema Type: UserSchema User information Example `{ "id": 0, "identity": { "uid": "example", "cloud_uid": "example" }, "username": "example", "display_name": "example", "is_dismissed": true, "affiliation": "example" }` UnresolvedUserSchema Type: UnresolvedUserSchema Schema for a user that was not found in the system Example `{ "username": "example", "identity": { "uid": "example", "cloud_uid": "example" } }` Example `[ { "id": 0, "identity": { "uid": "example", "cloud_uid": "example" }, "username": "example", "display_name": "example", "is_dismissed": true, "affiliation": "example" } ]` UserSchema Type: UserSchema User information Example `{ "id": 0, "identity": { "uid": "example", "cloud_uid": "example" }, "username": "example", "display_name": "example", "is_dismissed": true, "affiliation": "example" }` UnresolvedUserSchema Type: UnresolvedUserSchema Schema for a user that was not found in the system Example `{ "username": "example", "identity": { "uid": "example", "cloud_uid": "example" } }` TrackerEnumField Type: TrackerEnumField Enum field from Yandex Tracker Example `{ "display": "example", "key": "example" }` The cell value in the format that corresponds to the column type. Example: `0`

Example

{
  "row_id": "example",
  "column_slug": "example",
  "value": 0
}

Was the article helpful?

Remove Columns

Move Rows