# Update Bucket

Update bucket information for the given bucket id

Endpoint: PUT /sbom/v1/orgs/{orgId}/buckets/{bucketId}
Version: 1.0
Security: GlobalSession_header_Authorization

## Path parameters:

  - `orgId` (integer, required)
    Organization id
    Example: 38808

  - `bucketId` (integer, required)
    bucket id
    Example: 1

## Request fields (application/json):

  - `customFieldValues` (string)
    org specific custom field values for that particular bucket
    Example: "{'filedname1:value2, fieldname2:value2}"

  - `description` (string)
    description of the bucket
    Example: "short description of the bucket"

  - `name` (string)
    pucket Name
    Example: "bucket name"

  - `originId` (integer)
    origin of the bucket. A bucket id from which this bucket was cloned or copied from.
    Example: 1

  - `originTypeId` (integer)
    origin type of the bucket. Ref: Archetypes api for details.
    Example: 1

  - `parentId` (integer)
    parent bucket id
    Example: 1

  - `typeId` (integer)
    type of the bucket. Ref: Archetypes api for details.
    Example: 101

## Response 200 fields (application/json):

  - `bucketType` (string)
    Example: {"category":"bucket_types","id":1,"key":"application","label":"Application","orgId":-1,"source":"spdx"}

  - `createdBy` (string)
    Example: {"email":"adam@server.com","firstName":"Adam","id":2435456,"lastName":"Stone"}

  - `createdOn` (string)
    Example: "2022-07-20 04:55:49"

  - `customFieldValues` (object)
    Example: {"value":"{ field1 : value1 , field2 : value2 }"}

  - `customFieldValues.value` (string)
    Example: "{ field1 : value1 , field2 : value2 }"

  - `description` (string)
    Example: "bucket describption"

  - `id` (integer)
    Example: 205

  - `modifiedBy` (string)
    Example: {"email":"adam@server.com","firstName":"Adam","id":2435456,"lastName":"Stone"}

  - `modifiedOn` (string)
    Example: "2022-07-20 04:55:49"

  - `name` (string)
    Example: "my bucket"

  - `orgId` (integer)
    Example: 38808

  - `originId` (integer)
    Example: 202

  - `originType` (string)
    Example: "null"

  - `originTypeId` (integer)

  - `parentId` (integer)
    Example: 1

  - `trailId` (integer)
    Example: 22

  - `typeId` (integer)
    Example: 1

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

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

  - `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: "server is unable to handle the request"

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

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

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

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

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

  - `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: "server is unable to handle the request"

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

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

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

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

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

  - `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: "server is unable to handle the request"

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

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

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

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

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

  - `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: "server is unable to handle the request"

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

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

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

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

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

  - `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: "server is unable to handle the request"

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

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

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

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

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

  - `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: "server is unable to handle the request"

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

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

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