---
title: "CloudObjectStepRelations.update"
method: PATCH
path: "/entities/CloudObjectStepRelations/{id}"
tags: ["Document"]
---

# CloudObjectStepRelations.update

`PATCH /entities/CloudObjectStepRelations/{id}`

Modifies CloudObjectStepRelation or CloudObjectStepRelations with given id(s)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `validation-level` integer

## Request body

- UpdateCloudObjectStepRelationInput
  - `cloud_object` object — File attached to the step. Relation to CloudObject, see: 'updateCloudObjectInput' object for properties.
    - `id` string, uri
  - `cloud_object_id` string, uuid — Id of the attached file.
  - `sort_order` integer — Position of the file within the step's document list.
  - `step_id` string, uuid — Id of the pipeline step.
  - `revision` integer — Revision when entity was lastly changed.

## Response `200`

Modification confirmation. Returns resulting CloudObjectStepRelation

- object
  - `success` boolean — True when response succeeded, false on error.
  - `data` CloudObjectStepRelation
    - `is_delete_protected` boolean, required — Tells if the entity instance is protected against delete (Entities that need to be present in the system at any time). Delete action still may fail if entity is deletable, due some other additional validations.
    - `id` string, uuid, required — Unique identifier of entity.
    - `is_deleted` boolean — Specifies if the entity is considered deleted.
    - `modified` string, date-time — Last modification time.
    - `created` string, date-time — Creation time.
    - `cloud_object` string, uri, required — File attached to the step. Relation to CloudObject. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'CloudObject' object for properties.
    - `step` string, uri, required — Pipeline step the file is attached to. Relation to Step. By default it is returned as URI to related resource. Using parameter 'expand', it will return full entity. See: 'Step' object for properties.
    - `cloud_object_id` string, uuid — Id of the attached file.
    - `sort_order` integer — Position of the file within the step's document list.
    - `step_id` string, uuid, required — Id of the pipeline step.
    - `revision` integer — Revision when entity was lastly changed.

## Other responses

- `404` — Sent when invalid ID is given
- `500` — unexpected error

---

[API](https://skmtc.net/aws/apis/pipeliner-cloud-api.md) · [All operations](https://skmtc.net/aws/apis/pipeliner-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/pipeliner-cloud-api/versions/e8c12ae60aca/schema)