Added
Placement Providers API: update by ID and new list filters
March 26th, 2026
Placement providers: update endpoint and list filters
New: PUT /api/v1/placement_providers/:id
PUT /api/v1/placement_providers/:idYou 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 asGET /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
GET /api/v1/placement_providersOptional 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).
