Gorilla Dash

arrow_back Back to Knowledge Base

Our Work: portfolio and project posts on the API

download Download PDF

Our Work is the portfolio: the jobs, projects and case studies a tribe wants to show off. GET https://api.gorilladash.com/api/v1/wordpress/tribes/{slug}/our-works lists them, and adding the post slug returns one.

The {slug} in the path is the tribe slug. The second slug on the single-post address is the post's own.

Listing

Takes results_per_page, which defaults to 5. Newest published first.

Only posts that are published and whose publish date has already passed are returned, so you can schedule a case study for next Monday without it leaking early.

ORGANISATION-WIDE WORK IS INCLUDED
The results are the named tribe's own posts plus any posts that belong to the organisation without being attached to a tribe. That is deliberate: head office can publish a flagship project once and have it appear on every tribe's portfolio.

What comes back

FieldNotes
idKey your own records on this — the slug can be edited.
heading, sub_headingThe post title.
slugUse it in your URL and on the single-post call.
excerptShort summary, for the listing tile.
articleThe body.
authorWho wrote it.
post_type, post_text_modeHow the post is meant to be laid out.
client_name, client_urlWho the work was for.
link_full_urlAn external link for the project, if there is one.
starredWhether it is highlighted. Useful for a featured row.
published_atWhen it went live.
meta_title, meta_descriptionFor your page head.
square_urlThe tile image.
galleryAn array of image URLs.

One post

GET /wordpress/tribes/{slug}/our-works/{postSlug} returns the same fields for a single post, and answers 404 if the post is not published, not yet due, or does not belong to that tribe or organisation.

Building a portfolio page

  1. Call the list for the index and render square_url and excerpt as tiles.
  2. Sort or filter on starred if you want a featured row above the rest.
  3. Link each tile to your own URL built from the post slug.
  4. Call the single-post endpoint when a visitor opens one, and render article plus the gallery.

Both endpoints are cached and send an ETag, so a newly published project can take a few minutes to appear.