Open GoPro

https://gopro.github.io/OpenGoPro
Admin
Open GoPro is an open source API and interface specification for communicating with GoPro cameras,...
Tokens:56,654
Snippets:538
Trust Score:8.3
Update:1 month ago
Show doc for...
Tokens:
Raw
### GET /gopro/webcam/start

Source: https://gopro.github.io/OpenGoPro/http

Starts the webcam stream with specified resolution, field-of-view, port, and protocol settings.

```APIDOC
## GET /gopro/webcam/start

### Description
Starts the webcam stream with specified resolution, field-of-view, port, and protocol settings.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/webcam/start

### Parameters
#### Query Parameters
- **res** (integer) - Optional - Webcam Resolution (e.g., 12 for 1080p)
- **fov** (integer) - Optional - Webcam Field-of-View (e.g., 0 for Wide)
- **port** (integer) - Optional - Port to use for Webcam Stream (Default: 8554)
- **protocol** (string) - Optional - Streaming protocol to use (Enum: "RTSP", "TS")

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/webcam/start?res=12&fov=0&port=8556&protocol=RTSP'

### Response
#### Success Response (200)
- **object** (object) - Request was successfully received by the camera

#### Response Example
{}
```

--------------------------------

### Get Camera Hardware Info Response

Source: https://gopro.github.io/OpenGoPro/http

Example JSON response for the camera info endpoint.

```json
{
  * "ap_mac_addr": "065747046ceb",
  * "ap_ssid": "GP24645504",
  * "firmware_version": "H23.01.01.10.00",
  * "model_name": "Hero12 Black",
  * "model_number": "62",
  * "serial_number": "C3501324645504"

}
```

--------------------------------

### GET /gopro/camera/stream/start

Source: https://gopro.github.io/OpenGoPro/http

Starts the camera preview stream. The camera will begin writing MPEG Transport Stream data to the client on the specified port.

```APIDOC
## GET /gopro/camera/stream/start

### Description
Starts the camera preview stream. The camera will begin writing MPEG Transport Stream data to the client on the specified port.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/stream/start

### Parameters
#### Query Parameters
- **port** (integer) - Optional - Port to use for Preview Stream. Not supported on Hero 11 Black Mini, Hero 11 Black, Hero 10 Black, or Hero 9 Black.

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/stream/start?port=8556'

### Response
#### Success Response (200)
- **object** (json) - Request was successfully received by the camera

#### Response Example
{ }
```

--------------------------------

### Get Camera Date and Time Response

Source: https://gopro.github.io/OpenGoPro/http

Example JSON response for the get_date_time endpoint.

```json
{
  * "date": "2023_12_31",
  * "dst": 0,
  * "time": "11_05_45",
  * "tzone": -480

}
```

--------------------------------

### Set Shutter State via Curl

Source: https://gopro.github.io/OpenGoPro/http

Sends a GET request to start or stop the camera shutter.

```shell
curl --request GET   --url http://10.5.5.9:8080/gopro/camera/shutter/start
```

--------------------------------

### GET /gopro/webcam/preview

Source: https://gopro.github.io/OpenGoPro/http

Initiates the webcam preview stream on the GoPro camera.

```APIDOC
## GET /gopro/webcam/preview

### Description
Initiates the webcam preview stream on the camera. This endpoint is supported on HERO13 Black and other models, with protocol support varying by device.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/webcam/preview

### Request Example
curl --request GET --url http://10.5.5.9:8080/gopro/webcam/preview

### Response
#### Success Response (200)
- Request was successfully received by the camera.

#### Error Response (501)
- Operation not supported on camera model.

#### Response Example
{ }
```

--------------------------------

### GET /gopro/camera/setting

Source: https://gopro.github.io/OpenGoPro/http

Queries or updates a specific camera setting, such as the setup language (ID 223).

```APIDOC
## GET /gopro/camera/setting

### Description
This endpoint allows users to query the current value of a camera setting or update it by providing an option parameter.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The ID of the setting to query or update (e.g., 223 for Setup Language).
- **option** (integer) - Optional - The desired option value to set. If omitted, the current setting is returned.

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=8&setting=223'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option.

#### Response Example
{
  "option": 0
}
```

--------------------------------

### Get Camera Date and Time

Source: https://gopro.github.io/OpenGoPro/http

Retrieves the current date and time from the camera via a GET request.

```shell
curl --request GET   --url http://10.5.5.9:8080/gopro/camera/get_date_time
```

