confirm role category - vendor

dev-v1

https://test-api.bringthisfood.com/v1

POST

/user/{userId}/role/category/vendor

this sends a request to the store, where the store owner chooses to accept or reject your request;

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠400400 - bad request

🟠401401 - unauthorised

🟠403403 - forbidden

🟠409409 - conflict

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://test-api.bringthisfood.com/v1/user//role/category/vendor' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "storeId": "string",
    "picture": {
        "mimeType": "string",
        "url": "string"
    }
}'

Response Example

200 - Example 1

{
    "success": true,
    "statusCode": 200,
    "data": {
        "user": {
            "id": "string",
            "active": true,
            "locations": [
                {
                    "city": "Ile - Ife (Off Campus)",
                    "street": "Parakin",
                    "description": "Beside AP filling station, KM 4, Ede Road",
                    "coordinates": {
                        "latitude": 0,
                        "longitude": 0
                    }
                }
            ],
            "name": "string",
            "role": {
                "main": "rider",
                "category": "platform",
                "status": "pending"
            },
            "telephone": "+2349012345678",
            "verified": true,
            "picture": {
                "mimeType": "string",
                "url": "string"
            },
            "review": {
                "totalRaters": 0,
                "rating": 0
            },
            "banks": [
                {
                    "code": "string",
                    "name": "string",
                    "account": {
                        "name": "string",
                        "number": "string"
                    },
                    "id": "string"
                }
            ],
            "wallet": {
                "balance": {
                    "currency": "ngn",
                    "amount": 0
                },
                "pin": {
                    "enabled": true
                }
            },
            "orders": {
                "statuses": {
                    "ongoing": {
                        "timestamp": {
                            "start": "2025-10-08T15:30:00.451Z",
                            "end": "2025-10-08T15:30:00.451Z"
                        }
                    },
                    "accepted": {
                        "timestamp": {
                            "start": "2025-10-08T15:30:00.451Z",
                            "end": "2025-10-08T15:30:00.451Z"
                        }
                    }
                },
                "box": {
                    "locked": true
                }
            },
            "email": "string",
            "emailVerified": true,
            "notifications": {
                "push": {
                    "enabled": true
                }
            }
        }
    }
}

Modified at 2025-08-26 13:26:49

confirm role category - platform

post review