> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kaydı Güncelleme

### Yol

PATCH /api/table/\{tableId}/record/\{recordId}

### İstek

#### Yol Parametreleri

* tableId (string): Tablonun benzersiz tanımlayıcısı [(nasıl alınır)](/tr/api-doc/get-id#tableid).
* recordId (string): Güncellenecek Kaydın benzersiz tanımlayıcısı [(nasıl alınır)](/tr/api-doc/get-id#recordid).

#### İstek Gövdesi

* **record (zorunlu)**
  * Açıklama: Güncellenecek Kayıt verileri
  * Tür: Nesne
  * Örnek:
    ```json theme={null}
    {
      "fields": {
        "Name": "John Doe",
        "Age": 31,
        "Email": "john.doe@example.com"
      }
    }
    ```
  * Not: `fields` nesnesi, Alan adlarını ve bunlara karşılık gelen yeni değerleri içerir. Her Alan türünün değer yapısı farklıdır; ayrıntılar için [Kayıt Alanı Değeri Türleri](/tr/api-doc/record/interface) sayfasına bakın.

Bir Alanın değerini temizlemek için açıkça `null` iletin. Bir Alan adı dahil edilmezse söz konusu Alan güncellenmez.

* **fieldKeyType (isteğe bağlı)**
  * Açıklama: Alan anahtarının türünü belirtir
  * Tür: Dize
  * Olası değerler:
    * "name": Alan adını anahtar olarak kullanır
    * "id": Alan kimliğini anahtar olarak kullanır
    * "dbFieldName": Alanın dbFieldName değerini anahtar olarak kullanır
  * Örnek: `"name"` veya `"id"` ya da `"dbFieldName"`
  * Not: Belirtilmezse varsayılan olarak Alan adı anahtar olarak kullanılır.
  * Kullanım:
    * "name" olarak ayarlandığında:
      ```json theme={null}
      {
        "fields": {
          "Name": "John Doe",
          "Age": 30
        }
      }
      ```
    * "id" olarak ayarlandığında:
      ```json theme={null}
      {
        "fields": {
          "fldABCDEFGHIJKLMN": "John Doe",
          "fldOPQRSTUVWXYZ12": 30
        }
      }
      ```
* **typecast (isteğe bağlı)**
  * Açıklama: Alan değeri türlerinin otomatik olarak dönüştürülüp dönüştürülmeyeceğini belirler. Varsayılan olarak katı doğrulama uygulanır ve giriş değerlerinin geçerli Alanın veri türüyle eşleşmesi gerekir. Etkinleştirilirse sistem otomatik dönüştürmeyi dener.
  * Tür: Boolean
  * Olası değerler: true veya false
  * Örnek: `true`
  * Not: true olarak ayarlanırsa sistem, giriş değerlerini doğru Alan değeri türüne dönüştürmeyi dener.
  * Kullanım örnekleri:
    * Bağlantı Alanı: Bağlantı kurmak için birincil anahtar metni doğrudan kullanılabilir
      ```json theme={null}
      {
        "User table": "John Smith"
      }
      ```
    * Tarih Alanı: Standart olmayan biçimdeki tarih dizeleri kullanılabilir
      ```json theme={null}
      {
        "Date": "2023-05-15"
      }
      ```
    * Kullanıcı Alanı: Kullanıcı adı doğrudan kullanılabilir
      ```json theme={null}
      {
        "Assigned To": "John Doe"
      }
      ```

Ek Alanlarına yeni dosyalar yüklemek için [Ek Yükleme](/tr/api-doc/record/upload-attachment) bölümüne bakın.

* **order (isteğe bağlı)**
  * Açıklama: Kayıt güncellendikten sonra onu belirtilen bir Görünümdeki belirli bir konuma taşır.
  * Tür: Nesne
  * Özellikler:
    * viewId: Görünüm kimliği
    * anchorId: Referans Kayıt kimliği
    * position: Referans Kayda göre konum. Olası değerler: `"before"` veya `"after"`
  * Örnek:
    ```json theme={null}
    {
      "viewId": "viwABCDEFGHIJKLMN",
      "anchorId": "rec123456789ABCDE",
      "position": "after"
    }
    ```

### Yanıt

#### Başarılı Yanıt

* Durum kodu: 200 OK
* Yanıt gövdesi: Güncellenmiş Kayıt verilerini döndürür.

**Örnek Yanıt Gövdesi**

```json theme={null}
{
    "id": "rec123456789ABCDE",
    "fields": {
        "Name": "John Doe",
        "Age": 31,
        "Email": "john.doe@example.com"
    }
}
```

#### Hata Yanıtları

* Durum kodu: 400 Bad Request: İstek gövdesi biçim hatası veya zorunlu Alanlar eksik.
* Durum kodu: 404 Not Found: Belirtilen tableId veya recordId mevcut değil.

#### Örnek Kod

<CodeGroup>
  ```bash CURL theme={null}
  curl -X PATCH 'https://app.teable.ai/api/table/__tableId__/record/__recordId__' \
    -H 'Authorization: Bearer __token__' \
    -H 'Content-Type: application/json' \
    -d '{
      "record": {
        "fields": {
          "Name": "John Doe",
          "Age": 31
        }
      }
    }'
  ```

  ```js JS SDK theme={null}
  import { configApi, updateRecord } from '@teable/openapi';

  configApi({
    endpoint: 'https://app.teable.ai',
    token,
  });

  const response = await updateRecord('__tableId__', '__recordId__', {
    record: {
      fields: {
        Name: 'John Doe',
        Age: 31
      }
    }
  });

  console.log(response.data);
  ```

  ```ts TypeScript theme={null}
  const response = await fetch('https://app.teable.ai/api/table/__tableId__/record/__recordId__', {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer __token__',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      record: {
        fields: {
          Name: 'John Doe',
          Age: 31
        }
      }
    })
  });

  console.log(await response.json());
  ```

  ```python Python theme={null}
  import requests

  response = requests.patch(
      'https://app.teable.ai/api/table/__tableId__/record/__recordId__',
      headers={
          'Authorization': 'Bearer __token__',
          'Content-Type': 'application/json'
      },
      json={
          'record': {
              'fields': {
                  'Name': 'John Doe',
                  'Age': 31
              }
          }
      }
  )

  print(response.json())
  ```
</CodeGroup>