---
title: "Recategorise Business Profile Media"
method: POST
path: "/v2/gbp/update-media/"
tags: ["Manage Google Business Profile"]
---

# Recategorise Business Profile Media

`POST /v2/gbp/update-media/`

## Request

- Base URL: `https://api.localfalcon.com`
- URL: `https://api.localfalcon.com/v2/gbp/update-media/`
- Auth: none declared

Move a photo or video into a different category on a connected Google Business Profile.

Only the category can be changed. `COVER` and `PROFILE` are not accepted here.

## Request body `application/x-www-form-urlencoded`

- object
  - `api_key` string, required: Your Local Falcon API key.
  - `place_id` string, required: The Place ID of a connected location.
  - `media_id` string, required: The media item to recategorise.
  - `category` string, required: New category. Cannot be `COVER` or `PROFILE`.

## Response `200`

Successful response

- object
  - `code` integer
  - `code_desc` union
    - string
    - boolean
  - `success` boolean
  - `message` union
    - string
    - boolean
  - `parameters` object
  - `data` object

## Other responses

- `400`: The request was malformed or missing required parameters.
- `401`: The API key is missing, invalid, or does not have permission for the requested resource.
- `429`: You have exceeded the rate limit. Please wait before making additional requests.
- `500`: An unexpected error occurred on the server. Please try again later.

## Changes

- **2026-09-03** `85390c3f81cf`: 2 info
  - api tag `Manage Google Business Profile` added
  - api tag `Google Business Profile` removed
- **2026-09-02** `ad66f8884700`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/localfalcon/apis/local-falcon-api/changes/v2/gbp/update-media/post.md)

---

[API](https://skmtc.dev/localfalcon/apis/local-falcon-api.md) - [All operations](https://skmtc.dev/localfalcon/apis/local-falcon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/localfalcon/apis/local-falcon-api/revisions/304db93dea96?raw)