Errors

The MVP preserves the existing top-level error envelope:

{
  "error": "missing permission grant for action linear.issues.read",
  "code": "PERMISSION_DENIED"
}

Common codes

• MISSING_SCOPE
• HOSTED_MODEL_UNAVAILABLE
• PERMISSION_DENIED
• RECONNECT_REQUIRED
• ACTION_EXECUTION_FAILED

Every public response also includes X-Request-Id.

In practice, the first three things to check are:

1. Is the API key valid and scoped to the right workspace?
2. Is the hosted model path ready for sessions and runs?
3. Is the integration or permission state correct for the action you asked AP to use?

When you inspect a failed request, use X-Request-Id together with the dashboard run detail page or your server logs.