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

# IssueBotCredential

> Mint a new secret bearer token for a bot the current user can manage. Use this when the user asks for bot credentials or a webhook token; existing raw secrets cannot be recovered safely. The response contains a newly issued bearerToken and tokenId. Treat bearerToken as sensitive and tell the user to store it securely because it is shown only once.

# IssueBotCredential

Mint a new secret bearer token for a bot the current user can manage. Use this when the user asks for bot credentials or a webhook token; existing raw secrets cannot be recovered safely. The response contains a newly issued bearerToken and tokenId. Treat bearerToken as sensitive and tell the user to store it securely because it is shown only once.

## Parameters

| Parameter   | Type   | Required | Description                                                                                   |
| ----------- | ------ | -------- | --------------------------------------------------------------------------------------------- |
| `botId`     | string | Yes      | Bot id from CreateBot or ListBots.                                                            |
| `label`     | string | No       | Optional label describing where the credential will be used, such as `github-webhook`.        |
| `expiresAt` | string | No       | Optional RFC 3339 expiration timestamp. Omit for a credential without a scheduled expiration. |