Skip to content

Upload a file to a group

POST
/api/v4/groups/{id}/uploads

Uploads a file to the specified group. Returns a markdown-formatted link to the file.

id
required
One of:
string

The ID or URL-encoded path of the group

Media type multipart/form-data
object
file
required

The file to upload

string format: binary
nullable

Created

Media type application/json
object
id

The ID of the file

integer format: int64
alt

The name of the file

string
url

The URL to access the file

string
full_path

The full path to the file

string
markdown

A markdown-formatted link to the file.

string
Example generated
{
"id": 1,
"alt": "example",
"url": "example",
"full_path": "example",
"markdown": "example"
}

Bad request

Not found