---
title: "Submit Athena payload"
method: POST
path: "/{dongleId}"
tags: ["athena"]
---

# Submit Athena payload

`POST /{dongleId}`

## Request

- Base URL: `https://athena.comma.ai`
- URL: `https://athena.comma.ai/{dongleId}`
- Auth: HTTP bearer

Send JSON-RPC requests to the active websocket connection for a given device, identified by its dongle ID.

Some method types support offline queueing of messages until the device comes online (see `expiry`). The
response will indicate whether the message was queued or not.

## Request body

- union
  - object
    - `method` 'getMessage', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
    - `params` object, required
      - `service` string, required: service name
      - `timeout` integer: time to wait for a message in milliseconds
  - object
    - `method` 'getVersion', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
  - object
    - `method` 'setNavDestination', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
    - `params` NavigationDestination, required
      - `place_name` string, required: Short name of destination
      - `place_details` string, required: Address details of destination. Should not include short name.
      - `latitude` number, required: Latitude, decimal degrees
      - `longitude` number, required: Longitude, decimal degrees
  - object
    - `method` 'reboot', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
  - object
    - `method` 'uploadFilesToUrls', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
    - `params` object[], required
      - `fn` string, required
      - `url` string, required
      - `headers` object
      - `allow_cellular` boolean
    - `expiry` integer: Unix timestamp at which this message will be removed from the offline queue, after which it will no longer be sent to the device if it comes online. If not specified, this message will not be added to the offline queue.
  - object
    - `method` 'listUploadQueue', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
  - object
    - `method` 'getPublicKey', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
  - object
    - `method` 'getSshAuthorizedKeys', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
  - object
    - `method` 'getSimInfo', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
  - object
    - `method` 'getNetworkType', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
  - object
    - `method` 'getNetworkMetered', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
  - object
    - `method` 'getNetworks', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID
  - object
    - `method` 'takeSnapshot', required: JSON-RPC method name
    - `jsonrpc` '2.0', required: JSON-RPC version
    - `id` 0, required: JSON-RPC request ID

## Response `200`

JSON-RPC response containing the result of the method call

- AthenaResponse
  - `jsonrpc` '2.0', required: JSON-RPC version
  - `id` 0, required: JSON-RPC request ID
  - `result` unknown

## Changes

- **2022-12-05** `8a6c3e387b8b`: 1 info
  - added the new optional request property `oneOf[#/components/schemas/UploadFilesToUrlsMethod]/allOf[subschema #2]/expiry`
- **2022-12-05** `204eb159292b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/comma/apis/comma-api/changes/:dongleId/post.md)

---

[API](https://skmtc.dev/comma/apis/comma-api.md) - [All operations](https://skmtc.dev/comma/apis/comma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/comma/apis/comma-api/revisions/24f7dbc922ad?raw)