XExenforo-ltd
Media albums

Create an album

Changed on

Create an album.

post/media-albums/

Request

Request body application/x-www-form-urlencoded

titlestring required
descriptionstring
category_idinteger
view_privacystring

Privacy level for viewing: public, members, shared, private

view_user_idsinteger[]

User IDs who can view when view_privacy is "shared"

add_privacystring

Privacy level for adding media: public, members, shared, private

add_user_idsinteger[]

User IDs who can add when add_privacy is "shared"

Response

OK

successboolean

Changes

  • e271d0e41f6dRevision changes
    • breaking

      request body became required

    • breaking

      removed the media type application/json from the request body

    • breaking

      the response's property type changed from string to boolean for status

    • info

      api operation id post_media_albums_ removed and replaced with postMediaAlbums

    • info

      the endpoint scheme security XF-Api-Key was added to the API

    • info

      the endpoint scheme security XF-OAuth2 was added to the API

    • info

      added the new optional header request parameter XF-Api-User to all path's operations

    • info

      added the new optional query request parameter api_bypass_permissions to all path's operations

  • 0f490cfb7931Revision changes
    • info

      api tag Media albums added

    • info

      api tag media-albums removed

    • info

      added optional request body

    • info

      added the media type application/json for the response with the status