MentionBird

api_keys_create

Create a workspace key and receive its token once, in this response; no later call reads it back. Scopes are limited to the data plane, so a key can never issue or revoke another one. Expiry is fixed at creation, and `cidrs` is applied in the same transaction, so an invalid range fails the whole call instead of leaving the key unrestricted.

Remote bird/mcp

Remote (network-hosted)

Other tools also called api_keys_create? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "A label for the key, shown wherever it is listed. Names do not have to be unique, and the name has no effect on what the key can do."
    },
    "cidrs": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "string"
      },
      "description": "Restrict this key to these source IP ranges (CIDR). Requests from other IPs are rejected. The key and its IP restriction are created atomically, so an invalid CIDR fails the whole request. Omit for a key with no IP restriction; use the IP restrictions endpoints to add one later."
    },
    "scopes": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "object",
        "required": [
          "level",
          "scope"
        ],
        "properties": {
          "level": {
            "type": "string"
          },
          "scope": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "description": "What the key may do, as scope and level pairs. Data-plane scopes only, so a key can never carry the control-plane scopes that issue keys or change members and settings."
    },
    "expires_at": {
      "type": "string",
      "description": "When the key stops working, as an RFC 3339 timestamp. Omit for a key that never expires. Must be in the future. To change the expiry after creation, create a new key."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Client-supplied deduplication key; a retry with the same key replays the original result instead of acting twice."
    }
  }
}