Get file - Mavera

GET

/

files

/

{id}

Get file

curl --request GET \
  --url https://app.mavera.io/api/v1/files/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.mavera.io/api/v1/files/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.mavera.io/api/v1/files/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "object": "file",
  "name": "<string>",
  "url": "<string>",
  "type": "<string>",
  "size": 123,
  "workspace_id": "<string>",
  "folder_id": "<string>",
  "folder": {
    "id": "<string>",
    "name": "<string>"
  },
  "thumbnail_url": "<string>",
  "metadata": {},
  "is_favorite": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

Authorizations

Authorization

string

header

required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Path Parameters

id

string

required

File ID

Response

File details

A file/asset stored in Mavera

id

string

Unique file identifier

object

enum<string>

Available options:

file

name

string

File name

url

string<uri>

Direct URL to access the file

type

string

MIME type of the file (e.g., 'image/png', 'application/pdf')

size

integer | null

File size in bytes

source

enum<string>

Source of the file upload

Available options:

upload,

google_drive,

dropbox,

dropbox_chooser,

onedrive,

onedrive_picker,

url

workspace_id

string

Workspace ID

folder_id

string | null

Folder ID if file is in a folder

folder

object | null

Folder details if file is in a folder

Show child attributes

thumbnail_url

string<uri> | null

Thumbnail URL for images/videos

metadata

object | null

Custom metadata attached to the file

is_favorite

boolean

Whether the file is in your favorites

created_at

string<date-time>

updated_at

string<date-time>

Create file record

⌘I

Get file

curl --request GET \
  --url https://app.mavera.io/api/v1/files/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.mavera.io/api/v1/files/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.mavera.io/api/v1/files/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "object": "file",
  "name": "<string>",
  "url": "<string>",
  "type": "<string>",
  "size": 123,
  "workspace_id": "<string>",
  "folder_id": "<string>",
  "folder": {
    "id": "<string>",
    "name": "<string>"
  },
  "thumbnail_url": "<string>",
  "metadata": {},
  "is_favorite": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}