> ## Documentation Index > Fetch the complete documentation index at: https://docs.azalt.co/llms.txt > Use this file to discover all available pages before exploring further. # Aktivite tanımı oluştur > Yeni bir aktivite tanımı şablonu oluşturur: **Gerekli Parametreler**: - `name`: Tanımın anlaşılır adı - `uiCode`: Giriş formu için React bileşen gövdesi (`function ActivityUI(...) {` veya kapanış süslü parantezlerini eklemeyin; sistem otomatik olarak sarar) - `calcCode`: Hesaplama mantığı için JavaScript fonksiyon gövdesi (`async function calculate(inputValues) {` veya kapanış parantezini eklemeyin; sistem `inputs` ile sarar) - `inputs`: Giriş alanı tanımlarından oluşan dizi **Opsiyonel Parametreler**: - `description`: Aktivite tipine dair detaylı açıklama - `isCommon`: Tüm organizasyonlarla paylaş (yükseltilmiş yetki gerektirir) Aktivite tanımları, aktiviteler için tutarlı hesaplama mantığı ve kullanıcı arayüzü sağlayan şablonlardır. ## OpenAPI ````yaml https://app.azalt.co/api/v1/openapi.tr.json post /activity-definitions openapi: 3.0.3 info: title: Erguvan Genel API version: 1.0.0 description: Erguvan platformuna entegrasyon için REST API referansının Türkçe sürümü. servers: - url: https://app.azalt.co/api/v1 security: [] tags: - name: Activity x-displayName: Aktiviteler - name: ActivityDefinition x-displayName: Aktivite Tanımları - name: ApiKey x-displayName: API Anahtarları - name: Dashboard x-displayName: Panolar - name: DashboardWidget x-displayName: Pano Bileşenleri - name: Dataset x-displayName: Veri Setleri - name: DatasetItem x-displayName: Veri Seti Öğeleri - name: File x-displayName: Dosyalar - name: Form x-displayName: Formlar - name: FormElement x-displayName: Form Öğeleri - name: FormElementSubmission x-displayName: Form Öğesi Gönderimleri - name: FormSite x-displayName: Form-Tesis İlişkilendirmeleri - name: FormSubmission x-displayName: Form Gönderimleri - name: Indicator x-displayName: Göstergeler - name: Organization x-displayName: Organizasyonlar - name: Site x-displayName: Tesisler - name: Target x-displayName: Hedefler - name: Unit x-displayName: Birimler - name: User x-displayName: Kullanıcılar paths: /activity-definitions: post: tags: - ActivityDefinition summary: Aktivite tanımı oluştur description: >- Yeni bir aktivite tanımı şablonu oluşturur: **Gerekli Parametreler**: - `name`: Tanımın anlaşılır adı - `uiCode`: Giriş formu için React bileşen gövdesi (`function ActivityUI(...) {` veya kapanış süslü parantezlerini eklemeyin; sistem otomatik olarak sarar) - `calcCode`: Hesaplama mantığı için JavaScript fonksiyon gövdesi (`async function calculate(inputValues) {` veya kapanış parantezini eklemeyin; sistem `inputs` ile sarar) - `inputs`: Giriş alanı tanımlarından oluşan dizi **Opsiyonel Parametreler**: - `description`: Aktivite tipine dair detaylı açıklama - `isCommon`: Tüm organizasyonlarla paylaş (yükseltilmiş yetki gerektirir) Aktivite tanımları, aktiviteler için tutarlı hesaplama mantığı ve kullanıcı arayüzü sağlayan şablonlardır. operationId: createActivityDefinition requestBody: required: true content: application/json: schema: type: object properties: name: type: string minLength: 1 description: type: string uiCode: type: string calcCode: type: string inputs: type: array items: oneOf: - type: object properties: name: type: string exportName: type: string type: type: string enum: - string required: type: boolean example: type: string editor: oneOf: - type: object properties: type: type: string enum: - select options: type: array items: type: object properties: label: type: string value: type: string required: - label - value required: - type - options - type: object properties: type: type: string enum: - datasetItemSelector datasetName: type: string groupByName: type: boolean prefetchItems: type: boolean minSearchLength: type: integer minimum: 0 required: - type - datasetName required: - name - type - required - type: object properties: name: type: string exportName: type: string type: type: string enum: - number required: type: boolean example: type: number required: - name - type - required - type: object properties: name: type: string exportName: type: string type: type: string enum: - array required: type: boolean item: oneOf: - type: object properties: type: type: string enum: - string example: type: string required: - type - type: object properties: type: type: string enum: - number example: type: number required: - type - type: object properties: type: type: string enum: - object fields: type: array items: type: object properties: name: type: string exportName: type: string type: type: string enum: - string - number required: type: boolean example: anyOf: - type: string - type: number required: - name - type minItems: 1 required: - type - fields minItems: type: integer minimum: 0 maxItems: type: integer minimum: 1 example: {} required: - name - type - required - item metadataSchema: type: object additionalProperties: {} default: {} isCommon: type: boolean required: - name - uiCode - calcCode - inputs responses: '200': description: Successful response content: application/json: schema: type: object properties: id: type: string name: type: string description: type: string nullable: true uiCode: type: string calcCode: type: string inputs: type: array items: oneOf: - type: object properties: name: type: string exportName: type: string type: type: string enum: - string required: type: boolean example: type: string editor: oneOf: - type: object properties: type: type: string enum: - select options: type: array items: type: object properties: label: type: string value: type: string required: - label - value required: - type - options - type: object properties: type: type: string enum: - datasetItemSelector datasetName: type: string groupByName: type: boolean prefetchItems: type: boolean minSearchLength: type: integer minimum: 0 required: - type - datasetName required: - name - type - required - type: object properties: name: type: string exportName: type: string type: type: string enum: - number required: type: boolean example: type: number required: - name - type - required - type: object properties: name: type: string exportName: type: string type: type: string enum: - array required: type: boolean item: oneOf: - type: object properties: type: type: string enum: - string example: type: string required: - type - type: object properties: type: type: string enum: - number example: type: number required: - type - type: object properties: type: type: string enum: - object fields: type: array items: type: object properties: name: type: string exportName: type: string type: type: string enum: - string - number required: type: boolean example: anyOf: - type: string - type: number required: - name - type minItems: 1 required: - type - fields minItems: type: integer minimum: 0 maxItems: type: integer minimum: 1 example: {} required: - name - type - required - item organizationId: type: string nullable: true metadataSchema: type: object additionalProperties: {} default: {} createdAt: type: string updatedAt: type: string required: - id - name - description - uiCode - calcCode - inputs - organizationId - metadataSchema - createdAt - updatedAt '400': description: Invalid input data content: application/json: schema: $ref: '#/components/schemas/error.BAD_REQUEST' '401': description: Authorization not provided content: application/json: schema: $ref: '#/components/schemas/error.UNAUTHORIZED' '403': description: Insufficient access content: application/json: schema: $ref: '#/components/schemas/error.FORBIDDEN' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR' security: - Authorization: [] components: schemas: error.BAD_REQUEST: type: object properties: message: type: string description: The error message example: Invalid input data code: type: string description: The error code example: BAD_REQUEST issues: type: array items: type: object properties: message: type: string required: - message description: An array of issues that were responsible for the error example: [] required: - message - code title: Invalid input data error (400) description: The error information example: code: BAD_REQUEST message: Invalid input data issues: [] error.UNAUTHORIZED: type: object properties: message: type: string description: The error message example: Authorization not provided code: type: string description: The error code example: UNAUTHORIZED issues: type: array items: type: object properties: message: type: string required: - message description: An array of issues that were responsible for the error example: [] required: - message - code title: Authorization not provided error (401) description: The error information example: code: UNAUTHORIZED message: Authorization not provided issues: [] error.FORBIDDEN: type: object properties: message: type: string description: The error message example: Insufficient access code: type: string description: The error code example: FORBIDDEN issues: type: array items: type: object properties: message: type: string required: - message description: An array of issues that were responsible for the error example: [] required: - message - code title: Insufficient access error (403) description: The error information example: code: FORBIDDEN message: Insufficient access issues: [] error.INTERNAL_SERVER_ERROR: type: object properties: message: type: string description: The error message example: Internal server error code: type: string description: The error code example: INTERNAL_SERVER_ERROR issues: type: array items: type: object properties: message: type: string required: - message description: An array of issues that were responsible for the error example: [] required: - message - code title: Internal server error error (500) description: The error information example: code: INTERNAL_SERVER_ERROR message: Internal server error issues: [] securitySchemes: Authorization: type: http scheme: bearer ````