boards

List board sections

Get a list of all board sections from a board owned by the "operation user_account" - or a group board that has been shared with this account. Optional: Business Access: Specify an ad_account_id to use the owner of that ad_account as the "operation user_account".

  • By default, the "operation user_account" is the token user_account.
get/boards/{board_id}/sections

Path parameters

board_idstring required

Unique identifier of a board.

Query parameters

ad_account_idstring

Unique identifier of an ad account.

bookmarkstring

Cursor used to fetch the next page of items

page_sizeinteger

Maximum number of items to include in a single page. See documentation on Pagination for more information.

Response

The request has succeeded.

bookmarkstring nullable

Example response

{
  "items": [
    {
      "id": "549755885175",
      "name": "Salads"
    }
  ]
}

Changes

Changed in 7 of the 29 revisions of this API.312

  • v5b698c180678a18See the full diff
    • the response's body type/format changed from / to object/ for status 200

      response-body-type-changed

    • removed Paginated subschema #2 from the response body allOf list for the response status 200

      response-body-all-of-removed

    • added the non-success response with the status 400

      response-non-success-status-added

    • added the non-success response with the status 401

      response-non-success-status-added

    • added the non-success response with the status 403

      response-non-success-status-added

    • added the non-success response with the status 404

      response-non-success-status-added

    • added the non-success response with the status 429

      response-non-success-status-added

    • added the optional property bookmark to the response with the 200 status

      response-optional-property-added

    • added the required property items to the response with the 200 status

      response-required-property-added

    This revision also has 182 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • the endpoint scheme security client_credentials was added to the API

      api-security-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • the allOf[subschema #2]/ response's property type/format changed from / to object/ for status 200

      response-property-type-changed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • the response property allOf[subschema #2]/items/items/name became required for the status 200

      response-property-became-required

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new optional query request parameter ad_account_id

      new-optional-request-parameter

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • for the query request parameter page_size, the max was increased from 100.00 to 250.00

      request-parameter-max-increased

    • added the pattern ^\d+$ to the path request parameter board_id

      request-parameter-pattern-added