---
title: "Form File Path"
method: POST
path: "/v3.0/private-files/"
tags: ["private-files"]
---

# Form File Path

`POST /v3.0/private-files/`

## Request

- Base URL: `https://api.formaloo.me`
- URL: `https://api.formaloo.me/v3.0/private-files/`
- Auth: none declared. Required headers: `x-api-key`

Use this endpoint to get a permenant url to access a file. The normal url for the files are private and need authentication to be accessed, but the url given in this endpoint is accessible anywhere without any authenrication.

Please be extremely carefull in using this endpoint, as the url you will get should not be shared publicly.

Only the workspace owner can access this endpoint.

**Request Eaxmple**
```
curl --location --request POST 'https://api.formaloo.me/v3.0/private-files/' \
--header 'x-api-key: {API Key}' \
--header 'Authorization: JWT {Auth Token}' \
--header 'Content-Type: application/json' \
--header 'x-workspace: ztOWWXs1' \
--data-raw '{
    "file_path": "https://api.formaloo.me/media/form/dkvLqOHL/file/czkpO3MF/czkpO3MF49875fe9-957e-4abb-a447-aee7fcbf3623.png"
}'
```

**Response Eaxmple**
```
{
    "status": 200,
    "errors": {
        "general_errors": [],
        "form_errors": {}
    },
    "data": {
        "file": "https://s3.amazonaws.com/formaloo-en/s/2025/3/10/czkpO3MF49875fe9-957e-4abb-a447-aee7fcbf3623.png"
    }
}
```

## Headers

- `x-api-key` string, required
- `x-workspace` string

## Request body

- FormFilePathRequest
  - `file_path` string, uri, required: The path of the file given on the form submission data.

## Response `201`

- FormFilePath
  - `file_path` string, uri, required: The path of the file given on the form submission data.

---

[API](https://skmtc.dev/formaloo/apis/formaloo-api-documentation.md) · [All operations](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/revisions/47b268aeb656?raw)