Media

An AI client cannot send a file. It can only send text. So a photo, a video or a document that you want to post has to reach the server another way first. It goes into your media library, and the AI client then posts it by its name.

The library is yours alone. Nobody else's AI client can find or post your files. Facebook, Instagram and LinkedIn posts all use the same library.

Three ways to get a file in

Putting a file in the library posts nothing. It also works for a user without write access, and while the server is read-only.

Upload it on the Media page

1. Open Media.
2. Under Upload, choose the file.
3. Press Upload.

The page answers with the file's media id. Then tell the AI client the file's name:

Post launch.jpg from my media to the Acme Facebook Page, as a draft.

Let the AI client add it from an address or a folder

Add the image at https://example.com/launch.jpg to my media.

• From an address. The address has to be a public HTTPS address. The server downloads the file and keeps it. An address on the server's own network is refused.
• From a media folder. When the AI client runs on the server's own machine, it can take a file by its path, but only from a folder that an administrator has opened for that. Any path outside those folders is refused. No folder is open by default: see For the administrator.

An upload link

An AI client that can run commands on your computer, such as a coding assistant, can ask the server for an upload link and send the file to it with one command.

Upload C:\Marketing\launch.jpg to my media, then draft an Instagram post with it.

The link:

• takes one file;
• lasts 15 minutes;
• works once. Even an attempt that fails uses it up, and the AI client then asks for a new one;
• adds to your own library only. It cannot post anything.

WARNING

The link is the permission: whoever holds it can add one file to your library. Do not share it.

A chat assistant that cannot run commands cannot use an upload link. Upload on the Media page instead.

What the library takes

File	Facebook	Instagram	LinkedIn
JPEG image	Yes	Yes	Yes
PNG image	Yes	Converted first, when you ask	Yes
MP4 video	Yes	Yes	Yes
MOV video	Yes	Yes	No
PDF document	No	No	Yes

The type is read from the file's contents, not from its name. A file of any other type is not kept.

The largest file is 100 MB unless an administrator changed it. The platforms have their own limits as well, and the preview says when a file is outside one.

The Media page

Your files lists what is in your library:

Column	Meaning
File	The file's name.
Media id	The id the AI client posts it by. Copy copies it.
Kind	Image, video or document.
Size	The file's size.
Uploaded	When it arrived.
Last posted	When it was last used in a post, or "never".

Delete removes the server's copy. Anything already posted from it stays posted.

You can name a file to the AI client by its file name or by its media id.

Instagram and images from your library

Instagram does not accept an image upload. It fetches the image from an address. So for an image from your library, the server gives Instagram a private, one-time address on itself, and Instagram has to be able to reach it.

That works only when the server has a public address that starts with https://. Without one, an Instagram post with a library image is refused, and the refusal says why. It is not a limit and not a switch: the server simply has no address that Instagram can reach.

What to do:

• Ask your administrator to set the public address on Server. See Server settings.
• Or give the image as a public HTTPS address of its own, not from the library.

This applies to images only, and to an image used as a reel's cover. A video from your library is uploaded to Instagram directly and needs no public address. Facebook and LinkedIn take library files directly too.

PNG images and Instagram

Instagram takes JPEG images only. A PNG from your library is refused for Instagram unless you ask for it to be converted:

Post logo.png to Acme's Instagram. Convert it to JPEG.

Then the server posts a JPEG copy.

• Transparent areas become white.
• Your library keeps the original PNG.
• The copy is temporary. The server removes it afterwards.

The server never converts without being asked, because the result can look different. The AI client tells you before it does.

Conversion is for a file from your library or from a media folder. An image at an address is sent as it is, so it has to be a JPEG already.

Videos are measured

For a video from your library, the server reads its length and frame size from the file and checks them in the preview:

Kind of post	Length	Other
Facebook reel or story	3 to 90 seconds	At least 540 by 960
Instagram reel	3 seconds to 15 minutes	Up to 300 MB, at most 1,920 wide
Instagram story	3 to 60 seconds	Up to 100 MB, at most 1,920 wide
LinkedIn video	Not measured here. LinkedIn asks for 3 seconds to 30 minutes	MP4 only, up to 500 MB

A video outside what the platform requires is refused in the preview. One that only misses a recommendation, such as the vertical 9:16 shape, gets a warning.

A video at an address is not inspected at all. The platform fetches it and is the first to judge it, and the preview says so.

How long files are kept

A file is removed 30 days after it was last uploaded or posted, unless an administrator changed that. The Media page says what applies on your installation.

• Posting a file again starts its 30 days again.
• A file that a queued post or a LinkedIn draft still needs is kept until that post has gone out.
• Removing a file removes the server's copy only. Nothing already posted is affected.

For the administrator

Limits. On Safety limits, under Posting limits:

Limit	Starts at	Empty means
Largest media upload, MB	100	No limit
Keep uploaded media, days	30	Kept until deleted

Press Save posting limits. See Limits and switches.

Media folders. No folder is open until you name one:

1. Open Meta app.
2. Under Media folders, type one folder on each line.
3. Press Save folders.

Name a folder that holds only what may be posted

An AI client can be asked, by something it reads, to post a file. Media folders are what stops it from reaching every picture the server can see. Name a marketing folder. A whole drive or a home folder is refused.

The public address. Library images reach Instagram only when Public URL on Server starts with https://.

Where the library itself is kept, and the environment variables for all of this, are in Server settings and Settings.