# Update resources

Updates resources for a workspace.

Endpoint: PATCH /iacm/api/orgs/{org}/projects/{project}/workspaces/{workspace}/resources
Version: 1.0
Security: x-api-key

## Path parameters:

  - `org` (string, required)
    Org is the organisation identifier.
    Example: "k9r"

  - `project` (string, required)
    Project is the project identifier.
    Example: "d9s"

  - `workspace` (string, required)
    Workspace identifier
    Example: "Rerum est consequuntur quia sit."

## Header parameters:

  - `Harness-Account` (string, required)
    Account is the internal customer account ID.
    Example: "hxi"

## Request fields (application/json):

  - `resources` (array, required)
    Example: [{"attributes":"Placeat et voluptatem dolorum molestias et rerum.","drift_attributes":{"Nostrum aut sint vero.":"Ratione placeat temporibus."},"drift_status":"","mode":"Saepe molestiae aperiam.","module":"Cum dolorem qui aut delectus et.","name":"Eum qui et perspiciatis nihil voluptatibus.","path_id":"Quam assumenda a consequuntur harum ipsum officia.","provider":"Maxime sed.","sensitive_attribute_paths":["Voluptatem eum neque debitis tenetur.","Ea harum eveniet rerum ipsa sunt."],"type":"Fuga ut aut voluptatem facere quo veniam."},{"attributes":"Placeat et voluptatem dolorum molestias et rerum.","drift_attributes":{"Nostrum aut sint vero.":"Ratione placeat temporibus."},"drift_status":"","mode":"Saepe molestiae aperiam.","module":"Cum dolorem qui aut delectus et.","name":"Eum qui et perspiciatis nihil voluptatibus.","path_id":"Quam assumenda a consequuntur harum ipsum officia.","provider":"Maxime sed.","sensitive_attribute_paths":["Voluptatem eum neque debitis tenetur.","Ea harum eveniet rerum ipsa sunt."],"type":"Fuga ut aut voluptatem facere quo veniam."},{"attributes":"Placeat et voluptatem dolorum molestias et rerum.","drift_attributes":{"Nostrum aut sint vero.":"Ratione placeat temporibus."},"drift_status":"","mode":"Saepe molestiae aperiam.","module":"Cum dolorem qui aut delectus et.","name":"Eum qui et perspiciatis nihil voluptatibus.","path_id":"Quam assumenda a consequuntur harum ipsum officia.","provider":"Maxime sed.","sensitive_attribute_paths":["Voluptatem eum neque debitis tenetur.","Ea harum eveniet rerum ipsa sunt."],"type":"Fuga ut aut voluptatem facere quo veniam."}]

  - `resources.attributes` (any, required)
    Resource attributes
    Example: "Et quaerat assumenda fugit."

  - `resources.drift_attributes` (object)
    Map of drifted attribute values (used when update_mode=drift)
    Example: {"Placeat odit blanditiis eum itaque ea ab.":"Assumenda officiis explicabo velit.","Repudiandae veritatis magnam.":"Molestiae doloribus expedita.","Vero ad est.":"Quia est."}

  - `resources.drift_status` (string)
    Drift status of the resource (used when update_mode=drift)
    Enum: "changed", "deleted", "unchanged", ""

  - `resources.mode` (string, required)
    managed, datasource, output
    Example: "Ullam omnis ducimus velit."

  - `resources.module` (string, required)
    Module path
    Example: "Libero nam temporibus commodi expedita sit."

  - `resources.name` (string, required)
    Resource name
    Example: "Unde maxime necessitatibus consequatur quae aut."

  - `resources.path_id` (string)
    path id
    Example: "Explicabo autem dolorum blanditiis."

  - `resources.provider` (string, required)
    Provider name
    Example: "In repellendus enim vel aliquid in."

  - `resources.sensitive_attribute_paths` (array)
    Paths to sensitive attributes
    Example: ["Ipsa quo dolores maxime.","Doloribus nam voluptatem molestiae."]

  - `resources.type` (string, required)
    Resource type
    Example: "Corporis iste fugiat magnam quod."

  - `session_id` (string)
    Session ID to track resource updates belongs to same operation
    Example: "56bf8267-aa77-469e-982f-ba4a6e2031ca"

  - `update_mode` (string)
    Update mode: upsert (default) updates attributes; drift updates drift columns only
    Enum: "upsert", "drift"

## Response 200 fields (application/json):

  - `results` (array, required)
    Example: [{"error":"Quis quae ut atque et nemo.","mode":"Natus a error.","module":"Dicta omnis sint qui.","name":"Neque cumque esse dicta eos in.","provider":"Possimus sed illum illum dicta consequatur.","status":"skipped","type":"Consequatur quia quia et explicabo aut."},{"error":"Quis quae ut atque et nemo.","mode":"Natus a error.","module":"Dicta omnis sint qui.","name":"Neque cumque esse dicta eos in.","provider":"Possimus sed illum illum dicta consequatur.","status":"skipped","type":"Consequatur quia quia et explicabo aut."},{"error":"Quis quae ut atque et nemo.","mode":"Natus a error.","module":"Dicta omnis sint qui.","name":"Neque cumque esse dicta eos in.","provider":"Possimus sed illum illum dicta consequatur.","status":"skipped","type":"Consequatur quia quia et explicabo aut."}]

  - `results.error` (string)
    Example: "Consequatur illum maiores est sit sit."

  - `results.mode` (string, required)
    Example: "Laboriosam accusamus enim quia quis expedita."

  - `results.module` (string, required)
    Example: "Sed atque est minima libero recusandae voluptatem."

  - `results.name` (string, required)
    Example: "Aut quasi dolores deleniti minus aut rerum."

  - `results.provider` (string, required)
    Example: "Impedit dolores animi perferendis minima."

  - `results.status` (string)
    Enum: "updated", "skipped", "failed"

  - `results.type` (string, required)
    Example: "Ea deserunt voluptates eius deserunt."

  - `summary` (object, required)
    Summary of a resource update operation
    Example: {"failed":7816136982411713000,"skipped":8507912447958775000,"total":8568780360306019000,"updated":3222795710095396000}

  - `summary.failed` (integer, required)
    Number of resources that failed to update
    Example: 7816136982411713000

  - `summary.skipped` (integer, required)
    Number of resources skipped
    Example: 8507912447958775000

  - `summary.total` (integer, required)
    Total number of resources processed
    Example: 8568780360306019000

  - `summary.updated` (integer, required)
    Number of resources successfully updated
    Example: 3222795710095396000

## Response 401 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true