--------------------------------

### Media List Grouped Item Example

Source: https://gopro.github.io/OpenGoPro/http

Example JSON structure representing a grouped media item in the media list.

```json
{
    "id": "2530266050123724003",
    "media": [
        {
            "d": "100GOPRO",
            "fs": [
                {
                    "b": "8",
                    "cre": "1613669353",
                    "g": "1",
                    "l": "396",
                    "m": ["75", "139"],
                    "mod": "1613669353",
                    "n": "G0010008.JPG",
                    "s": "773977407",
                    "t": "t"
                }
            ]
        }
    ]
}
```

--------------------------------

### GET /gopro/camera/setting?setting=236

Source: https://gopro.github.io/OpenGoPro/http

Configures or queries the Automatic Wi-Fi Access Point setting to control if the Wi-Fi AP starts automatically on boot.

```APIDOC
## GET /gopro/camera/setting?setting=236

### Description
Configures or queries the Automatic Wi-Fi Access Point setting.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting?setting=236

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID (236).
- **option** (integer) - Optional - The desired option (0: Off, 1: On). If omitted, the current setting is returned.

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option.

#### Response Example
{
  "option": 0
}
```

--------------------------------

### Get Camera State via cURL

Source: https://gopro.github.io/OpenGoPro/http

Retrieves all current camera settings and statuses using a GET request.

```shell
curl --request GET   --url http://10.5.5.9:8080/gopro/camera/state
```

--------------------------------

### Get Webcam Version

Source: https://gopro.github.io/OpenGoPro/http

Retrieves the current webcam version and metadata from the camera.

```shell
curl --request GET   --url http://10.5.5.9:8080/gopro/webcam/version
```

--------------------------------

### Webcam Version Response

Source: https://gopro.github.io/OpenGoPro/http

Example JSON response for the webcam version request.

```json
{
  * "max_lens_support": true,
  * "usb_3_1_compatible": true,
  * "version": 0

}
```

--------------------------------

### GET /gp/gpControl/command/storage/delete/all

Source: https://gopro.github.io/OpenGoPro/http

Deletes all files currently stored on the camera.

```APIDOC
## GET /gp/gpControl/command/storage/delete/all

### Description
Deletes all files from the camera storage.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gp/gpControl/command/storage/delete/all

### Response
#### Success Response (200)
- **object** - Request was successfully received by the camera

#### Response Example
{ }
```

--------------------------------

### GET /gopro/camera/setting

Source: https://gopro.github.io/OpenGoPro/http

Query or update the Profiles setting.

```APIDOC
## GET /gopro/camera/setting

### Description
Query the current Profile or set a new profile by providing the option parameter.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID, which is 184 for Profiles.
- **option** (integer) - Optional - The desired setting option to set. If omitted, the current setting is returned.

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=0&setting=184'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option.

#### Response Example
{
  "option": 0
}
```

--------------------------------

### Get Hardware Info

Source: https://gopro.github.io/OpenGoPro/docs/ble/query

Retrieves information about the camera model, firmware, and network settings.

```APIDOC
## Get Hardware Info

### Description
Retrieves camera hardware and firmware details including model name, serial number, and AP SSID.

### Command ID
0x3C

### Response Parameters
- **model_number** (unsigned)
- **model_name** (string)
- **firmware_version** (string)
- **serial_number** (string)
- **ap_ssid** (string)
- **ap_mac_address** (string)
```

--------------------------------

### GET /gopro/camera/state

Source: https://gopro.github.io/OpenGoPro/http

Retrieves all current camera settings and statuses.

```APIDOC
## GET /gopro/camera/state

### Description
Get all camera settings and statuses.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/state

### Response
#### Success Response (200)
- **settings** (object) - All currently known setting values indexed by setting ID
- **status** (object) - All currently known status values indexed by status ID

#### Response Example
{
  "settings": {
    "2": 1,
    "3": 0
  },
  "status": {
    "1": 0,
    "2": 0
  }
}
```

--------------------------------

### Get Setting Capabilities (0x32)

Source: https://gopro.github.io/OpenGoPro/docs/ble/query

Retrieves the currently supported capabilities for one or more settings.

```APIDOC
## Get Setting Capabilities (0x32)

### Description
Retrieves the currently supported capabilities for one or more settings. If the element ID array is empty, all settings will be queried.

### Request
- **Query ID**: 0x32
- **Element ID Array**: Array of uint8 Setting IDs to query.

### Response
- **ID**: Setting ID
- **value**: Setting value defined via the individual Setting documentation
```

