> For the complete documentation index, see [llms.txt](https://kilavuz.cubicl.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kilavuz.cubicl.io/api-entegrasyonu/dosyalar.md).

# Dosyalar

Bu doküman aşağıdaki uç noktalarını içerir:\
\
1\. Dosyaları uygulamanın farklı bölümlerine yükleme — **Dosya yükle**\
2\. Projelerde dosyalar özelliği\
\
Yükleme ve indirme\
\
Dosyalar görevlere, görev aktivitelerine, sohbet mesajlarına, müşterilere ve dosyalar sayfasına yüklenebilir. Önce **Dosya yükle** ile dosyayı yükleyin; sunucu dosya ID'sini döner. Bu ID'yi diğer uç noktalarda kullanın.\
\
Dosya sayfası uç noktaları\
\
Bu uç noktalar, bir projenin ve bir müşterinin Dosyalar sayfasındaki dosya ve klasörleri görüntülemenize, oluşturmanıza, düzenlemenize ve silmenize olanak tanır.\
\
Dosyalar sayfasının yapısı bir bilgisayardaki veya Google Drive gibi diğer dosya depolama hizmetlerindeki dosya sistemine benzer. İç içe geçmiş dosya ve dizin düğümlerinden oluşur. En üstte bir kök dizin düğümü bulunur. Dizinler alt dosya ve dizin düğümlerini tutar. Dosya düğümleri, **Dosya yükle** uç noktasından dönen dosya kaydıyla aynı değildir. Dosya düğümü kayıtları, dosya kayıtlarına işaret eder.

## Dosya yükle

> Dosya yükler ve kaydı döner. \`multipart/form-data\`. En fazla 4 GB.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Dosyalar","description":"Bu doküman aşağıdaki uç noktalarını içerir:<br><br>1. Dosyaları uygulamanın farklı bölümlerine yükleme — **Dosya yükle**<br>2. Projelerde dosyalar özelliği<br><br>Yükleme ve indirme<br><br>Dosyalar görevlere, görev aktivitelerine, sohbet mesajlarına, müşterilere ve dosyalar sayfasına yüklenebilir. Önce **Dosya yükle** ile dosyayı yükleyin; sunucu dosya ID'sini döner. Bu ID'yi diğer uç noktalarda kullanın.<br><br>Dosya sayfası uç noktaları<br><br>Bu uç noktalar, bir projenin ve bir müşterinin Dosyalar sayfasındaki dosya ve klasörleri görüntülemenize, oluşturmanıza, düzenlemenize ve silmenize olanak tanır.<br><br>Dosyalar sayfasının yapısı bir bilgisayardaki veya Google Drive gibi diğer dosya depolama hizmetlerindeki dosya sistemine benzer. İç içe geçmiş dosya ve dizin düğümlerinden oluşur. En üstte bir kök dizin düğümü bulunur. Dizinler alt dosya ve dizin düğümlerini tutar. Dosya düğümleri, **Dosya yükle** uç noktasından dönen dosya kaydıyla aynı değildir. Dosya düğümü kayıtları, dosya kayıtlarına işaret eder."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"FileUploadRequest":{"type":"object","properties":{"file":{"type":"string","format":"binary","description":"Dosya içeriği ve dosya adı"}}},"File":{"type":"object","properties":{"_id":{"type":"string"},"name":{"type":"string"},"thumbnail":{"type":"string"},"google":{"type":"object","properties":{"id":{"type":"string"},"extension":{"type":"string"},"webViewLink":{"type":"string"},"mimeType":{"type":"string"}}},"dropbox":{"type":"object","properties":{"id":{"type":"string"},"webViewLink":{"type":"string"}}}}},"UploadFile403Response":{"type":"object","properties":{"code":{"type":"integer"},"totalCapacity":{"type":"number","description":"Bayt"},"totalSize":{"type":"number","description":"Bayt"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/files/upload":{"post":{"tags":["Dosyalar"],"summary":"Dosya yükle","description":"Dosya yükler ve kaydı döner. `multipart/form-data`. En fazla 4 GB.","operationId":"uploadFile","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/FileUploadRequest"}}}},"responses":{"200":{"description":"Dosya ayrıntıları","content":{"application/json":{"schema":{"$ref":"#/components/schemas/File"}}}},"400":{"description":"Geçersiz istek"},"403":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadFile403Response"}}}},"422":{"$ref":"#/components/responses/ValidationFailed"}}}}}}
```

## İndirme bağlantısı al

> Cubicl'e yüklenen dosyalara izinsiz erişim sağlanamaz. Bir dosyayı indirmek için bir indirme bağlantısı istemeniz gerekir. Ardından, dosyayı indirmek için döndürülen bağlantıya bir HTTP isteği gönderebilirsiniz. Linklerin süresi 5 dakikadır. Bundan sonra başka bir bağlantı almanız gerekir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Dosyalar","description":"Bu doküman aşağıdaki uç noktalarını içerir:<br><br>1. Dosyaları uygulamanın farklı bölümlerine yükleme — **Dosya yükle**<br>2. Projelerde dosyalar özelliği<br><br>Yükleme ve indirme<br><br>Dosyalar görevlere, görev aktivitelerine, sohbet mesajlarına, müşterilere ve dosyalar sayfasına yüklenebilir. Önce **Dosya yükle** ile dosyayı yükleyin; sunucu dosya ID'sini döner. Bu ID'yi diğer uç noktalarda kullanın.<br><br>Dosya sayfası uç noktaları<br><br>Bu uç noktalar, bir projenin ve bir müşterinin Dosyalar sayfasındaki dosya ve klasörleri görüntülemenize, oluşturmanıza, düzenlemenize ve silmenize olanak tanır.<br><br>Dosyalar sayfasının yapısı bir bilgisayardaki veya Google Drive gibi diğer dosya depolama hizmetlerindeki dosya sistemine benzer. İç içe geçmiş dosya ve dizin düğümlerinden oluşur. En üstte bir kök dizin düğümü bulunur. Dizinler alt dosya ve dizin düğümlerini tutar. Dosya düğümleri, **Dosya yükle** uç noktasından dönen dosya kaydıyla aynı değildir. Dosya düğümü kayıtları, dosya kayıtlarına işaret eder."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"parameters":{"IdPath":{"name":"id","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ObjectId"},"description":"Kayıt ID'si"}},"schemas":{"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"ErrorCodeMessage":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."},"message":{"type":"string"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/files/{id}/url":{"get":{"tags":["Dosyalar"],"summary":"İndirme bağlantısı al","description":"Cubicl'e yüklenen dosyalara izinsiz erişim sağlanamaz. Bir dosyayı indirmek için bir indirme bağlantısı istemeniz gerekir. Ardından, dosyayı indirmek için döndürülen bağlantıya bir HTTP isteği gönderebilirsiniz. Linklerin süresi 5 dakikadır. Bundan sonra başka bir bağlantı almanız gerekir.","operationId":"getFileDownloadUrl","parameters":[{"$ref":"#/components/parameters/IdPath"}],"responses":{"200":{"description":"İndirme URL'si","content":{"application/json":{"schema":{"type":"string"}}}},"404":{"description":"Kaynak bulunamadı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCodeMessage"}}}},"422":{"$ref":"#/components/responses/ValidationFailed"}}}}}}
```

## Düğümleri getir

> Bir dizindeki dosya ve dizin düğümlerini alır. İstek, \`group\` veya \`customer\` parametreleri ile gönderilmelidir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Dosyalar","description":"Bu doküman aşağıdaki uç noktalarını içerir:<br><br>1. Dosyaları uygulamanın farklı bölümlerine yükleme — **Dosya yükle**<br>2. Projelerde dosyalar özelliği<br><br>Yükleme ve indirme<br><br>Dosyalar görevlere, görev aktivitelerine, sohbet mesajlarına, müşterilere ve dosyalar sayfasına yüklenebilir. Önce **Dosya yükle** ile dosyayı yükleyin; sunucu dosya ID'sini döner. Bu ID'yi diğer uç noktalarda kullanın.<br><br>Dosya sayfası uç noktaları<br><br>Bu uç noktalar, bir projenin ve bir müşterinin Dosyalar sayfasındaki dosya ve klasörleri görüntülemenize, oluşturmanıza, düzenlemenize ve silmenize olanak tanır.<br><br>Dosyalar sayfasının yapısı bir bilgisayardaki veya Google Drive gibi diğer dosya depolama hizmetlerindeki dosya sistemine benzer. İç içe geçmiş dosya ve dizin düğümlerinden oluşur. En üstte bir kök dizin düğümü bulunur. Dizinler alt dosya ve dizin düğümlerini tutar. Dosya düğümleri, **Dosya yükle** uç noktasından dönen dosya kaydıyla aynı değildir. Dosya düğümü kayıtları, dosya kayıtlarına işaret eder."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"FileSystemNodeList":{"type":"array","items":{"$ref":"#/components/schemas/FileSystemNode"}},"FileSystemNode":{"type":"object","properties":{"_id":{"type":"string"},"parent":{"type":"string","nullable":true},"group":{"type":"string"},"customer":{"type":"string"},"type":{"type":"string","enum":["f","d"],"description":"`f`: dosya, `d`: dizin"},"file":{"allOf":[{"$ref":"#/components/schemas/File"}],"nullable":true},"name":{"type":"string"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"File":{"type":"object","properties":{"_id":{"type":"string"},"name":{"type":"string"},"thumbnail":{"type":"string"},"google":{"type":"object","properties":{"id":{"type":"string"},"extension":{"type":"string"},"webViewLink":{"type":"string"},"mimeType":{"type":"string"}}},"dropbox":{"type":"object","properties":{"id":{"type":"string"},"webViewLink":{"type":"string"}}}}},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"},"ErrorCode":{"type":"object","required":["code"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"ForbiddenCode":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}},"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/file-system-nodes":{"get":{"tags":["Dosyalar"],"summary":"Düğümleri getir","description":"Bir dizindeki dosya ve dizin düğümlerini alır. İstek, `group` veya `customer` parametreleri ile gönderilmelidir.","operationId":"listFileSystemNodes","parameters":[{"name":"group","in":"query","schema":{"$ref":"#/components/schemas/ObjectId"},"description":"Proje ID'si"},{"name":"customer","in":"query","schema":{"$ref":"#/components/schemas/ObjectId"},"description":"Müşteri ID'si"},{"name":"parent","in":"query","schema":{"allOf":[{"$ref":"#/components/schemas/ObjectId"},{"nullable":true}]},"description":"Dizin ID'si. Kök için `null`. Belirtilmezse tüm dizinlerde arar."},{"name":"search","in":"query","schema":{"type":"string"},"description":"Dosya ve dizin adlarında aranacak metin"}],"responses":{"200":{"description":"Dosya sistemi düğümleri","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileSystemNodeList"}}}},"403":{"$ref":"#/components/responses/ForbiddenCode"},"422":{"$ref":"#/components/responses/ValidationFailed"}}}}}}
```

