Added

Placement Providers API: update by ID and new list filters

Placement providers: update endpoint and list filters

New: PUT /api/v1/placement_providers/:id

You can update selected fields on a placement provider for your agency.

This endpoint only changes data your agency holds on that provider. To update license information (for example a license’s external identifier), use the licenses API instead.

Request body (data.attributes — all optional; include at least one field when updating):

  • provider-external-identifier -- Your agency’s external identifier for this provider. Send an empty string to clear it.
  • provider-profile-custom-field-values -- Object whose keys are custom field slugs and whose values are the values to save on the provider profile for your agency.

Responses:

  • 200 OK -- Success. The response uses the same shape as GET /api/v1/placement_providers/:id.
  • 422 Unprocessable Entity -- Validation or schema error, or this placement provider cannot be updated for your agency (for example, it is not associated with your agency).

New: filters on GET /api/v1/placement_providers

Optional query parameters limit which placement providers are returned. Pagination and other list behavior are unchanged.

  • license_external_identifier -- Only providers with a license whose external identifier matches this value.
  • provider_external_identifier -- Only providers where your agency’s provider external identifier matches this value.
  • license_id -- Only providers linked to the license with this ID (the same license ID you use in other API responses).