--------------------------------

### GET /gp/gpControl/command/system/reset

Source: https://gopro.github.io/OpenGoPro/http

Performs a full reboot of the camera, equivalent to a battery pull.

```APIDOC
## GET /gp/gpControl/command/system/reset

### Description
Does a full reboot of the camera (equivalent to battery pull).

### Method
GET

### Endpoint
http://10.5.5.9:8080/gp/gpControl/command/system/reset

### Response
#### Success Response (200)
- **object** - Request was successfully received by the camera

#### Response Example
{ }
```

--------------------------------

### GET /gopro/camera/shutter/{mode}

Source: https://gopro.github.io/OpenGoPro/http

Starts or stops the camera encoding process.

```APIDOC
## GET /gopro/camera/shutter/{mode}

### Description
Starts or stops the camera encoding process.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/shutter/{mode}

### Parameters
#### Path Parameters
- **mode** (string) - Required - Enum: "start", "stop". Start or stop encoding.

### Request Example
curl --request GET --url http://10.5.5.9:8080/gopro/camera/shutter/start

### Response
#### Success Response (200)
- **object** - Request was successfully received by the camera

#### Response Example
{}
```

--------------------------------

### Start Preview Stream Request

Source: https://gopro.github.io/OpenGoPro/http

Initiates the preview stream on the camera, optionally specifying a custom port.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/stream/start?port=8556'
```

--------------------------------

### Get Camera Capabilities

Source: https://gopro.github.io/OpenGoPro/docs/ble/query

Retrieves the camera's capabilities using a Protobuf request.

```APIDOC
## Get Camera Capabilities

### Description
Retrieves camera capabilities. The response includes schema version and protocol-level capabilities.

### Request
- **Feature ID**: 0xF5
- **Action ID**: 0x6C
- **Message**: RequestGetCameraCapabilities

### Response
- **result** (EnumResultGeneric) - Generic pass/fail/error info
- **schema_version** (string) - Capability schema version
- **protocol** (ProtocolCapabilities) - Protocol-level capabilities
```

--------------------------------

### GET /gopro/media/gpmf

Source: https://gopro.github.io/OpenGoPro/http

Retrieves binary GPMF data for a specified media file.

```APIDOC
## GET /gopro/media/gpmf

### Description
Retrieves binary GPMF data associated with a specific media file.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/media/gpmf

### Parameters
#### Query Parameters
- **path** (string) - Required - Media file name (e.g., 100GOPRO/GOPR0002.JPG)

### Response
#### Success Response (200)
- **data** (binary) - Binary GPMF data
```

--------------------------------

### Start Webcam Stream

Source: https://gopro.github.io/OpenGoPro/http

Initiates the webcam stream with specified resolution, field-of-view, port, and protocol parameters.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/webcam/start?res=12&fov=0&port=8556&protocol=RTSP'
```

--------------------------------

### Enter Webcam Preview via Curl

Source: https://gopro.github.io/OpenGoPro/http

Use this command to initiate the webcam preview stream on the camera.

```shell
curl --request GET   --url http://10.5.5.9:8080/gopro/webcam/preview
```

--------------------------------

### RequestGetPresetStatus

Source: https://gopro.github.io/OpenGoPro/docs/ble/protocol/protobuf

Get the set of currently available presets and optionally register to be notified when it changes.

```APIDOC
## RequestGetPresetStatus

### Description
Get the set of currently available presets and optionally register to be notified when it changes.

### Parameters
- **register_preset_status** (EnumRegisterPresetStatus) - Optional - Array of Preset statuses to be notified about
- **unregister_preset_status** (EnumRegisterPresetStatus) - Optional - Array of Preset statuses to stop being notified about
- **use_constant_setting_ids** (bool) - Optional - Configures the set of Setting IDs that are returned by NotifyPresetStatus.
- **include_hidden** (bool) - Optional - Whether to include hidden presets
```

--------------------------------

### Set Video Resolution Setting

Source: https://gopro.github.io/OpenGoPro/http

