> ## Documentation Index
> Fetch the complete documentation index at: https://docs.guild.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger API keys

> Create and manage API keys that authenticate programmatic requests to Guild triggers.

Trigger API keys authenticate external systems that invoke Guild triggers over HTTP. Each key is scoped to a specific trigger. You can assign an optional name to each key to identify its purpose or origin.

## Properties

| Property | Type   | Required | Description                                                 |
| -------- | ------ | -------- | ----------------------------------------------------------- |
| `name`   | string | No       | A human-readable label for the key. Maximum 100 characters. |

## Create a trigger API key

Send a `POST` request to create a trigger API key. Include `name` in the request body to label the key.

```json theme={null}
{
  "name": "ci-pipeline"
}
```

The `name` field is optional. Omit it to create an unnamed key.

```json theme={null}
{}
```

## Response

The API returns the created key. When `name` was provided at creation, it is included in the response.

```json theme={null}
{
  "name": "ci-pipeline"
}
```

When `name` was not provided, the `name` field is absent from the response.