# Generate invitation link for the Data Request

Generate a shareable invitation link for the Data Request. 
You can share the invitation link with the Individual for them to complete the Data Request. The invitation link will direct the user to MeasureOne's hosted solution. 

* If there is a invitation link with status  available, it will return the same invitation link. Generating a invitation link when there is already existing  available. it  will return the same invitation link with the   updated as provided. 
* It will generate a new invitation link if there are no  links available for the Data Request.


Endpoint: POST /v3/datarequests/generate_invitation_link
Version: 3.0
Security: Bearer

## Header parameters:

  - `version` (number)
    Version number of the MeasureOne API you wish to integrate.

  - `Authorization` (string)
    Authorization API Key

  - `Content-type` (string)
    Content-type of the request payload. MeasureOne accepts content in application/json format unless specified otherwise

## Request fields (application/json):

  - `id` (string, required)
    Unique ID of the Data Request identified by MeasureOne
    Example: "dr_1faOM8Q4efEWIjzdE2SBM2kLq4O"

  - `expires_at` (number)
    Timestamp in milliseconds at which the link expires. If not provided, it will take system default i.e. now() + default expiration from your account preferences. The link status will remain ACTIVE till it is either   OR 'EXPIRED'
    Example: 1675605305012

## Response 200 fields (application/json):

  - `id` (string)
    Unique ID of the Data Request identified by MeasureOne
    Example: "dr_1faOM8Q4efEWIjzdE2SBM2kLq4O"

  - `uri` (string)
    URI of the invitation link generated by MeasureOne
    Example: "https://link.measureone.com/2RQSeNYvTeNMLvdY2kLeNtMOyrI"

## Response 400 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 401 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 404 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 405 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds
    Example: 1655227025839

  - `error_code` (string)
    MeasureOne Error code
    Example: "METHOD_NOT_ALLOWED"

  - `error_message` (string)
    Details of the error
    Example: "Given Method not allowed"

## Response 500 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error