Example request to set the Video Resolution setting to option 1.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/setting?option=1&setting=2'
```

--------------------------------

### Open GoPro Version JSON Response

Source: https://gopro.github.io/OpenGoPro/http

Example of a successful 200 OK response body containing the version string.

```json
{
  * "version": "2.0"

}
```

--------------------------------

### Response Schema Example

Source: https://gopro.github.io/OpenGoPro/http

JSON structure returned when querying the current setting option.

```json
{
  "option": 0
}
```

--------------------------------

### Get Webcam Status Request

Source: https://gopro.github.io/OpenGoPro/http

Sends a GET request to retrieve the current webcam status and error codes.

```shell
curl --request GET   --url http://10.5.5.9:8080/gopro/webcam/status
```

--------------------------------

### Example Chaptered Media Files

Source: https://gopro.github.io/OpenGoPro/http

A directory listing showing how long videos are split into multiple chapters with consistent Media IDs.

```text
-rwxrwxrwx@ 1 gopro  123456789  4006413091 Jan  1 00:00 GH010078.MP4
-rwxrwxrwx@ 1 gopro  123456789       17663 Jan  1 00:00 GH010078.THM
-rwxrwxrwx@ 1 gopro  123456789  4006001541 Jan  1 00:00 GH020078.MP4
-rwxrwxrwx@ 1 gopro  123456789       17357 Jan  1 00:00 GH020078.THM
-rwxrwxrwx@ 1 gopro  123456789  4006041985 Jan  1 00:00 GH030078.MP4
-rwxrwxrwx@ 1 gopro  123456789       17204 Jan  1 00:00 GH030078.THM
-rwxrwxrwx@ 1 gopro  123456789   756706872 Jan  1 00:00 GH040078.MP4
-rwxrwxrwx@ 1 gopro  123456789       17420 Jan  1 00:00 GH040078.THM
-rwxrwxrwx@ 1 gopro  123456789   184526939 Jan  1 00:00 GL010078.LRV
-rwxrwxrwx@ 1 gopro  123456789   184519787 Jan  1 00:00 GL020078.LRV
-rwxrwxrwx@ 1 gopro  123456789   184517614 Jan  1 00:00 GL030078.LRV
-rwxrwxrwx@ 1 gopro  123456789    34877660 Jan  1 00:00 GL040078.LRV
```

--------------------------------

### Query or Set Video Aspect Ratio

Source: https://gopro.github.io/OpenGoPro/http

Example request for setting the Video Aspect Ratio option to 0.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/setting?option=0&setting=108'
```

--------------------------------

### Set Pairing State (Protobuf)

Source: https://gopro.github.io/OpenGoPro/docs/ble/control

Finishes the initial pairing process to clear the pairing screen on the camera UI.

```APIDOC
## Set Pairing State

### Description
Used to finish the initial pairing process in order to clear the pairing screen on the camera UI.

### Request
- **Feature ID**: 0x03
- **Action ID**: 0x01
- **Message**: RequestPairingFinish

### Fields
- **result** (EnumPairingFinishState) - Required - Pairing state to set
- **phoneName** (string) - Required - Non-empty string identifier

### Response
- **Feature ID**: 0x03
- **Action ID**: 0x81
- **Message**: ResponseGeneric
- **result** (EnumResultGeneric) - Generic pass/fail/error info
```

--------------------------------

### Get Camera Capabilities via cURL

Source: https://gopro.github.io/OpenGoPro/http

Retrieves the camera's capability information using a GET request.

```shell
curl --request GET   --url http://10.5.5.9:8080/gopro/camera/capabilities
```

--------------------------------

### Media List Response Sample

Source: https://gopro.github.io/OpenGoPro/http

Example JSON response for the media list endpoint.

```json
{
  * "id": "1554375628411872255",
  * "media": [
    * {
      * "d": "100GOPRO",
      * "fs": [
        * {
          * "cre": 1696600109,
          * "glrv": 817767,
          * "ls": -1,
          * "mod": 1696600109,
          * "n": "GOPR0001.JPG",
          * "raw": 1,
          * "s": 2806303
}
]
}
]

}
```

--------------------------------

### Get Camera Name via HTTP

Source: https://gopro.github.io/OpenGoPro/http

Retrieve the camera's name using a GET request to the camera name endpoint.

```shell
curl --request GET   --url http://10.5.5.9:8080/gopro/camera/name
```

--------------------------------

### Set Video Lens Setting

Source: https://gopro.github.io/OpenGoPro/http

Example request to set the Video Lens setting to option 4.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/setting?option=4&setting=121'
```

--------------------------------

### GET /gopro/camera/presets/load

Source: https://gopro.github.io/OpenGoPro/http

Loads a specific preset by its ID. The preset must be currently available as determined by the Get Preset Status endpoint.

```APIDOC
## GET /gopro/camera/presets/load

