# PostgREST 9

[Supabase](https://yomu.fyi/company/supabase) · Steve Chavez · Nov 27, 2021

**Type:** Announcement

## Summary

PostgREST 9 introduces several core updates to the tool that turns PostgreSQL databases into RESTful APIs. Developers can now perform inner joins when embedding tables using the !inner keyword, allowing top-level table rows to be filtered directly by embedded table attributes across multiple operators. The release also adds support for POST requests to functions containing a single unnamed parameter, which simplifies handling raw JSON payloads sent by external webhooks. To ensure compatibility with PostgreSQL 14, custom authentication functions accessing HTTP context headers and JWT claims must be updated to parse JSON properties from consolidated settings. Additional enhancements included in this version provide support for partitioned tables alongside documentation improvements and bug fixes.

## Context

PostgREST converts PostgreSQL databases automatically into RESTful APIs, but prior versions lacked native support for inner joins on embedded tables and required named parameters for PostgreSQL functions invoked via RPC.

## Approach / What changed

PostgREST 9 introduces the !inner keyword for embedding tables to filter top-level rows by embedded table filters, enables POST requests to PostgreSQL functions with a single unnamed parameter, and updates HTTP context settings for PostgreSQL 14 compatibility.

## Takeaways

- The !inner keyword allows filtering top-level table queries based on conditions applied to embedded tables across all Supabase client libraries.
- PostgREST 9 supports POST requests to PostgreSQL functions with a single unnamed parameter, enabling direct ingestion of raw JSON webhook payloads.
- PostgreSQL 14 compatibility requires custom authentication functions to read request.jwt.claims and request.headers as JSON objects rather than individual claim or header settings.

**Tags:** [Open Source](https://yomu.fyi/topic/open-source), [Postgres](https://yomu.fyi/topic/postgres), [REST APIs](https://yomu.fyi/topic/rest-api)

[Read original post](https://supabase.com/blog/postgrest-9)