Update Workflow

PUT

workflows

{id}

Update Workflow

curl --request PUT \
  --url https://public.api.serval.com/v2/workflows/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "requireFormConfirmation": true,
  "content": "<string>",
  "isPublished": true,
  "tagIds": {
    "ids": [
      "<string>"
    ]
  },
  "showInServiceCatalog": true,
  "serviceCatalogDescription": "<string>",
  "approvalProcedureId": "<string>",
  "package": "<string>"
}
'

import requests

url = "https://public.api.serval.com/v2/workflows/{id}"

payload = {
    "name": "<string>",
    "description": "<string>",
    "requireFormConfirmation": True,
    "content": "<string>",
    "isPublished": True,
    "tagIds": { "ids": ["<string>"] },
    "showInServiceCatalog": True,
    "serviceCatalogDescription": "<string>",
    "approvalProcedureId": "<string>",
    "package": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: '<string>',
    requireFormConfirmation: true,
    content: '<string>',
    isPublished: true,
    tagIds: {ids: ['<string>']},
    showInServiceCatalog: true,
    serviceCatalogDescription: '<string>',
    approvalProcedureId: '<string>',
    package: '<string>'
  })
};

fetch('https://public.api.serval.com/v2/workflows/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public.api.serval.com/v2/workflows/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'description' => '<string>',
    'requireFormConfirmation' => true,
    'content' => '<string>',
    'isPublished' => true,
    'tagIds' => [
        'ids' => [
                '<string>'
        ]
    ],
    'showInServiceCatalog' => true,
    'serviceCatalogDescription' => '<string>',
    'approvalProcedureId' => '<string>',
    'package' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public.api.serval.com/v2/workflows/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"requireFormConfirmation\": true,\n  \"content\": \"<string>\",\n  \"isPublished\": true,\n  \"tagIds\": {\n    \"ids\": [\n      \"<string>\"\n    ]\n  },\n  \"showInServiceCatalog\": true,\n  \"serviceCatalogDescription\": \"<string>\",\n  \"approvalProcedureId\": \"<string>\",\n  \"package\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://public.api.serval.com/v2/workflows/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"requireFormConfirmation\": true,\n  \"content\": \"<string>\",\n  \"isPublished\": true,\n  \"tagIds\": {\n    \"ids\": [\n      \"<string>\"\n    ]\n  },\n  \"showInServiceCatalog\": true,\n  \"serviceCatalogDescription\": \"<string>\",\n  \"approvalProcedureId\": \"<string>\",\n  \"package\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public.api.serval.com/v2/workflows/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"requireFormConfirmation\": true,\n  \"content\": \"<string>\",\n  \"isPublished\": true,\n  \"tagIds\": {\n    \"ids\": [\n      \"<string>\"\n    ]\n  },\n  \"showInServiceCatalog\": true,\n  \"serviceCatalogDescription\": \"<string>\",\n  \"approvalProcedureId\": \"<string>\",\n  \"package\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "<string>",
    "teamId": "<string>",
    "name": "<string>",
    "description": "<string>",
    "requireFormConfirmation": true,
    "content": "<string>",
    "isPublished": true,
    "hasUnpublishedChanges": true,
    "tagIds": [
      "<string>"
    ],
    "showInServiceCatalog": true,
    "serviceCatalogDescription": "<string>",
    "scopedId": "<string>",
    "folderId": "<string>",
    "approvalProcedureId": "<string>",
    "package": "<string>"
  },
  "integrationAccessFindings": [
    {
      "kind": "INTEGRATION_ACCESS_FINDING_KIND_UNSPECIFIED",
      "appInstanceId": "<string>",
      "service": "<string>",
      "instanceName": "<string>"
    }
  ]
}

Authentication and permissions

Token requirements: User-based token (OAuth) or Organization-scoped API key or Team-scoped API key. Send a bearer access token for one of these identities. The permissions and resource restrictions below also apply.

Credential	Access requirements
Organization-scoped API key	Save a draft: `workflows:write` Publish: `workflows:deploy` + `workflows:write` Attach an approval procedure: `settings:read` + `workflows:write` Remove the approval procedure: `settings:write` + `workflows:write`
Team-scoped API key	Save a draft: `workflows:write` Publish: `workflows:deploy` + `workflows:write` Attach an approval procedure: `settings:read` + `workflows:write` Remove the approval procedure: `settings:write` + `workflows:write`
User-based token (OAuth)	Supported, subject to permissions

Permissions joined by + are all required; or separates alternatives. Full-access keys still cannot call endpoints marked unsupported. Team keys must allow every team checked by the request. OAuth access depends on the user’s roles and resource access. Publishing and changing the approval procedure in one request requires the permissions of both cases.

Attach an approval procedure: With a non-empty approval_procedure_id, the procedure must be a named approval procedure in the workflow’s team.
Remove the approval procedure: An empty approval_procedure_id removes the workflow’s approval procedure.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

The ID of the workflow.

Body

application/json

name

string

The name of the workflow.

description

string

A description of the workflow.

requireFormConfirmation

boolean | null

Whether the workflow requires form confirmation. Omit to leave unchanged.

content

string

The content/code of the workflow.

