---
title: Send-Your-Data management API
description: Coralogix provides an API that allows you to manage your Send-Your-Data API keys.
url: https://coralogix.com/docs/developer-portal/apis/data-management/send-your-data-management-api/
product: aaa
feature: API Keys
feature_id: api-keys
feature_identifier: aaa/api-keys
last_updated: '2026-10-21'
---

# Send-Your-Data management API

Coralogix provides an API that allows you to manage your [Send-Your-Data API keys](https://coralogix.com/docs/user-guides/account-management/api-keys/send-your-data-api-key.md).

## Prerequisites

* API Key with `ApiKeys` preset permissions. Access **Data Flow**, then **API Keys**.

[![](/docs/assets/images/keys-28dec2bcfd0953d0c12fdefafee5f0fe.webp)](https://coralogix.com/docs/assets/images/keys-28dec2bcfd0953d0c12fdefafee5f0fe.webp)

* Select the
  <!-- -->
  api.:443
  <!-- -->
  endpoint that corresponds to your Coralogix [domain](https://coralogix.com/docs/user-guides/account-management/account-settings/coralogix-domain.md) using the domain selector at the top of the page.

## Create a new "Send Your Data" API key

```
grpcurl -H "Authorization: Bearer <YOUR-API-KEY>" -d @ api.eu2.coralogix.com:443 com.coralogixapis.aaa.apikeys.v3.ApiKeysService/CreateApiKey <<EOF

{

  "name": "my-api-key",

  "key_permissions": {

  	"presets": [    

            "SendData"    

        ]

  },  

  "owner": {

    "team_id": 000000

  },

  "hashed": false

}

EOF
```

### Request args

| Field            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| key\_name        | Name of the key                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| key\_permissions | Specifies the permissions assigned to this key. For "Send Your Data" keys, use the **SendData** preset to ingest logs, metrics, and traces, or the **SendRUMData** preset to create a Real User Monitoring key. **SendRUMData** is standalone and cannot be combined with other presets. (Note: A preset is a predefined group of permissions tailored to a specific role. A key can be assigned either individual permissions directly or through a preset.) |
| owner            | Defines who can be the owner of the key. The only available value at present is the team\_id.                                                                                                                                                                                                                                                                                                                                                                 |
| hashed           | Whether the key should be stored securely. If hashed, key value will be disclosed only once in create response.                                                                                                                                                                                                                                                                                                                                               |

### Response

The response will be a message with information about the created key.

```
{

  "key_id": "c8d84762-9aff-4f90-93ef-1762757e0c2c",

  "name": "my-api-key",

  "value": "<key_value>",

  }

}
```

| Field   | Description                                                                           |
| ------- | ------------------------------------------------------------------------------------- |
| key\_id | ID of the key                                                                         |
| name    | Assigned name to the key                                                              |
| Value   | Value of the key. For securely stored keys, this is the only time it will be visible. |

## Update "Send Your Data" API Key

```
grpcurl -H "Authorization: Bearer Bearer <YOUR-API-KEY>" -d @ api.eu2.coralogix.com:443 com.coralogixapis.aaa.apikeys.v3.ApiKeysService/UpdateApiKey <<EOF

{

  "key_id": "252d3765-069a-4f32-b79a-18e60f4c7b61",

  "is_active": false,

  "new_name": "Some new name"

}

EOF
```

### Request args

| Field      | Description                                                |
| ---------- | ---------------------------------------------------------- |
| key\_id    | ID of the key                                              |
| is\_active | If provided, defines if key should be active or not        |
| new\_name  | If provided, new name that will be correlated with the key |

### Response

The response will be an empty message.

## Get a "Send Your Data" API key by ID

```
grpcurl -H "Authorization: Bearer <YOUR-API-KEY>" -d @ api.eu2.coralogix.com:443 com.coralogixapis.aaa.apikeys.v3.ApiKeysService/GetApiKey <<EOF

{

  "key_id": "252d3765-069a-4f32-b79a-18e60f4c7b61"

}

EOF
```

### Request args

| Field   | Description                                 |
| ------- | ------------------------------------------- |
| key\_id | Id of they key send data key to be returned |

### Response

The response will be an message with API key information:

```
{

  "key_info": {

    "id": "252d3765-069a-4f32-b79a-18e60f4c7b61",

    "name": "Some key name",

    "owner": {

      "team_id": 0000

    },

    "active": false,

    "hashed": false,

    "key_permissions": {

      "presets": [

        {

          "permissions": [

            "cloud-metadata-ingress:SendData",

            "logs.data-ingress:SendData",

            "metrics.data-ingress:SendData",

            "spans.data-ingress:SendData",

            "contextual-data:SendData"

          ],

          "name": "SendData"

        }

      ],

      "permissions": []

    },

    "value": "<key_value>"

  }

}
```

| Field             | Description                                                                                              |
| ----------------- | -------------------------------------------------------------------------------------------------------- |
| id                | ID of the key                                                                                            |
| name              | Assigned name to the key                                                                                 |
| owner             | Who owns the key                                                                                         |
| active Key Active | If key is in active state                                                                                |
| hashed            | Whether the key is stored securely. If hashed, key value is only disclosed once in create response       |
| key\_permissions  | Permissions assigned to this key come either from presets (predefined groups of permissions) or directly |
| value             | Optional value of the key. If key is stored securely, this field will not be sent                        |

## Get all "Send Your Data" API keys owned by caller of the endpoint

The caller can be either a user or a team, determined by the authentication context in which the call is performed

```
grpcurl -H "Authorization: Bearer <YOUR-API-KEY>" -d @ api.eu2.coralogix.com:443 com.coralogixapis.aaa.apikeys.v3.ApiKeysService/GetSendDataApiKeys <<EOF

{

}

EOF
```

### Request args

No args

### Response

The response will be a message with a list of all "Send Your Data" API keys owned by caller:

```
{

  "keys": [

    {

      "key_info": {

        "id": "252d3765-069a-4f32-b79a-18e60f4c7b61",

        "name": "Some key name",

        "owner": {

          "team_id": 0000

        },

        "active": false,

        "hashed": false,

        "key_permissions": {

          "presets": [

            {

              "permissions": [

                "cloud-metadata-ingress:SendData",

                "logs.data-ingress:SendData",

                "metrics.data-ingress:SendData",

                "spans.data-ingress:SendData",

                "contextual-data:SendData"

              ],

              "name": "SendData"

            }

          ],

          "permissions": []

        },

        "value": "<key_value>"

      }

    }

  ]

}
```

List of

| Field             | Description                                                                                              |
| ----------------- | -------------------------------------------------------------------------------------------------------- |
| id                | ID of the key                                                                                            |
| name              | Assigned name to the key                                                                                 |
| owner             | Who owns the key                                                                                         |
| active Key Active | If key is in active state                                                                                |
| hashed            | Whether the key is stored securely. If hashed, key value is only disclosed once in create response       |
| key\_permissions  | Permissions assigned to this key come either from presets (predefined groups of permissions) or directly |
| value             | Optional value of the key. If key is stored securely, this field will not be sent                        |

## Additional resources

|                     |                                                                                       |
| ------------------- | ------------------------------------------------------------------------------------- |
| Coralogix Endpoints | [Coralogix Endpoints](https://coralogix.com/docs/integrations/coralogix-endpoints.md) |