---
title: "Update branch status on SuperApp"
method: POST
path: "/branches/{branch_id}/visibility/status"
tags: ["Store API endpoints"]
---

# Update branch status on SuperApp

`POST /branches/{branch_id}/visibility/status`

## Request

- Base URL: `https://apigateway.careemdash.com/pos/api/v1`
- URL: `https://apigateway.careemdash.com/pos/api/v1/branches/{branch_id}/visibility/status`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://identity.careem.com/token` scopes: `pos`
- TypeScript: <https://skmtc.dev/careemnow/apis/careem-pos-api/docs/branches/:branch_id/visibility/status/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this endpoint to update a branch's status on SuperApp.

A branch can hold one of following statuses:
 - `Active (1)`: Branch is active on the platform and customers are able to place orders.
 - `Inactive (2)`: Branch is active on the platform but customers would not be able to place orders.

Please be aware that it may take approximately 5 minutes for the changes to be reflected on the SuperApp.

## Path parameters

- `branch_id` string, required

## Headers

- `Authorization` string, required
- `User-Agent` string, required
- `Brand-Id` string, required

## Request body

- StatusRequest: represents a branch visibility status request
  - `status_id` integer, required: status of the branch which must take effect.

## Response `204`

Branch status updated successfully

## Other responses

- `400`: Bad request
- `404`: Either the brand or branch doesn't exist, or branch is not mapped
- `500`: Internal server error

---

[API](https://skmtc.dev/careemnow/apis/careem-pos-api.md) - [All operations](https://skmtc.dev/careemnow/apis/careem-pos-api/llms.txt) - [OpenAPI document](https://skmtc.dev/careemnow/apis/careem-pos-api/revisions/1bf0e9d19f04?raw)
