Skip to content

[Feature]: API clients can filter organizations by guid #4380

Description

@norman-abramovitz

Blockers/Dependencies

None.

Background

As an API client (a web console — Stratos — hydrating org entities referenced by other resources)
I want GET /v3/organizations to support the guids filter
So that I can batch-fetch a known set of organizations in one request instead of issuing one GET /v3/organizations/{guid} per org.

Currently supported keys on OrgList are names, order_by, per_page, page; guids is rejected with CF-BadQueryParameter. Cloud controller supports guids on this endpoint per the v3 API docs, and most other Korifi list endpoints (apps, spaces, roles, droplets, packages) already accept guids — organizations is the odd one out.

Acceptance Criteria

GIVEN organizations A and B exist
WHEN I GET /v3/organizations?guids=<A-guid>,<B-guid>
THEN I receive exactly A and B

Dev Notes

Filter allowlist lives in api/payloads/org.go (OrgList.SupportedKeys).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Status
    🧊 Icebox

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions