# Create File

Creates a file

Endpoint: POST /sbom/v1/orgs/{orgId}/files
Version: 1.0
Security: GlobalSession_header_Authorization

## Path parameters:

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

## Request fields (application/json):

  - `hashes` (array)
    multiple hash types and values of the file
    Example: [{"type":"MD5/SHA1/SHA3","value":"f7s24f5532b846c37ac6e994255afd624"},{"type":"MD5/SHA1/SHA3","value":"f7s24f5532b846c37ac6e994255afd624"}]

  - `hashes.type` (string)
    Example: "MD5/SHA1/SHA3"

  - `hashes.value` (string)
    Example: "f7s24f5532b846c37ac6e994255afd624"

  - `linkId` (integer)
    id of the other file it's linked to
    Example: 323

  - `linkTypeId` (integer)
    type of link to the other file. Ref: Archetypes api for details.
    Example: 345

  - `name` (string, required)
    name of the file
    Example: "my_file.zip"

  - `path` (string)
    key
    Example: "/source/download"

  - `subTypeId` (integer)
    sub type of the file. Ref: Archetypes api for details.
    Example: 53

  - `typeId` (integer)
    type of file. Ref: Archetypes api for details.
    Example: 2223

## Response 201 fields (application/json):

  - `id` (integer, required)
    ID of the newly created bucket
    Example: 205

## 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 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


