Media

Last updated on Feb 05, 2025

List media files

Method: GET

URLhttps://app.allpost.co/in/api/<workspaceUuid>/media?page=1

AuthorizationBearer <token>

Response: 200

{
  "data": [
    {
      "id": "2",
      "uuid": "161b8c2d-c424-3a6a-b554-be277418ff08",
      "name": "tea-reduced-file-size.mp4",
      "mime_type": "video/mp4",
      "type": "video",
      "url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7.mp4",
      "thumb_url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7-thumb.jpg",
      "is_video": true,
      "created_at": "2024-03-29 15:33:32"
    },
    {
      "id": "1",
      "uuid": "511b8c2d-c424-3a6a-a154-be271418ff01",
      "name": "blue.png",
      "mime_type": "image/png",
      "type": "image",
      "url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
      "thumb_url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.png",
      "is_video": false,
      "created_at": "2024-03-29 15:33:23"
    }
  ],
  "links": {
    "first": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media?page=1",
    "last": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": null,
        "label": "&laquo; Previous",
        "active": false
      },
      {
        "url": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": null,
        "label": "Next &raquo;",
        "active": false
      }
    ],
    "path": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media",
    "per_page": 20,
    "to": 2,
    "total": 2
  }
}

Response: 401

{
  "message": "Unauthenticated."
}

Response: 403

{
  "message": "Access forbidden."
}

Response: 404

{
  "message": "Workspace not found."
}

Get a media file

Method: GET

URLhttps://app.allpost.co/in/api/<workspaceUuid>/media/<mediaUuid>

AuthorizationBearer <token>

Response: 200

{
  "id": "1",
  "uuid": "511b8c2d-c424-3a6a-a154-be271418ff01",
  "name": "blue.png",
  "mime_type": "image/png",
  "type": "image",
  "url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
  "thumb_url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.png",
  "is_video": false,
  "created_at": "2024-03-29 15:33:23"
}

Response: 401

{
  "message": "Unauthenticated."
}

Response: 403

{
  "message": "Access forbidden."
}

Response: 404

{
  "message": "Workspace not found."
}
{
  "message": "Media not found."
}

Upload a media file

Method: POST

URLhttps://app.allpost.co/in/api/<workspaceUuid>/media

AuthorizationBearer <token>

Body:

{
  "file": binary,
}

Key: file

Format: binary

Required: required

Description: File binary

Response: 200

{
  "id": "1",
  "uuid": "511b8c2d-c424-3a6a-a154-be271418ff01",
  "name": "blue.png",
  "mime_type": "image/png",
  "type": "image",
  "url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
  "thumb_url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.png",
  "is_video": false,
  "created_at": "2024-03-29 15:33:23"
}

Response: 401

{
  "message": "Unauthenticated."
}

Response: 403

{
  "message": "Access forbidden."
}

Response: 404

{
  "message": "Workspace not found."
}

Response: 422

{
  "message": "Validation errors",
  "errors": {}
}

Delete a media file

Method: DELETE

URLhttps://app.allpost.co/in/api/<workspaceUuid>/media

AuthorizationBearer <token>

Params:

{
  "items": [1,2]
}

Key: items

Format: array

Required: required

Description: Array of media file IDs


Key: items.*

Format: integer

Required: required

Description: Media File ID

Response: 200

{
  "success": true
}

Response: 401

{
  "message": "Unauthenticated."
}

Response: 403

{
  "message": "Access forbidden."
}

Response: 404

{
  "message": "Workspace not found."
}

Response: 422

{
  "message": "Validation errors",
  "errors": {}
}