cloud licenses¶

NAME¶

phyware cloud licenses — issue, list, revoke, and validate PhyTrace licenses.

SYNOPSIS¶

phyware cloud licenses issue    [OPTIONS] --tenant-id <ID>
phyware cloud licenses list     [OPTIONS]
phyware cloud licenses revoke   [OPTIONS] <LICENSE_ID>
phyware cloud licenses validate [OPTIONS] --token <JWT>

DESCRIPTION¶

issue¶

Issues a new PhyTrace JWT license for a tenant.

list¶

Lists all licenses (with optional filters).

revoke¶

Revokes a license by ID.

validate¶

Validates a license JWT — checks signature and expiry.

OPTIONS¶

Flag	Type	Required	Default	Env
`--url`	string	No	`http://localhost:8000`	`PHYCLOUD_URL`
`--api-key`	string	No	—	`PHYCLOUD_API_KEY`
`--output`	enum	No	`table`	—

| --tenant-id | string | Yes (issue) | — | — | | --token | string | Yes (validate) | — | — | | --ttl | string | No | 365d | — |

ARGUMENTS¶

Name	Required	Description
`LICENSE_ID`	Yes (revoke)	Unique license identifier

INPUT¶

None.

OUTPUT¶

Field	Type	Description
`id`	string	License identifier
`token`	string	Signed JWT (issue only)
`status`	string	`active` / `revoked`
`valid`	bool	(validate) JWT is valid

EXIT CODES¶

Code	Meaning
`0`	Success
`1`	Generic / connection error
`2`	Authentication / authorisation error
`3`	Resource not found
`4`	Validation error
`5`	Server-side error

EXAMPLES¶

# Issue a license
phyware cloud licenses issue --tenant-id ten_abc123

# Issue with a custom TTL
phyware cloud licenses issue --tenant-id ten_abc123 --ttl 90d

# List all licenses
phyware cloud licenses list --output json

# Revoke a license
phyware cloud licenses revoke lic_abc123

# Validate a JWT
phyware cloud licenses validate --token "$LICENSE_JWT"

AGENT NOTES¶

issue returns a signed JWT — store it securely. Use validate before distributing a license to check it is not expired or revoked. Requires admin:tenants scope for issue/revoke.

ERRORS¶

Code	Message	Remediation
`FORBIDDEN`	Insufficient scope	Ensure `admin:tenants`
`NOT_FOUND`	License not found	Check `LICENSE_ID`
`EXPIRED`	License has expired	Issue a new license