# Add Request Prooflink

Endpoint: POST /{requestId}/prooflink
Version: 1.0
Security: oauth2

## Path parameters:

  - `requestId` (string, required)
    Unique ID of the request to link the proof to.

## Response 200 fields (application/json):

  - `id` (string, required)
    The unique identifier for the proof item
    Example: "4eb909de-51af-11ee-a644-522476618ae8"

  - `orgId` (string, required)
    The unique identifier of the organization
    Example: "ce83e3cd-5199-11ee-a644-522476618ae8"

  - `filename` (string, required)
    Name of the uploaded file
    Example: "access-control-policy.pdf"

  - `nameOverride` (string)
    Name of the proof item as set by the user
    Example: "Access Control Policy"

  - `contentType` (string, required)
    MIME type of the file (e.g., text/plain)
    Example: "application/pdf"

  - `fileExtension` (string)
    File extension (e.g., txt)
    Example: "pdf"

  - `size` (integer, required)
    File size in bytes
    Example: 102400

  - `version` (integer)
    Version of the proof item

  - `source` (string)
    Source of the file (e.g., localComputer)
    Example: "localComputer"

  - `sourceVersion` (integer)
    The version of the proof maintained by the source system

  - `ownedBy` (string)
    The unique identifier of the user who owns the proof item
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `isPrivate` (boolean)
    Whether the proof item is private

  - `uploadedOn` (string)
    The date the proof was uploaded (ISO-8601 format)
    Example: "2024-10-01 08:00:00+00:00"

  - `objectId` (string, required)
    The unique identifier of the object this proof is linked to
    Example: "d4e5f6a7-b8c9-0123-abcd-ef4567890123"

  - `objectType` (string, required)
    The type of the object.
    Enum: "assessment", "audit", "connection", "control", "controlScope", "domain", "freshnessHistory", "exportFile", "label", "organization", "organizationUser", "policy", "program", "proof", "request", "requirement", "risk", "riskRegister", "section", "task", "scope", "template", "user"

  - `proofLinkId` (string)
    The unique identifier of the proof link
    Example: "f1a2b3c4-d5e6-7890-abcd-ef1234567890"

  - `proofLinkCreatedOn` (string)
    The date the proof link was created (ISO-8601 format)
    Example: "2024-10-02 09:00:00+00:00"

  - `proofLinkCreatedBy` (string)
    The unique identifier of the user who created the proof link
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `proofLinkStatus` (string)
    The status of the object.
    Enum: "active", "archived", "pending", "canceled", "deleted", "closed"

  - `status` (string, required)
    The status of the object.
    Enum: same as `proofLinkStatus` (6 values)

  - `createdBy` (string)
    The unique identifier of the user who created the proof item
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `createdOn` (string, required)
    The date the proof was created (ISO-8601 format)
    Example: "2024-10-01 08:00:00+00:00"

  - `updatedBy` (string)
    The unique identifier of the user who last updated the proof item
    Example: "82d7c228-8bcd-11e9-a94b-ab3de8494987"

  - `updatedOn` (string, required)
    The date the proof was last updated (ISO-8601 format)
    Example: "2024-10-01 08:00:00+00:00"


## Response 401 fields

## Response 403 fields

## Response 404 fields