### Description
Loads a preset by ID. A preset can only be loaded if it is currently available.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/presets/load

### Parameters
#### Query Parameters
- **id** (integer) - Required - Preset to load

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/presets/load?id=0'

### Response
#### Success Response (200)
- **object** - Request was successfully received by the camera

#### Response Example
{ }
```

--------------------------------

### Get Media File Thumbnail via cURL

Source: https://gopro.github.io/OpenGoPro/http

Retrieves a thumbnail image for a specific media file using a GET request.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/media/thumbnail?path=100GOPRO/GOPR0002.JPG'
```

--------------------------------

### VideoMetadata JSON Example

Source: https://gopro.github.io/OpenGoPro/http

A sample JSON object representing the full VideoMetadata structure.

```json
{
  "ao": "auto",
  "avc_profile": 0,
  "cl": 0,
  "cre": 1692992748,
  "ct": 0,
  "dur": 42,
  "eis": 0,
  "fov": "string",
  "fps": 1001,
  "fps_denom": 30000,
  "gumi": "12345678998765443211234567899875",
  "h": 1080,
  "hc": 99,
  "hi": [
    1500,
    4700
],
  "lc": 0,
  "ls": -1,
  "mos": [
    "string"
],
  "mp": 0,
  "prjn": 0,
  "profile": 255,
  "progr": 0,
  "pta": 0,
  "rot": 0,
  "s": 1234567890,
  "subsample": 0,
  "tr": 0,
  "us": 0,
  "w": 1920
}
```

--------------------------------

### GET /gopro/camera/presets/set_visibility/v2

Source: https://gopro.github.io/OpenGoPro/http

Shows or hides a specific preset in the camera UI. The visibility status affects how the preset is returned in the Get Available Presets response.

```APIDOC
## GET /gopro/camera/presets/set_visibility/v2

### Description
Shows or hides a Preset in the camera UI.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/presets/set_visibility/v2

### Parameters
#### Query Parameters
- **id** (integer) - Required - Preset to operate on
- **visible** (integer) - Required - Visibility configuration (0 or 1)

### Response
#### Success Response (200)
- Request was successfully received by the camera

#### Response Example
{}
```

--------------------------------

### Set LED Setting via cURL

Source: https://gopro.github.io/OpenGoPro/http

Example request to set the LED setting to option 3.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/setting?option=3&setting=91'
```

--------------------------------

### GET /gopro/camera/name

Source: https://gopro.github.io/OpenGoPro/http

Retrieves the name of the connected GoPro camera.

```APIDOC
## GET /gopro/camera/name

### Description
Retrieves the current name of the GoPro camera.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/name

### Response
#### Success Response (200)
- **value** (string) - The camera name.

#### Response Example
{
  "value": "My Cool Camera"
}
```

--------------------------------

### Query or Set Camera Settings via HTTP

Source: https://gopro.github.io/OpenGoPro/http

Use these examples to interact with the GoPro camera settings API using curl.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/setting?option=0&setting=273'
```

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/setting?option=0&setting=172'
```

--------------------------------

### GET /gopro/camera/stream/stop

Source: https://gopro.github.io/OpenGoPro/http

Stops the active camera preview stream.

```APIDOC
## GET /gopro/camera/stream/stop

### Description
Stops the active camera preview stream.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/stream/stop

### Request Example
curl --request GET --url http://10.5.5.9:8080/gopro/camera/stream/stop

### Response
#### Success Response (200)
- **object** (json) - Request was successfully received by the camera

#### Response Example
{ }
```

--------------------------------

### Verify Root CA Certificate with OpenSSL

Source: https://gopro.github.io/OpenGoPro/docs/ble/cohn

Use the openssl verify command to confirm the validity of the GoPro Root CA certificate.

```bash
$ openssl verify -CAfile '/path/to/GoProRootCA.crt' '/path/to/GoProRootCA.crt'  
GoProRootCA.crt: OK  
```

--------------------------------

### Hilight a Media File via HTTP

Source: https://gopro.github.io/OpenGoPro/http

Adds a tag to an existing media file using the file path and millisecond offset.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/media/hilight/file?path=100GOPRO/GOPR0002.MP4&ms=1'
```

--------------------------------

### GET /gopro/camera/analytics/set_client_info

Source: https://gopro.github.io/OpenGoPro/http

