---
title: "Create or update input mapping between two workflow specifications"
method: PUT
path: "/workflow-specs-mappings"
tags: ["WorkflowSpecs"]
---

# Create or update input mapping between two workflow specifications

`PUT /workflow-specs-mappings`

## Request

- Base URL: `https://api.delfi.slb.com/fdplan/evaluation/v1`
- URL: `https://api.delfi.slb.com/fdplan/evaluation/v1/workflow-specs-mappings`
- Auth: API key in header `Authorization` and API key in header `appkey`

Create or update input mapping between two workflow specifications.

## Headers

- `slb-partition-id` string, required

## Request body

- WorkflowSpecMapping
  - `fromWorkflowSpec` VersionId, required: A specification reference which allows the API users to specify the version of a specification when creating or updating a parent specification.
    - `id` string, required: The specification ID.
    - `version` integer, required: The version of the specification of the given ID.
  - `toWorkflowSpec` VersionId, required: A specification reference which allows the API users to specify the version of a specification when creating or updating a parent specification.
    - `id` string, required: The specification ID.
    - `version` integer, required: The version of the specification of the given ID.
  - `inputMappings` InputMapping[], required
    - `fromAddress` SpecAddress, required: An address used to describe the location of a Spec within a WorkflowSpec. Used to enrich the spec model with additional attributes such as specifying the location of a data container or providing annotations.
      - `type` 'Invalid' | 'Computation' | 'DataTypeInput' | 'DataTypeOutput' | 'Workflow', required: Whether the address refers to a data-type input, a data-type output or a computation specification.
      - `computationIndex` integer: The zero based index of the Computation Spec.
      - `dataTypeIndex` integer: The zero based index of a data-type with respect to a computation specification. Inputs and outputs are treated as separate ordered lists.
    - `toAddress` SpecAddress, required: An address used to describe the location of a Spec within a WorkflowSpec. Used to enrich the spec model with additional attributes such as specifying the location of a data container or providing annotations.
      - `type` 'Invalid' | 'Computation' | 'DataTypeInput' | 'DataTypeOutput' | 'Workflow', required: Whether the address refers to a data-type input, a data-type output or a computation specification.
      - `computationIndex` integer: The zero based index of the Computation Spec.
      - `dataTypeIndex` integer: The zero based index of a data-type with respect to a computation specification. Inputs and outputs are treated as separate ordered lists.

## Response `200`

Workflow specification input mapping updated successfully.

- WorkflowSpecMapping
  - `fromWorkflowSpec` VersionId, required: A specification reference which allows the API users to specify the version of a specification when creating or updating a parent specification.
    - `id` string, required: The specification ID.
    - `version` integer, required: The version of the specification of the given ID.
  - `toWorkflowSpec` VersionId, required: A specification reference which allows the API users to specify the version of a specification when creating or updating a parent specification.
    - `id` string, required: The specification ID.
    - `version` integer, required: The version of the specification of the given ID.
  - `inputMappings` InputMapping[], required
    - `fromAddress` SpecAddress, required: An address used to describe the location of a Spec within a WorkflowSpec. Used to enrich the spec model with additional attributes such as specifying the location of a data container or providing annotations.
      - `type` 'Invalid' | 'Computation' | 'DataTypeInput' | 'DataTypeOutput' | 'Workflow', required: Whether the address refers to a data-type input, a data-type output or a computation specification.
      - `computationIndex` integer: The zero based index of the Computation Spec.
      - `dataTypeIndex` integer: The zero based index of a data-type with respect to a computation specification. Inputs and outputs are treated as separate ordered lists.
    - `toAddress` SpecAddress, required: An address used to describe the location of a Spec within a WorkflowSpec. Used to enrich the spec model with additional attributes such as specifying the location of a data container or providing annotations.
      - `type` 'Invalid' | 'Computation' | 'DataTypeInput' | 'DataTypeOutput' | 'Workflow', required: Whether the address refers to a data-type input, a data-type output or a computation specification.
      - `computationIndex` integer: The zero based index of the Computation Spec.
      - `dataTypeIndex` integer: The zero based index of a data-type with respect to a computation specification. Inputs and outputs are treated as separate ordered lists.

## Other responses

- `201`: Workflow specification input mapping created successfully.
- `400`: Bad request.
- `401`: Unauthorized.
- `404`: Workflow specification was not found
- `default`: Unexpected error.

## Changes

- **2026-09-21** `5f813005dce5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/slb/apis/evaluation/changes/workflow-specs-mappings/put.md)

---

[API](https://skmtc.dev/slb/apis/evaluation.md) - [All operations](https://skmtc.dev/slb/apis/evaluation/llms.txt) - [OpenAPI document](https://skmtc.dev/slb/apis/evaluation/revisions/5f813005dce5?raw)
