> 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/formlar.md).

# Formlar

Kurum formlarını ve form yanıtlarını getirir.

## Formları getir

> Kurumdaki formları getirir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Formlar","description":"Kurum formlarını ve form yanıtlarını getirir."}],"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":{"FormPage":{"type":"object","properties":{"count":{"type":"number"},"forms":{"type":"array","items":{"$ref":"#/components/schemas/Form"}}}},"Form":{"type":"object","properties":{"_id":{"$ref":"#/components/schemas/ObjectId"},"title":{"type":"string"},"description":{"type":"string"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/FormField"}},"createdBy":{"type":"string"},"orgId":{"type":"string"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"},"updatedAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"FormField":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["input","textarea","date","datetime","radio","selectbox","multiselect","subtitle"]},"options":{"type":"array","items":{"type":"string"}},"isRequired":{"type":"boolean"},"halfRow":{"type":"boolean"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"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":{"/forms":{"get":{"tags":["Formlar"],"summary":"Formları getir","operationId":"listForms","description":"Kurumdaki formları getirir.","parameters":[{"name":"search","in":"query","schema":{"type":"string"},"description":"Form başlığında arama"},{"name":"limit","in":"query","schema":{"type":"number"},"description":"Kayıt limiti"},{"name":"skip","in":"query","schema":{"type":"number"},"description":"Atlanacak kayıt sayısı"}],"responses":{"200":{"description":"Form sayfası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormPage"}}}},"403":{"$ref":"#/components/responses/ForbiddenCode"}}}}}}
```

## ID'ye göre form getir

> Verilen ID'ye sahip formu getirir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Formlar","description":"Kurum formlarını ve form yanıtlarını getirir."}],"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"},"Form":{"type":"object","properties":{"_id":{"$ref":"#/components/schemas/ObjectId"},"title":{"type":"string"},"description":{"type":"string"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/FormField"}},"createdBy":{"type":"string"},"orgId":{"type":"string"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"},"updatedAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"FormField":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["input","textarea","date","datetime","radio","selectbox","multiselect","subtitle"]},"options":{"type":"array","items":{"type":"string"}},"isRequired":{"type":"boolean"},"halfRow":{"type":"boolean"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"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"}}}},"NotFound":{"description":"Kaynak bulunamadı"},"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/forms/{id}":{"get":{"tags":["Formlar"],"summary":"ID'ye göre form getir","operationId":"getForm","description":"Verilen ID'ye sahip formu getirir.","parameters":[{"$ref":"#/components/parameters/IdPath"}],"responses":{"200":{"description":"Form detayları","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Form"}}}},"403":{"$ref":"#/components/responses/ForbiddenCode"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}}}}}}
```

## Form yanıtlarını getir

> Verilen forma ait yanıtları, form kaydını ve yanıtların bağlı olduğu görevleri getirir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Formlar","description":"Kurum formlarını ve form yanıtlarını getirir."}],"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"},"FormSubmissionsPage":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/Form"},"submissions":{"type":"array","items":{"$ref":"#/components/schemas/FormSubmission"}},"submissionTaskPairs":{"type":"object","additionalProperties":{"type":"object","nullable":true,"properties":{"_id":{"type":"string"},"name":{"type":"string"},"group":{"type":"string"},"deleted_at":{"type":"number","nullable":true}}}}}},"Form":{"type":"object","properties":{"_id":{"$ref":"#/components/schemas/ObjectId"},"title":{"type":"string"},"description":{"type":"string"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/FormField"}},"createdBy":{"type":"string"},"orgId":{"type":"string"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"},"updatedAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"FormField":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["input","textarea","date","datetime","radio","selectbox","multiselect","subtitle"]},"options":{"type":"array","items":{"type":"string"}},"isRequired":{"type":"boolean"},"halfRow":{"type":"boolean"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"},"FormSubmission":{"type":"object","properties":{"_id":{"$ref":"#/components/schemas/ObjectId"},"formId":{"type":"string"},"taskId":{"type":"string"},"task":{"type":"object","nullable":true,"properties":{"_id":{"type":"string"},"name":{"type":"string"},"group":{"type":"string"}}},"orgId":{"type":"string"},"values":{"type":"object","additionalProperties":true},"createdBy":{"type":"string"},"createdAt":{"$ref":"#/components/schemas/UnixTimestamp"},"updatedAt":{"$ref":"#/components/schemas/UnixTimestamp"}}},"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"}}}},"NotFound":{"description":"Kaynak bulunamadı"}}},"paths":{"/forms/{id}/submissions":{"get":{"tags":["Formlar"],"summary":"Form yanıtlarını getir","operationId":"listFormSubmissions","description":"Verilen forma ait yanıtları, form kaydını ve yanıtların bağlı olduğu görevleri getirir.","parameters":[{"$ref":"#/components/parameters/IdPath"}],"responses":{"200":{"description":"Form ve yanıtlar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormSubmissionsPage"}}}},"403":{"$ref":"#/components/responses/ForbiddenCode"},"404":{"$ref":"#/components/responses/NotFound"}}}}}}
```