Sets the client information for analytics on the camera.

```APIDOC
## GET /gopro/camera/analytics/set_client_info

### Description
Sets the client as a third-party application for analytics purposes.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/analytics/set_client_info

### Request Example
```bash
curl --request GET --url http://10.5.5.9:8080/gopro/camera/analytics/set_client_info
```

### Response
#### Success Response (200)
- **status** (object) - Request was successfully received by the camera.

#### Response Example
{}
```

--------------------------------

### Get COHN Certificate

Source: https://gopro.github.io/OpenGoPro/docs/ble/cohn

Retrieves the current COHN certificate.

```APIDOC
## Get COHN Certificate

### Description
Get the COHN certificate.

### Request
- **Feature ID:** 0xF5
- **Action ID:** 0x6E
- **Message:** RequestCOHNCert

### Response
- **Feature ID:** 0xF5
- **Action ID:** 0xEE
- **Message:** ResponseCOHNCert
- **Fields:**
  - **result** (EnumResultGeneric) - Was request successful?
  - **cert** (string) - Root CA cert (ASCII text)
```

--------------------------------

### View Certificate Details with OpenSSL

Source: https://gopro.github.io/OpenGoPro/docs/ble/cohn

Display the text details of an SSL/TLS certificate using the openssl x509 command.

```bash
openssl x509 -in /path/to/GoProRootCA.crt -noout -text
```

--------------------------------

### GET /gopro/webcam/exit

Source: https://gopro.github.io/OpenGoPro/http

Exits the current webcam mode on the GoPro camera.

```APIDOC
## GET /gopro/webcam/exit

### Description
Exits the webcam mode on the camera. Supported on USB and WiFi protocols, though WiFi support varies by camera model.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/webcam/exit

### Response
#### Success Response (200)
- Request was successfully received by the camera.

#### Error Response (501)
- Operation not supported on camera model.

### Request Example
curl --request GET --url http://10.5.5.9:8080/gopro/webcam/exit

### Response Example
{ }
```

--------------------------------

### POST /gopro/cohn/cert/create

Source: https://gopro.github.io/OpenGoPro/http

Creates the Camera On the Home Network (COHN) SSL/TLS certificates for secure communication.

```APIDOC
## POST /gopro/cohn/cert/create

### Description
Creates the Camera On the Home Network SSL/TLS certs. The created certificate(s) can be obtained via Get COHN Certificate and used for SSL/TLS communications.

### Method
POST

### Endpoint
http://10.5.5.9:8080/gopro/cohn/cert/create

### Request Body
- **override** (integer) - Required - If 1, replace existing Root CA cert with a newly-generated one.

### Request Example
{
  "override": 0
}

### Response
#### Success Response (200)
- **object** - Request was successfully received by the camera.

#### Response Example
{}
```

--------------------------------

### Set Camera Date and Time via HTTP

Source: https://gopro.github.io/OpenGoPro/http

Configures the camera's internal clock using date, time, timezone, and daylight savings parameters.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/set_date_time?date=2023_12_31&time=21_12_13&tzone=-480&dst=0'
```

--------------------------------

### GET /gopro/camera/setting

Source: https://gopro.github.io/OpenGoPro/http

Query or update the Photo Timelapse Rate setting.

```APIDOC
## GET /gopro/camera/setting

### Description
Query the current Photo Timelapse Rate or set a new rate by providing the option parameter.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID, which is 30 for Photo Timelapse Rate.
- **option** (integer) - Optional - The desired setting option to set. If omitted, the current setting is returned.

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=100&setting=30'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option.

#### Response Example
{
  "option": 0
}
```

--------------------------------

### GET /gopro/camera/setting?setting=91

Source: https://gopro.github.io/OpenGoPro/http

Query or set the LED configuration for the camera.

```APIDOC
## GET /gopro/camera/setting?setting=91

### Description
Query the current LED setting or update it by providing an option parameter.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting?setting=91

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID, which is 91 for LED.
- **option** (integer) - Optional - The desired LED option (e.g., 0 for Off, 2 for On, 3 for All On).

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=3&setting=91'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option.

#### Response Example
{
  "option": 0
}
```

--------------------------------

### GET /gopro/camera/setting (HindSight)

Source: https://gopro.github.io/OpenGoPro/http

Query or set the HindSight duration on the camera.

```APIDOC
## GET /gopro/camera/setting

