curl --request POST \
--url 'https://edi.stateset.com/v1/tenants/{id}/api-keys' \
--header "Authorization: Bearer $STATESET_EDI_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"name": "Two-Person Tent"
}'
Mints a tenant-scoped API key for external REST callers. The key authenticates
as the tenant (full access within it, no platform operations). The plaintext is returned once and never stored. Platform-admin only.
POST
/
v1
/
tenants
/
{id}
/
api-keys
curl --request POST \
--url 'https://edi.stateset.com/v1/tenants/{id}/api-keys' \
--header "Authorization: Bearer $STATESET_EDI_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"name": "Two-Person Tent"
}'
as the tenant (full access within it, no platform operations). The plaintext
is returned once and never stored. Platform-admin only.
Path parameters
string
required
Tenant ID
Request body
MintTenantKeyBody
string
required
Operator label for the key, e.g.
production-orders.Response
No response body. The new key — plaintext shown once.Status codes
| Code | Meaning |
|---|---|
200 | The new key — plaintext shown once |
403 | Platform-admin credential required |
404 | Unknown tenant |
curl --request POST \
--url 'https://edi.stateset.com/v1/tenants/{id}/api-keys' \
--header "Authorization: Bearer $STATESET_EDI_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"name": "Two-Person Tent"
}'
Last modified on August 31, 2026