| HTTP | Code | Meaning |
|---|---|---|
| 409 | DUPLICATE_PUBLISH | Same id@version already exists |
| 400 | MISSING_DEPENDENCY / CIRCULAR_DEPENDENCY | Dependency graph doesn’t resolve or has a cycle |
| 400 | CORRUPT_PAYLOAD | Digest mismatch on the uploaded package |
| 400 | INVALID_SIGNATURE | Signature fails trust-policy verification |
| 400 | GUARDRAIL_VIOLATION | A mandatory (Level 1) content-safety rule fired |
| 403 | FORBIDDEN | Caller lacks the required scope or ownership |
| 404 | SKILL_NOT_FOUND | Nonexistent id, or a private skill the caller can’t see — indistinguishable by design |
| 503 | GUARDRAILS_SERVICE_UNAVAILABLE | Guardrails scan couldn’t run; only guardrail-dependent routes are affected |
Reference
Error codes
Error codes at a glance