### Description
Query the current HindSight setting or update it to a new value.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID, which is 167 for HindSight.
- **option** (integer) - Optional - The desired option to set (2: 15 Seconds, 3: 30 Seconds, 4: Off). If omitted, the current setting is returned.

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=2&setting=167'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option (returned when querying).

#### Response Example
{
  "option": 0
}
```

--------------------------------

### Enable Wired USB Control via HTTP

Source: https://gopro.github.io/OpenGoPro/http

Use this endpoint to toggle wired USB control for the camera.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/control/wired_usb?p=0'
```

--------------------------------

### GET /gopro/camera/setting (GPS)

Source: https://gopro.github.io/OpenGoPro/http

Query or set the GPS status on the camera.

```APIDOC
## GET /gopro/camera/setting

### Description
Query the current GPS setting or update it to a new value.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID, which is 83 for GPS.
- **option** (integer) - Optional - The desired option to set (0: Off, 1: On). If omitted, the current setting is returned.

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=1&setting=83'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option (returned when querying).

#### Response Example
{
  "option": 0
}
```

--------------------------------

### SettingCapabilities Data Structure

Source: https://gopro.github.io/OpenGoPro/http

Represents an array of available setting options.

```json
[
  * {
    * "display_name": "string",
    * "id": 0
}

]
```

--------------------------------

### Query or Set Media Format Setting

Source: https://gopro.github.io/OpenGoPro/http

Use this request to set the Media Format (setting 128) to a specific option or query the current value.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/setting?option=13&setting=128'
```

--------------------------------

### GET /gopro/camera/setting?setting=175

Source: https://gopro.github.io/OpenGoPro/http

Queries or sets the Control Mode (175).

```APIDOC
## GET /gopro/camera/setting?setting=175

### Description
Switches the camera between Easy and Pro control modes. Querying this setting returns the current mode, while providing an option updates it.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting?setting=175

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID (175 for Control Mode).
- **option** (integer) - Optional - The desired mode option (0: Easy, 1: Pro).

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=0&setting=175'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option.

#### Response Example
{
  "option": 0
}
```

--------------------------------

### GET /gopro/camera/setting?setting=194

Source: https://gopro.github.io/OpenGoPro/http

Queries or sets the Camera Mode (194).

```APIDOC
## GET /gopro/camera/setting?setting=194

### Description
Queries the current Camera Mode or sets it to a specific option. If the 'option' parameter is omitted, the current setting is returned.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting?setting=194

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID (194 for Camera Mode).
- **option** (integer) - Optional - The desired mode option (0: Single Lens, 1: 360°).

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=0&setting=194'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option.

#### Response Example
{
  "option": 0
}
```

--------------------------------

### GET /gopro/camera/setting?setting=134

Source: https://gopro.github.io/OpenGoPro/http

Queries or sets the Anti-Flicker setting on the camera.

```APIDOC
## GET /gopro/camera/setting?setting=134

### Description
Queries the current Anti-Flicker setting or updates it to a specified option.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting?setting=134

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID (134 for Anti-Flicker).
- **option** (integer) - Optional - The desired option value (0: NTSC, 1: PAL, 2: 60Hz, 3: 50Hz).

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=0&setting=134'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option.

#### Response Example
{
  "option": 0
}
```

--------------------------------

### POST /GoProRootCA.crt

Source: https://gopro.github.io/OpenGoPro/http

Retrieves the GoPro Root CA certificate.

```APIDOC
## POST /GoProRootCA.crt

### Description
Retrieves the SSL COHN Certificate from the camera.

### Method
POST

### Endpoint
http://10.5.5.9:8080/GoProRootCA.crt

### Response
#### Success Response (200)
- **certificate** (string) - SSL COHN Certificate

#### Response Example
-----BEGIN CERTIFICATE-----
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-----END CERTIFICATE----
```

--------------------------------

### GET /gopro/camera/digital_zoom

Source: https://gopro.github.io/OpenGoPro/http

Sets the digital zoom level for the GoPro camera.

```APIDOC
## GET /gopro/camera/digital_zoom

### Description
Adjusts the digital zoom level of the camera.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/digital_zoom

### Parameters
#### Query Parameters
- **percent** (integer) - Required - Zoom Level (0-100)

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/digital_zoom?percent=50'

### Response
#### Success Response (200)
- **object** (json) - Request was successfully received by the camera

