Skip to content

Add a community's or a public program's place​

POST
/resource-providers/{providerId}/locations

A place where a community's or a public program's help happens (a church hall, a school gym), saved as its location so every listing can reuse it (CM-04). The address resolves now (Find help needs its city); it is public unless is_publicly_visible is false (a safe home), and a listing's confidential switch hides it too. The first open place is the primary. Up to 50. A non-profit or a business answers 409 use_entity_locations: add those in the entity's workspace. A person answers 409 person_has_no_premises (#2436). An audit row, no event. #2422. Checks: requireProviderAccess('manage_resources').

Authorizations​

BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type
HTTP (bearer)

Parameters​

Path Parameters

providerId*

The provider (resource_providers.id).

Type
string
Required
Format
"uuid"

Request Body​

application/json
JSON
{
"label": "Oak Park Community Hall",
"address": {
"line1": "string",
"line2": "string",
"city": "string",
"region": "string",
"postal_code": "string"
},
"point": {
"lat": 0,
"lng": 0
},
"is_publicly_visible": true,
"is_primary": true
}

Responses​

Added

application/json
JSON
"string"

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI

Built with VitePress