Postly
  1. Files
Postly
  • Overview
  • Workspaces
    • Fetch workspaces
      GET
  • Socials
    • Fetch socials
      GET
  • Files
    • Upload a file
      POST
    • Fetch files
      GET
    • Delete a file
      DELETE
  • Posts
    • Create a post
      POST
    • Update a post
      POST
    • Fetch a post
      GET
    • Delete a post
      DELETE
    • Fetch posts
      GET
  • Schemas
    • Schemas
      • Requests
        • Posts
          • PostRequest
      • DTOs
        • Schedule
          • OneOffSchedule
          • RecurringSchedule
          • WeekDayMapping
        • Files
          • FileData
        • Posts
          • PlatformPosts
            • Settings
              • BlueskyPostSettings
              • YouTubePostSettings
            • PlatformPost
          • PostTargetPlatform
          • Post
        • Workspaces
          • Workspace
        • Channels
          • Channel
  1. Files

Upload a file

POST
/files
Uploads a binary file and associates it with the specified workspace.

Request

Authorization
API Key
Add parameter in header
X-API-KEY
Example:
X-API-KEY: ********************
or
Header Params

Body Params multipart/form-data

Responses

🟢200FileUploadSucces
application/json
Body

🟠400BadRequestResponse
🟠401UnAuthorizedResponse
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.postly.ai/v1/files' \
--header 'X-File-Size: 29994' \
--header 'X-API-KEY: <api-key>' \
--form 'file=@""'
Response Response Example
200 - FileUploadSuccess
{
    "code": 200,
    "message": "File uploaded successfully",
    "data": {
        "url": "https://files.postly.ai/a.png",
        "type": "image/png"
    }
}
Modified at 2025-11-12 16:18:31
Previous
Fetch socials
Next
Fetch files
Built with