> For the complete documentation index, see [llms.txt](https://developer.prodege.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.prodege.com/demand/api-reference/project-calls/project-multi-links.md).

# Project Multi-Links

| **Project Multi Link Upload** |                                                    |
| ----------------------------- | -------------------------------------------------- |
| Description                   | Update a projects's settings                       |
| Request URL                   | *Prodege Base URL +* /project-multi-link-upload    |
| Request Method                | <mark style="background-color:orange;">POST</mark> |

&#x20;

| Request Parameters   |                |                                                                                                            |           |
| -------------------- | -------------- | ---------------------------------------------------------------------------------------------------------- | --------- |
| Parameter Name       | Parameter Type | Description                                                                                                | Required? |
| apik                 | String         | Your API Key.                                                                                              | Yes       |
| request\_date        | Numeric        | Timestamp in milliseconds (see [Authentication](https://developer.prodege.com/demand/authentication)).     | Yes       |
| signature            | String         | The signature of your request (see [Authentication](https://developer.prodege.com/demand/authentication)). | Yes       |
| prodege\_project\_id | Numeric        | The ID that uniquely identifies this project in the Prodege system.                                        | Yes       |
| multi\_link\_entries | array          | JSON array of multi link entries.                                                                          | Yes       |

&#x20;

| Response Parameters  |                |                                                                    |
| -------------------- | -------------- | ------------------------------------------------------------------ |
| Parameter Name       | Parameter Type | Description                                                        |
| *return\_status*     | String         | The return status for this api call                                |
| prodege\_project\_id | Numeric        | The id that uniquely identifies this project                       |
| available\_links     | Numeric        | The number of unique survey entry links available for this project |

*multi\_link\_entries Element Model*

| Property Name | Property Type | Description                                                                      |
| ------------- | ------------- | -------------------------------------------------------------------------------- |
| row\_id       | Numeric       | The id that uniquely identifies a multi link entry for this current request      |
| survey\_url   | String        | A unique entry link for the survey (url must have “%transid%” placeholder in it) |

&#x20;

| **Delete Available Links** |                                                      |
| -------------------------- | ---------------------------------------------------- |
| Description                | Delete all unused entry links of an existing project |
| Request URL                | *Prodege Base URL +* /project-delete-available-links |
| Request Method             | <mark style="background-color:orange;">POST</mark>   |

&#x20;

| Request Parameters   |                |                                                                                                     |
| -------------------- | -------------- | --------------------------------------------------------------------------------------------------- |
| Parameter Name       | Parameter Type | Required?                                                                                           |
| apik                 | String         | Yes                                                                                                 |
| request\_date        | Numeric        | Yes (in milliseconds)                                                                               |
| signature            | String         | Yes (see [Authentication ](https://developer.prodege.com/demand/authentication)section for details) |
| prodege\_project\_id | Numeric        | Yes                                                                                                 |

| Response Parameters  |                |                                              |
| -------------------- | -------------- | -------------------------------------------- |
| Parameter Name       | Parameter Type | Description                                  |
| *return\_status*     | String         | The return status for this api call          |
| prodege\_project\_id | Numeric        | The id that uniquely identifies this project |
| deleted\_links       | Numeric        | The number of survey entry links deleted     |

| **Get Available Links** |                                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------- |
| Description             | Get a (count of / comma-separated list) all unused entry links of an existing project |
| Request URL             | *Prodege Base URL +* /project-available-links                                         |
| Request Method          | <mark style="background-color:orange;">GET</mark>                                     |

&#x20;

| Request Parameters   |                |                                                                                                     |
| -------------------- | -------------- | --------------------------------------------------------------------------------------------------- |
| Parameter Name       | Parameter Type | Required?                                                                                           |
| apik                 | String         | Yes                                                                                                 |
| request\_date        | Numeric        | Yes (in milliseconds)                                                                               |
| signature            | String         | Yes (see [Authentication ](https://developer.prodege.com/demand/authentication)section for details) |
| prodege\_project\_id | Numeric        | Yes                                                                                                 |
| fetch\_option        | String         | No (Possible values: "count" (default), "list")                                                     |

&#x20;

| Response Parameters  |                |                                              |
| -------------------- | -------------- | -------------------------------------------- |
| Parameter Name       | Parameter Type | Description                                  |
| *return\_status*     | String         | The return status for this api call          |
| prodege\_project\_id | Numeric        | The id that uniquely identifies this project |
| available\_links     | Varies         | Depends on fetch option                      |

\*available\_links could return either: - a Numeric value (for fetch\_option value of “count”), or; - a comma-separated list of survey urls (for fetch\_option value of “list”)<br>