## Düğümleri sil

> Bir projeden veya müşteriden dosya ve dizin düğümlerini siler. Dosya düğümleri, dosya kayıtları ve yüklenen dosya ile birlikte silinir. Farklı projelerden veya müşterilerden birden çok düğüm, tek bir istekte silinemez.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Dosyalar","description":"Bu doküman aşağıdaki uç noktalarını içerir:<br><br>1. Dosyaları uygulamanın farklı bölümlerine yükleme — **Dosya yükle**<br>2. Projelerde dosyalar özelliği<br><br>Yükleme ve indirme<br><br>Dosyalar görevlere, görev aktivitelerine, sohbet mesajlarına, müşterilere ve dosyalar sayfasına yüklenebilir. Önce **Dosya yükle** ile dosyayı yükleyin; sunucu dosya ID'sini döner. Bu ID'yi diğer uç noktalarda kullanın.<br><br>Dosya sayfası uç noktaları<br><br>Bu uç noktalar, bir projenin ve bir müşterinin Dosyalar sayfasındaki dosya ve klasörleri görüntülemenize, oluşturmanıza, düzenlemenize ve silmenize olanak tanır.<br><br>Dosyalar sayfasının yapısı bir bilgisayardaki veya Google Drive gibi diğer dosya depolama hizmetlerindeki dosya sistemine benzer. İç içe geçmiş dosya ve dizin düğümlerinden oluşur. En üstte bir kök dizin düğümü bulunur. Dizinler alt dosya ve dizin düğümlerini tutar. Dosya düğümleri, **Dosya yükle** uç noktasından dönen dosya kaydıyla aynı değildir. Dosya düğümü kayıtları, dosya kayıtlarına işaret eder."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"DeleteFileSystemNodesRequest":{"type":"object","required":["nodes"],"properties":{"nodes":{"type":"array","items":{"type":"string"},"description":"Silinecek düğüm ID listesi"}}},"ErrorPlain":{"type":"string"},"ErrorCode":{"type":"object","required":["code"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."}}}},"responses":{"ForbiddenCode":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}},"NotFoundEmpty":{"description":"Kaynak bulunamadı"}}},"paths":{"/file-system-nodes":{"delete":{"tags":["Dosyalar"],"summary":"Düğümleri sil","description":"Bir projeden veya müşteriden dosya ve dizin düğümlerini siler. Dosya düğümleri, dosya kayıtları ve yüklenen dosya ile birlikte silinir. Farklı projelerden veya müşterilerden birden çok düğüm, tek bir istekte silinemez.","operationId":"deleteFileSystemNodes","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteFileSystemNodesRequest"}}}},"responses":{"204":{"description":"İçerik yok"},"400":{"description":"Geçersiz istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorPlain"}}}},"403":{"$ref":"#/components/responses/ForbiddenCode"},"404":{"$ref":"#/components/responses/NotFoundEmpty"},"422":{"description":"Geçersiz işlem","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Dosya ekle

> Yüklenen dosyalar için dosya düğümleri oluşturur. \`group\` veya \`customer\` parametresi ayarlanmalıdır. Dosyaları önce \*\*Dosya yükle\*\* ile yükleyin.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Dosyalar","description":"Bu doküman aşağıdaki uç noktalarını içerir:<br><br>1. Dosyaları uygulamanın farklı bölümlerine yükleme — **Dosya yükle**<br>2. Projelerde dosyalar özelliği<br><br>Yükleme ve indirme<br><br>Dosyalar görevlere, görev aktivitelerine, sohbet mesajlarına, müşterilere ve dosyalar sayfasına yüklenebilir. Önce **Dosya yükle** ile dosyayı yükleyin; sunucu dosya ID'sini döner. Bu ID'yi diğer uç noktalarda kullanın.<br><br>Dosya sayfası uç noktaları<br><br>Bu uç noktalar, bir projenin ve bir müşterinin Dosyalar sayfasındaki dosya ve klasörleri görüntülemenize, oluşturmanıza, düzenlemenize ve silmenize olanak tanır.<br><br>Dosyalar sayfasının yapısı bir bilgisayardaki veya Google Drive gibi diğer dosya depolama hizmetlerindeki dosya sistemine benzer. İç içe geçmiş dosya ve dizin düğümlerinden oluşur. En üstte bir kök dizin düğümü bulunur. Dizinler alt dosya ve dizin düğümlerini tutar. Dosya düğümleri, **Dosya yükle** uç noktasından dönen dosya kaydıyla aynı değildir. Dosya düğümü kayıtları, dosya kayıtlarına işaret eder."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"CreateFileSystemFileNodesRequest":{"type":"object","required":["parent","files"],"properties":{"group":{"type":"string","description":"Proje dosyalar sayfasındaysa proje ID'si"},"customer":{"type":"string","description":"Müşteri dosyalar sayfasındaysa müşteri ID'si"},"parent":{"type":"string","nullable":true,"description":"Üst dizin ID'si. Kök dizin ise `null`."},"files":{"description":"Dosya ID listesi","oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}}},"FileSystemNodeList":{"type":"array","items":{"$ref":"#/components/schemas/FileSystemNode"}},"FileSystemNode":{"type":"object","properties":{"_id":{"type":"string"},"parent":{"type":"string","nullable":true},"group":{"type":"string"},"customer":{"type":"string"},"type":{"type":"string","enum":["f","d"],"description":"`f`: dosya, `d`: dizin"},"file":{"allOf":[{"$ref":"#/components/schemas/File"}],"nullable":true},"name":{"type":"string"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"File":{"type":"object","properties":{"_id":{"type":"string"},"name":{"type":"string"},"thumbnail":{"type":"string"},"google":{"type":"object","properties":{"id":{"type":"string"},"extension":{"type":"string"},"webViewLink":{"type":"string"},"mimeType":{"type":"string"}}},"dropbox":{"type":"object","properties":{"id":{"type":"string"},"webViewLink":{"type":"string"}}}}},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"},"ErrorCode":{"type":"object","required":["code"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."}}}},"responses":{"ForbiddenCode":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}},"paths":{"/file-system-nodes/files":{"post":{"tags":["Dosyalar"],"summary":"Dosya ekle","description":"Yüklenen dosyalar için dosya düğümleri oluşturur. `group` veya `customer` parametresi ayarlanmalıdır. Dosyaları önce **Dosya yükle** ile yükleyin.","operationId":"createFileSystemFileNodes","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFileSystemFileNodesRequest"}}}},"responses":{"200":{"description":"Dosya sistemi düğüm listesi","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileSystemNodeList"}}}},"403":{"$ref":"#/components/responses/ForbiddenCode"},"422":{"description":"Geçersiz işlem"}}}}}}
```

## Dizin ekle

> Bir dizin düğümü oluşturur. \`group\` veya \`customer\` parametresi ayarlanmalıdır. Üst dizin kök dizin ise \`parent\` \`null\` olmalı.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Dosyalar","description":"Bu doküman aşağıdaki uç noktalarını içerir:<br><br>1. Dosyaları uygulamanın farklı bölümlerine yükleme — **Dosya yükle**<br>2. Projelerde dosyalar özelliği<br><br>Yükleme ve indirme<br><br>Dosyalar görevlere, görev aktivitelerine, sohbet mesajlarına, müşterilere ve dosyalar sayfasına yüklenebilir. Önce **Dosya yükle** ile dosyayı yükleyin; sunucu dosya ID'sini döner. Bu ID'yi diğer uç noktalarda kullanın.<br><br>Dosya sayfası uç noktaları<br><br>Bu uç noktalar, bir projenin ve bir müşterinin Dosyalar sayfasındaki dosya ve klasörleri görüntülemenize, oluşturmanıza, düzenlemenize ve silmenize olanak tanır.<br><br>Dosyalar sayfasının yapısı bir bilgisayardaki veya Google Drive gibi diğer dosya depolama hizmetlerindeki dosya sistemine benzer. İç içe geçmiş dosya ve dizin düğümlerinden oluşur. En üstte bir kök dizin düğümü bulunur. Dizinler alt dosya ve dizin düğümlerini tutar. Dosya düğümleri, **Dosya yükle** uç noktasından dönen dosya kaydıyla aynı değildir. Dosya düğümü kayıtları, dosya kayıtlarına işaret eder."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"CreateFileSystemDirectoryRequest":{"type":"object","required":["name"],"properties":{"group":{"type":"string","description":"Proje dosyalar sayfasındaysa proje ID'si"},"customer":{"type":"string","description":"Müşteri dosyalar sayfasındaysa müşteri ID'si"},"parent":{"type":"string","nullable":true,"description":"Üst dizin ID'si. Kök dizin ise `null`."},"name":{"type":"string","description":"Dizin adı"}}},"FileSystemNode":{"type":"object","properties":{"_id":{"type":"string"},"parent":{"type":"string","nullable":true},"group":{"type":"string"},"customer":{"type":"string"},"type":{"type":"string","enum":["f","d"],"description":"`f`: dosya, `d`: dizin"},"file":{"allOf":[{"$ref":"#/components/schemas/File"}],"nullable":true},"name":{"type":"string"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"File":{"type":"object","properties":{"_id":{"type":"string"},"name":{"type":"string"},"thumbnail":{"type":"string"},"google":{"type":"object","properties":{"id":{"type":"string"},"extension":{"type":"string"},"webViewLink":{"type":"string"},"mimeType":{"type":"string"}}},"dropbox":{"type":"object","properties":{"id":{"type":"string"},"webViewLink":{"type":"string"}}}}},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"},"ErrorCode":{"type":"object","required":["code"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."}}}},"responses":{"ForbiddenCode":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}},"paths":{"/file-system-nodes/directories":{"post":{"tags":["Dosyalar"],"summary":"Dizin ekle","description":"Bir dizin düğümü oluşturur. `group` veya `customer` parametresi ayarlanmalıdır. Üst dizin kök dizin ise `parent` `null` olmalı.","operationId":"createFileSystemDirectory","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFileSystemDirectoryRequest"}}}},"responses":{"200":{"description":"Dosya sistemi düğümü","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileSystemNode"}}}},"403":{"$ref":"#/components/responses/ForbiddenCode"},"422":{"description":"Geçersiz işlem"}}}}}}
```
