ПайплайныПо ID пайплайнаОбновить шаблон пайплайна

Обновить шаблон пайплайна

Обновляет пользовательский шаблон. Системные шаблоны (`is_default=true`) нельзя редактировать.

PATCH
/pipelines/{pipelineId}

Authorization

AuthorizationRequiredBearer <token>

API ключ для аутентификации. Передавайте в заголовке Authorization: Bearer sk-...

In: header

Request Body

application/jsonRequired
namestring
Maximum length: 255
descriptionstring
Maximum length: 1000
stepsarray<object>

Path Parameters

pipelineIdRequiredstring

ID шаблона

Format: "uuid"

Response Body

Шаблон обновлён

successboolean
dataobject

Ошибка аутентификации.

КодПричинаЧто делать
MISSING_API_KEYЗаголовок Authorization отсутствуетДобавьте Authorization: Bearer sk-...
INVALID_AUTH_FORMATНеверный формат заголовкаИспользуйте формат Bearer sk-...
INVALID_API_KEYКлюч не найден в системеПроверьте ключ в личном кабинете
API_KEY_INACTIVEКлюч деактивированАктивируйте ключ в личном кабинете
API_KEY_EXPIREDСрок действия ключа истёкСоздайте новый ключ
successRequiredboolean
errorRequiredobject
errorsarray<object>

Детализация ошибок валидации (при code=VALIDATION_ERROR)

Шаблон пайплайна не найден. Убедитесь, что ID корректный и шаблон принадлежит вашему аккаунту (или является системным).

successRequiredboolean
errorRequiredobject
errorsarray<object>

Детализация ошибок валидации (при code=VALIDATION_ERROR)

Превышен лимит запросов для вашего тарифа. Повторите запрос через время, указанное в заголовке Retry-After.

Лимиты зависят от тарифа (см. раздел Тарифы в личном кабинете).

successRequiredboolean
errorRequiredobject
errorsarray<object>

Детализация ошибок валидации (при code=VALIDATION_ERROR)

curl -X PATCH "/api/v1/pipelines/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "steps": [
      {
        "name": "fetch",
        "depends_on": [],
        "options": {}
      }
    ]
  }'
const body = JSON.stringify({
  "name": "string",
  "description": "string",
  "steps": [
    {
      "name": "fetch",
      "depends_on": [],
      "options": {}
    }
  ]
})

fetch("/api/v1/pipelines/497f6eca-6276-4993-bfeb-53cbbbba6f08", {
  headers: {
    "Authorization": "Bearer <token>"
  },
  body
})
package main

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

func main() {
  url := "/api/v1/pipelines/497f6eca-6276-4993-bfeb-53cbbbba6f08"
  body := strings.NewReader(`{
    "name": "string",
    "description": "string",
    "steps": [
      {
        "name": "fetch",
        "depends_on": [],
        "options": {}
      }
    ]
  }`)
  req, _ := http.NewRequest("PATCH", url, body)
  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "/api/v1/pipelines/497f6eca-6276-4993-bfeb-53cbbbba6f08"
body = {
  "name": "string",
  "description": "string",
  "steps": [
    {
      "name": "fetch",
      "depends_on": [],
      "options": {}
    }
  ]
}
response = requests.request("PATCH", url, json = body, headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
})

print(response.text)
{
  "success": true,
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "description": "string",
    "steps": [
      {
        "name": "fetch",
        "depends_on": [],
        "options": {}
      }
    ],
    "is_default": true,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "MISSING_API_KEY",
    "message": "API key is required. Pass it in Authorization header: Bearer sk-..."
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Pipeline template not found"
  }
}
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 12 seconds"
  }
}