isPublished

boolean | null

Whether the workflow is published. Set to true to publish the workflow.

tagIds

tag_ids · object

The workflow's replacement set of tags: when present, the workflow ends up with exactly the given tag ids (an empty set clears every tag). Omit to leave tags unchanged.

Show child attributes

showInServiceCatalog

boolean | null

Whether to list this workflow in the Service Catalog. Omit to leave unchanged.

serviceCatalogDescription

string | null

Description shown at the top of the Service Catalog run form. Omit to leave unchanged; send an empty string to clear it.

approvalProcedureId

string | null

The ID of a named approval procedure that must approve each run of the workflow. Omit to leave the workflow's approval unchanged; send an empty string to remove it. Attaching requires permission to view approval procedures and removing requires permission to delete them. Requires first-class approval procedures on the team.

package

string | null

Moves the workflow to the access package of this name. Omit to leave it unchanged; send an empty string to move it to the team's default package. The move is saved as a draft and takes effect when the workflow is published. Ignored for teams without access packages.

Response

200 - application/json

Success

data

data · object

The updated workflow.

Show child attributes

integrationAccessFindings

IntegrationAccessFinding · object[]

Advisory reconciliation of the saved content against the version's package. Always empty when the team is not on Integration Access or when the save carried no new content.

Show child attributes

Update Workflow

curl --request PUT \
  --url https://public.api.serval.com/v2/workflows/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "requireFormConfirmation": true,
  "content": "<string>",
  "isPublished": true,
  "tagIds": {
    "ids": [
      "<string>"
    ]
  },
  "showInServiceCatalog": true,
  "serviceCatalogDescription": "<string>",
  "approvalProcedureId": "<string>",
  "package": "<string>"
}
'

import requests

url = "https://public.api.serval.com/v2/workflows/{id}"

payload = {
    "name": "<string>",
    "description": "<string>",
    "requireFormConfirmation": True,
    "content": "<string>",
    "isPublished": True,
    "tagIds": { "ids": ["<string>"] },
    "showInServiceCatalog": True,
    "serviceCatalogDescription": "<string>",
    "approvalProcedureId": "<string>",
    "package": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: '<string>',
    requireFormConfirmation: true,
    content: '<string>',
    isPublished: true,
    tagIds: {ids: ['<string>']},
    showInServiceCatalog: true,
    serviceCatalogDescription: '<string>',
    approvalProcedureId: '<string>',
    package: '<string>'
  })
};

fetch('https://public.api.serval.com/v2/workflows/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public.api.serval.com/v2/workflows/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'description' => '<string>',
    'requireFormConfirmation' => true,
    'content' => '<string>',
    'isPublished' => true,
    'tagIds' => [
        'ids' => [
                '<string>'
        ]
    ],
    'showInServiceCatalog' => true,
    'serviceCatalogDescription' => '<string>',
    'approvalProcedureId' => '<string>',
    'package' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public.api.serval.com/v2/workflows/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"requireFormConfirmation\": true,\n  \"content\": \"<string>\",\n  \"isPublished\": true,\n  \"tagIds\": {\n    \"ids\": [\n      \"<string>\"\n    ]\n  },\n  \"showInServiceCatalog\": true,\n  \"serviceCatalogDescription\": \"<string>\",\n  \"approvalProcedureId\": \"<string>\",\n  \"package\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://public.api.serval.com/v2/workflows/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"requireFormConfirmation\": true,\n  \"content\": \"<string>\",\n  \"isPublished\": true,\n  \"tagIds\": {\n    \"ids\": [\n      \"<string>\"\n    ]\n  },\n  \"showInServiceCatalog\": true,\n  \"serviceCatalogDescription\": \"<string>\",\n  \"approvalProcedureId\": \"<string>\",\n  \"package\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public.api.serval.com/v2/workflows/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"requireFormConfirmation\": true,\n  \"content\": \"<string>\",\n  \"isPublished\": true,\n  \"tagIds\": {\n    \"ids\": [\n      \"<string>\"\n    ]\n  },\n  \"showInServiceCatalog\": true,\n  \"serviceCatalogDescription\": \"<string>\",\n  \"approvalProcedureId\": \"<string>\",\n  \"package\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "<string>",
    "teamId": "<string>",
    "name": "<string>",
    "description": "<string>",
    "requireFormConfirmation": true,
    "content": "<string>",
    "isPublished": true,
    "hasUnpublishedChanges": true,
    "tagIds": [
      "<string>"
    ],
    "showInServiceCatalog": true,
    "serviceCatalogDescription": "<string>",
    "scopedId": "<string>",
    "folderId": "<string>",
    "approvalProcedureId": "<string>",
    "package": "<string>"
  },
  "integrationAccessFindings": [
    {
      "kind": "INTEGRATION_ACCESS_FINDING_KIND_UNSPECIFIED",
      "appInstanceId": "<string>",
      "service": "<string>",
      "instanceName": "<string>"
    }
  ]
}

Get started

Authentication

Endpoints

Development

Authentication and permissions

Authorizations

Path Parameters

Body

Response

​Authentication and permissions

Authorizations

Path Parameters

Body

Response

Authentication and permissions