---
title: "Create or update task definition(s)"
method: POST
path: "/api/metadata/taskdefs"
tags: ["metadata-resource"]
---

# Create or update task definition(s)

`POST /api/metadata/taskdefs`

## Request body

- ExtendedTaskDef[]
  - `backoffJitterMs` integer
  - `backoffScaleFactor` integer
  - `baseType` string
  - `concurrentExecLimit` integer
  - `createTime` integer
  - `createdBy` string
  - `description` string
  - `enforceSchema` boolean
  - `executionNameSpace` string
  - `inputKeys` string[]
  - `inputSchema` SchemaDef
    - `createTime` integer
    - `createdBy` string
    - `data` object
    - `externalRef` string
    - `name` string, required
    - `ownerApp` string
    - `type` 'JSON' | 'AVRO' | 'PROTOBUF', required
    - `updateTime` integer
    - `updatedBy` string
    - `version` integer, required
  - `inputTemplate` object
  - `isolationGroupId` string
  - `maxRetryDelaySeconds` integer
  - `name` string, required
  - `outputKeys` string[]
  - `outputSchema` SchemaDef
    - `createTime` integer
    - `createdBy` string
    - `data` object
    - `externalRef` string
    - `name` string, required
    - `ownerApp` string
    - `type` 'JSON' | 'AVRO' | 'PROTOBUF', required
    - `updateTime` integer
    - `updatedBy` string
    - `version` integer, required
  - `overwriteTags` boolean
  - `ownerApp` string
  - `ownerEmail` string
  - `pollTimeoutSeconds` integer
  - `rateLimitFrequencyInSeconds` integer
  - `rateLimitPerFrequency` integer
  - `responseTimeoutSeconds` integer
  - `retryCount` integer
  - `retryDelaySeconds` integer
  - `retryLogic` 'FIXED' | 'EXPONENTIAL_BACKOFF' | 'LINEAR_BACKOFF'
  - `runtimeMetadata` string[]
  - `tags` Tag[]
    - `key` string
    - `type` string
    - `value` string
  - `taskStatusListenerEnabled` boolean
  - `timeoutPolicy` 'RETRY' | 'TIME_OUT_WF' | 'ALERT_ONLY'
  - `timeoutSeconds` integer, required
  - `totalTimeoutSeconds` integer
  - `updateTime` integer
  - `updatedBy` string

## Response `200`

OK

---

[API](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server.md) · [All operations](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orkescloud/orkes-conductor-api-server/revisions/6ebf0c14ac41/schema)