.. index:: Ads, Advertisements

.. _advertisements:

Advertisements
==============

Collection of :ref:`advertisement <advertisement>` representations.

You create new advertisements posting to this collection. To see what fields you should post and what errors you can
expect when creating advertisements look at the documentation for the :ref:`advertisement <advertisement>` resource.


Relations
---------

.. relations::
    .. relation::
        :name: item


Reference
---------

.. endpoint:: GET /v1/advertisements

Collection of advertisements.

.. endpoint:: POST /v1/advertisements

Create a new advertisement.

For updating existing advertisements, please see :ref:`updating an advertisement <updating-advertisements>`.

Examples
--------

.. include:: examples/get-ads-example.rst

.. include:: examples/post-ad-example.rst