SEsearchable
Brand

Set the default location

Changed on

Change an existing project's default location: the app's Knowledge Base Location. Send the country, plus a state or city where it matters, the same way project creation takes them; a country alone makes the whole country the default. The state or city is looked up and the place found is saved, never the text sent (austin with state: "TX" is saved as Austin, Texas). A state or city that can't be placed changes nothing: 400 location_not_placed for one that isn't recognised or a US city found in more than one state without its state, 503 location_lookup_failed when the lookup is unavailable. Tracked prompts that use the default move to the new place from their next run, and so do prompts whose only location is the old default; prompts with any other location keep them. Answers already collected stay under the place they were collected for. dryRun: true previews the change without making it. Needs the Member role and the knowledge:manage capability. A pitch project that is not currently active refuses with 409 INACTIVE_PITCH_PROMPT_MUTATION.

put/api/mcp/projects/{projectId}/default-location

Request

  • Base URL
    https://app.searchable.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

The project id.

Request body

countrystring required

ISO 3166-1 alpha-2 country code, e.g. US. Alone, it makes the whole country the default.

statestring

The state: alone for the whole state (e.g. California), or with city for the state the city is in (e.g. Oregon for Portland). A US code such as TX works; elsewhere write the name.

citystring

The city, e.g. Austin. A state's name here is taken as the state. A US city found in more than one state needs state.

dryRunboolean

Preview the change without making it.

Response

The default location was changed, or would be on a dry run.

successboolean

Present when the change was made (not on a dry run).

dryRunboolean

Present, true, on a dry run.

changedboolean

false when the place already was the default. Absent on a dry run.

previousLocationstring nullable required

The previous default, as the app names it.

promptsMovedinteger required

Tracked prompts that moved to the new place (would move, on a dry run).

promptsKeepingOwnLocationinteger required

Tracked prompts that keep their own location.

Changes