signaloid-cli keys create

Create a new API key.

Synopsis

signaloid-cli keys create --name <name> [options]

Options

Option	Required	Description
--name <name>	Yes	Descriptive name for the key
--valid-until <iso>	No	Expiration date (ISO 8601 format)

Description

Creates a new API key for programmatic access to Signaloid Cloud Compute Engine. The full API key value is only shown once during creation, so it must be saved securely immediately.

Examples

Create Key without Expiration

signaloid-cli keys create --name "Production API Key"

Output

✔ API key created
{
  "Object": "Key",
  "Key": "scce_abc1234_34b3b97a",
  "KeyID": "d190a75fbb14499dab9fa26ab2e76635",
  "Name": "Production API Key",
  "Owner": "usr_12345661ad6641899387b6458cc9a2e2",
  "ValidUntil": null,
  "CreatedAt": 1761832939
}

Create Key with Expiration

signaloid-cli keys create \
  --name "Temporary Test Key" \
  --valid-until 2025-12-31T23:59:59Z

Output

✔ API key created
{
  "Object": "Key",
  "Key": "scce_abc1234_811a1e7a",
  "KeyID": "582129bb6ea3453c9c6c93085c27c90a",
  "Name": "Temporary Test Key",
  "Owner": "usr_12345661ad6641899387b6458cc9a2e2",
  "ValidUntil": 1767225599000,
  "CreatedAt": 1761832975
}

Important: The full API key is only shown once. Save it securely!

Output Fields

Field	Type	Description
Key	string	Full API key value (only shown once)
KeyID	string	Unique identifier for the key
Name	string	Descriptive name given to the key
Owner	string	User ID of the key owner
CreatedAt	string	ISO 8601 timestamp of key creation
ValidUntil	number/null	Unix timestamp (milliseconds) when key expires, or null for no expiration

Notes

• The --valid-until parameter must be in ISO 8601 format with UTC timezone (Z suffix)
• The full API key value is only returned during creation and cannot be retrieved later
• If the key is lost, you must delete the old key and create a new one
• Keys without expiration dates should be rotated regularly as a security best practice
• Use the date command to generate properly formatted expiration dates

Troubleshooting

"Invalid date format" Error

Problem: Date validation fails.

Solutions:

1. Use ISO 8601 format: 2025-12-31T23:59:59Z
2. Ensure UTC timezone (Z suffix)
3. Verify date is in the future

"Authentication failed" with New Key

Problem: Newly created key does not work.

Solutions:

1. Verify you copied the full key including prefix
2. Check for extra spaces or newlines
3. Ensure key has not expired
4. Wait a few seconds for key to propagate
5. Try re-authenticating:

   signaloid-cli auth logout
   signaloid-cli auth login --api-key <your-key>

See Also

• signaloid-cli keys - Keys command overview
• signaloid-cli keys list - List all API keys
• signaloid-cli keys delete - Delete an API key
• signaloid-cli auth login - Authenticate with API key
• Security Best Practices - Secure key usage