#### Response Example
{}
```

--------------------------------

### Load Preset by ID

Source: https://gopro.github.io/OpenGoPro/http

Sends a GET request to load a specific preset ID. The preset must be currently available on the camera.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/presets/load?id=0'
```

--------------------------------

### GET /gopro/camera/control/wired_usb

Source: https://gopro.github.io/OpenGoPro/http

Enables or disables wired camera control over USB.

```APIDOC
## GET /gopro/camera/control/wired_usb

### Description
Enables or disables wired camera control over the USB interface.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/control/wired_usb

### Parameters
#### Query Parameters
- **p** (integer) - Required - If 1, enable wired usb control; If 0, disable usb control

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/control/wired_usb?p=0'

### Response
#### Success Response (200)
- Request was successfully received by the camera

#### Response Example
{ }
```

--------------------------------

### Query or Set Video Easy Mode

Source: https://gopro.github.io/OpenGoPro/http

Use this endpoint to retrieve the current Video Easy Mode setting or update it by providing the option parameter.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/setting?option=3&setting=186'
```

--------------------------------

### Press Button (Command ID: 0x1B)

Source: https://gopro.github.io/OpenGoPro/docs/ble/control

Simulates pressing a physical button on the camera.

```APIDOC
## Press Button

### Description
Simulates pressing a physical button on the camera. The resulting operation matches exactly what happens when the corresponding button is physically pressed.

### Command ID
0x1B

### Parameters
- **button_id** (uint8) - Required - Button to press (0 = shutter, 1 = mode)
- **press_type** (uint8) - Required - Type of button press (0 = short press, 1 = long press)

### Request
UUID: Command

### Response
UUID: Command Response
```

--------------------------------

### GET /gopro/camera/setting?setting=179

Source: https://gopro.github.io/OpenGoPro/http

Queries or sets the Star Trails Length for the camera.

```APIDOC
## GET /gopro/camera/setting?setting=179

### Description
Sets or queries the Star Trails Length setting. If the option parameter is provided, it updates the setting; otherwise, it returns the current configuration.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting?setting=179

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID (179 for Star Trails Length).
- **option** (integer) - Optional - The desired setting value (1: Short, 2: Long, 3: Max).

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=3&setting=179'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option.

#### Response Example
{
  "option": 0
}
```

--------------------------------

### GET /gopro/camera/setting?setting=219

Source: https://gopro.github.io/OpenGoPro/http

Queries or sets the Screen Saver duration for the camera.

```APIDOC
## GET /gopro/camera/setting?setting=219

### Description
Sets or queries the Screen Saver setting. If the option parameter is provided, it updates the setting; otherwise, it returns the current configuration.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting?setting=219

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID (219 for Screen Saver).
- **option** (integer) - Optional - The desired setting value (0: Never, 1: 1 Min, 2: 2 Min, 3: 3 Min, 4: 5 Min).

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=0&setting=219'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option.

#### Response Example
{
  "option": 0
}
```

--------------------------------

### Get Camera Hardware Info

Source: https://gopro.github.io/OpenGoPro/http

Retrieves hardware information such as model name, serial number, and firmware version.

```shell
curl --request GET   --url http://10.5.5.9:8080/gopro/camera/info
```

--------------------------------

### GET /gopro/camera/setting?setting=32

Source: https://gopro.github.io/OpenGoPro/http

Queries or updates the Nightlapse Rate setting for the camera.

```APIDOC
## GET /gopro/camera/setting?setting=32

### Description
Queries the current Nightlapse Rate or updates it to a new frequency value.

### Method
GET

### Endpoint
http://10.5.5.9:8080/gopro/camera/setting?setting=32

### Parameters
#### Query Parameters
- **setting** (integer) - Required - The setting ID, which is 32 for Nightlapse Rate.
- **option** (integer) - Optional - The desired rate option (e.g., 4, 5, 10, 15, 20, 3600). If omitted, the current setting is queried.

### Request Example
curl --request GET --url 'http://10.5.5.9:8080/gopro/camera/setting?option=3600&setting=32'

### Response
#### Success Response (200)
- **option** (integer) - The current setting's option.

#### Response Example
{
  "option": 0
}
```

--------------------------------

### Set Camera Setting via cURL

Source: https://gopro.github.io/OpenGoPro/http

Example request to update the Video Timelapse Rate setting using cURL.

```shell
curl --request GET   --url 'http://10.5.5.9:8080/gopro/camera/setting?option=10&setting=5'
```
Tokens:
Raw