MantisBT Manager

Base URL Resolution

Base URL precedence (highest to lowest): temporary_base_url — one-time use URL for specific operations user_base_url — user-defined URL for the current session MANTIS_BASE_URL — environment default URL This allows you to: Switch between multiple Mantis instances dynamically Test against staging/production environments Work with different client instances without changing config Example: // Default: uses MANTIS_BASE_URL from environment GET {{resolved_base_url}}/issues // Override for one operation: temporary_base_url = "https://mantis-staging.example.com/api/rest" GET {{resolved_base_url}}/issues // Override for session: user_base_url = "https://client-mantis.example.com/api/rest" GET {{resolved_base_url}}/issues

Token Resolution

Token precedence (highest to lowest): temporary_token — one-time use token for specific operations user_token — user-defined token for the current session MANTIS_API_TOKEN — environment default token Environment variables are handled via standard OpenClaw metadata: requires.env declares required variables (MANTIS_BASE_URL, MANTIS_API_TOKEN). Any other environment variables you use for Mantis should be treated as normal process env vars and are not modeled as special OpenClaw metadata fields.

Authentication Headers

All API requests must include: Authorization: Bearer {{resolved_token}} Content-Type: application/json Note: The {{resolved_base_url}} and {{resolved_token}} are determined at runtime based on the precedence rules above.

📌 Notation Used in Examples

Throughout this documentation: {{MANTIS_BASE_URL}} refers to the resolved base URL (could be temporary_base_url, user_base_url, or env MANTIS_BASE_URL) {{resolved_token}} refers to the resolved token (could be temporary_token, user_token, or env MANTIS_API_TOKEN) All endpoints use the pattern: {{MANTIS_BASE_URL}}/resource/path Important: Always use the resolution logic to determine the actual URL and token at runtime.

🔄 Context Management

The temporary_* and user_* names here are runtime context variables used by the skill logic, not OpenClaw metadata fields. OpenClaw does not define an optional.context metadata key; context is resolved dynamically at runtime as described below.

Setting Temporary Values (One-Time Use)

User queries: "Use https://staging.mantis.com/api/rest for this request" "Connect to production instance for this operation" "Use token ABC123 just this once" Action: Set temporary_base_url = "https://staging.mantis.com/api/rest" Set temporary_token = "ABC123" ... perform operation ... Clear temporary_base_url Clear temporary_token Behavior: Temporary values are automatically cleared after one use.

Setting Session Values (Current Session)

User queries: "Switch to client XYZ's Mantis instance" "Use my personal API token for all requests" "Connect to staging environment" Action: Set user_base_url = "https://client-xyz.mantis.com/api/rest" Set user_token = "personal_token_123" ... perform multiple operations ... // Values persist for the entire session Behavior: Session values persist until explicitly cleared or session ends.

Clearing Context Values

User queries: "Reset to default Mantis instance" "Clear my custom token" "Go back to environment defaults" Action: Clear user_base_url Clear user_token // Now uses MANTIS_BASE_URL and MANTIS_API_TOKEN from environment

Viewing Current Context

• User queries:
• "What Mantis instance am I connected to?"
• "Show current API configuration"
• "Which token am I using?"
• Response should show:
• Current Context:
• Base URL: https://client-xyz.mantis.com/api/rest (user_base_url)
• Token: user_t***123 (user_token)
• Fallback Base URL: https://default.mantis.com/api/rest (MANTIS_BASE_URL)
• Fallback Token: env_t***789 (MANTIS_API_TOKEN)

Use Cases

Multi-Instance Management // Check production issue Set temporary_base_url = "https://prod.mantis.com/api/rest" Get issue 123 // Check staging issue Set temporary_base_url = "https://staging.mantis.com/api/rest" Get issue 123 // Compare results Client Switching // Switch to Client A Set user_base_url = "https://clienta.mantis.com/api/rest" Set user_token = "clienta_token" List all projects Get issues for project 5 // Switch to Client B Set user_base_url = "https://clientb.mantis.com/api/rest" Set user_token = "clientb_token" List all projects Get issues for project 3 Admin Operations with Impersonation // Connect to main instance as admin Set user_token = "admin_token" // Perform operation as specific user Set temporary header: X-Impersonate-User = "john.doe" Get user issues // Back to admin Clear temporary header

List Issues

User queries: "List all issues" "Get issues for project 5" "Get issues matching filter 10" "Show issues assigned to me" "Get unassigned issues" Actions: GET {{MANTIS_BASE_URL}}/issues Query Parameters: page_size — number of issues per page (default: 50) page — page number (1-indexed) filter_id — ID of saved filter to apply project_id — filter by specific project select — comma-separated fields to return (e.g., "id,summary,status") Special endpoints: GET {{MANTIS_BASE_URL}}/issues?filter_id={{filter_id}} GET {{MANTIS_BASE_URL}}/projects/{{project_id}}/issues

Get Single Issue

User queries: "Show issue 123" "Get details for bug 456" Action: GET {{MANTIS_BASE_URL}}/issues/{{id}}

Create Issue

User queries: "Create issue with summary 'Login bug' and description 'Cannot login'" "Create bug in project 5 with priority high" "Create issue with attachments" Action: POST {{MANTIS_BASE_URL}}/issues Minimal body: { "summary": "Issue summary", "description": "Detailed description", "category": {"name": "General"}, "project": {"id": 1} } Full body (optional fields): { "summary": "Issue summary", "description": "Detailed description", "steps_to_reproduce": "1. Do this\n2. Do that", "additional_information": "Extra info", "category": {"id": 1, "name": "General"}, "project": {"id": 1}, "priority": {"id": 30, "name": "normal"}, "severity": {"id": 50, "name": "minor"}, "status": {"id": 10, "name": "new"}, "reproducibility": {"id": 10, "name": "always"}, "handler": {"id": 5}, "tags": [{"name": "bug"}, {"name": "ui"}], "custom_fields": [{"field": {"id": 1}, "value": "custom value"}], "due_date": "2026-12-31T23:59:59+00:00", "version": {"name": "1.0"}, "target_version": {"name": "2.0"} } Create with attachments: POST {{MANTIS_BASE_URL}}/issues Include files array in body with base64-encoded content.

Update Issue

User queries: "Update issue 123 status to resolved" "Change priority of bug 456 to high" "Assign issue 789 to user 10" Action: PATCH {{MANTIS_BASE_URL}}/issues/{{id}} Example body: { "status": {"name": "resolved"}, "handler": {"id": 10}, "priority": {"name": "high"}, "summary": "Updated summary" }

Delete Issue

User queries: "Delete issue 123" "Remove bug 456" Action: DELETE {{MANTIS_BASE_URL}}/issues/{{id}}

Monitor/Unmonitor Issue

User queries: "Monitor issue 123" "Stop monitoring bug 456" "Add user 10 as monitor on issue 789" Actions: POST {{MANTIS_BASE_URL}}/issues/{{id}}/monitors DELETE {{MANTIS_BASE_URL}}/issues/{{id}}/monitors Body (for specific user): { "user": {"id": 10} }

Attach/Detach Tags

User queries: "Add tag 'critical' to issue 123" "Remove tag 'bug' from issue 456" Actions: POST {{MANTIS_BASE_URL}}/issues/{{id}}/tags PATCH {{MANTIS_BASE_URL}}/issues/{{id}}/tags DELETE {{MANTIS_BASE_URL}}/issues/{{id}}/tags Body: { "tags": [ {"name": "bug"}, {"name": "critical"} ] }

Add Issue Relationship

User queries: "Link issue 123 to issue 456 as duplicate" "Add parent relationship from 789 to 101" Action: POST {{MANTIS_BASE_URL}}/issues/{{id}}/relationships Body: { "type": {"name": "duplicate-of"}, "target_issue": {"id": 456} } Relationship types: duplicate-of related-to parent-of child-of has-duplicate

Attach Files

User queries: "Attach file to issue 123" "Add screenshot to bug 456" Action: POST {{MANTIS_BASE_URL}}/issues/{{id}}/files Body: { "files": [ { "name": "screenshot.png", "content": "base64_encoded_content_here" } ] }

Delete Attachment

User queries: "Delete attachment 789 from issue 123" "Remove file 101 from bug 456" Action: DELETE {{MANTIS_BASE_URL}}/issues/{{issue_id}}/files/{{file_id}}

Issue Notes

Add Note User queries: "Add note to issue 123: 'This is fixed now'" "Add note with time tracking 2 hours" "Add private note to bug 456" Action: POST {{MANTIS_BASE_URL}}/issues/{{id}}/notes Body: { "text": "Note content here", "view_state": {"name": "public"}, "time_tracking": "PT2H30M" } With attachment: { "text": "Note with file", "files": [ { "name": "log.txt", "content": "base64_content" } ] } Delete Note User queries: "Delete note 55 from issue 123" "Remove comment 99 from bug 456" Action: DELETE {{MANTIS_BASE_URL}}/issues/{{issue_id}}/notes/{{note_id}}

List All Projects

User queries: "List all projects" "Show all projects" "Get projects" Action: GET {{MANTIS_BASE_URL}}/projects

Get Project by ID

User queries: "Show project 5" "Get details for project 10" Action: GET {{MANTIS_BASE_URL}}/projects/{{id}}

Create Project

User queries: "Create project named 'New Product'" "Add project with description 'Internal tools'" Action: POST {{MANTIS_BASE_URL}}/projects Body: { "name": "Project Name", "description": "Project description", "enabled": true, "inherit_global": true, "view_state": {"name": "public"}, "status": {"name": "development"} }

Update Project

User queries: "Update project 5 description" "Change project 10 status to stable" Action: PATCH {{MANTIS_BASE_URL}}/projects/{{id}}

Delete Project

User queries: "Delete project 5" "Remove project 10" Action: DELETE {{MANTIS_BASE_URL}}/projects/{{id}}

Sub-Projects

Get Sub-Projects User queries: "Show sub-projects of project 5" Action: GET {{MANTIS_BASE_URL}}/projects/{{id}}/subprojects Create Sub-Project User queries: "Create sub-project under project 5" Action: POST {{MANTIS_BASE_URL}}/projects/{{id}}/subprojects Body: { "subproject": {"id": 10} } Delete Sub-Project Action: DELETE {{MANTIS_BASE_URL}}/projects/{{id}}/subprojects/{{subproject_id}}

Project Users

Get Project Users User queries: "Show users in project 5" "List members of project 10" Action: GET {{MANTIS_BASE_URL}}/projects/{{id}}/users Add User to Project User queries: "Add user 20 to project 5 as developer" Action: POST {{MANTIS_BASE_URL}}/projects/{{id}}/users Body: { "user": {"id": 20}, "access_level": {"name": "developer"} } Access levels: viewer (10) reporter (25) updater (40) developer (55) manager (70) administrator (90) Delete User from Project Action: DELETE {{MANTIS_BASE_URL}}/projects/{{project_id}}/users/{{user_id}}

Project Versions

Get Versions User queries: "Show versions of project 5" "List releases for project 10" Action: GET {{MANTIS_BASE_URL}}/projects/{{id}}/versions Create Version User queries: "Create version 2.0 for project 5" "Add release 1.5 to project 10" Action: POST {{MANTIS_BASE_URL}}/projects/{{id}}/versions Body: { "name": "2.0", "description": "Major release", "released": true, "obsolete": false, "timestamp": "2026-06-01T00:00:00+00:00" } Update Version Action: PATCH {{MANTIS_BASE_URL}}/projects/{{project_id}}/versions/{{version_id}} Delete Version Action: DELETE {{MANTIS_BASE_URL}}/projects/{{project_id}}/versions/{{version_id}}

Get My User Info

User queries: "Show my user info" "Get my profile" "Who am I?" Action: GET {{MANTIS_BASE_URL}}/users/me

Get User by ID

User queries: "Show user 10" "Get info for user 25" Action: GET {{MANTIS_BASE_URL}}/users/{{id}}

Get User by Username

User queries: "Find user 'john.doe'" "Get user with username 'admin'" Action: GET {{MANTIS_BASE_URL}}/users?name={{username}}

Create User

User queries: "Create user 'jane.smith' with email 'jane@example.com'" "Add new user" Action: POST {{MANTIS_BASE_URL}}/users Minimal body: { "username": "jane.smith", "email": "jane@example.com", "access_level": {"name": "reporter"} } Full body: { "username": "jane.smith", "password": "SecurePass123!", "real_name": "Jane Smith", "email": "jane@example.com", "access_level": {"name": "developer"}, "enabled": true, "protected": false }

Update User

User queries: "Update user 10 email to 'new@example.com'" "Change user 25 access level to developer" Action: PATCH {{MANTIS_BASE_URL}}/users/{{id}} Body: { "real_name": "Updated Name", "email": "new@example.com", "access_level": {"name": "developer"}, "enabled": false }

Reset User Password

User queries: "Reset password for user 10" Action: PUT {{MANTIS_BASE_URL}}/users/{{id}}/reset-password Body: { "password": "NewSecurePassword123!" }

Delete User

User queries: "Delete user 10" "Remove user 'john.doe'" Action: DELETE {{MANTIS_BASE_URL}}/users/{{id}}

Get All Filters

User queries: "List all filters" "Show my saved filters" Action: GET {{MANTIS_BASE_URL}}/filters

Get Filter by ID

User queries: "Show filter 5" "Get details for filter 10" Action: GET {{MANTIS_BASE_URL}}/filters/{{id}}

Delete Filter

User queries: "Delete filter 5" "Remove saved filter 10" Action: DELETE {{MANTIS_BASE_URL}}/filters/{{id}}

Create Token for Self

User queries: "Create my API token" "Generate token for me" "Create new token named 'automation'" Action: POST {{MANTIS_BASE_URL}}/user_tokens Body: { "name": "automation_token", "date_expiry": "2027-12-31T23:59:59+00:00" }

Delete Token for Self

User queries: "Delete my token" "Revoke my API token" Action: DELETE {{MANTIS_BASE_URL}}/user_tokens/{{token_id}}

Create Token for Another User

User queries: "Create token for user 10" "Generate API token for user 'john.doe'" Action: POST {{MANTIS_BASE_URL}}/users/{{user_id}}/tokens Body: { "name": "user_token", "date_expiry": "2027-12-31T23:59:59+00:00" }

Delete Token for Another User

Action: DELETE {{MANTIS_BASE_URL}}/users/{{user_id}}/tokens/{{token_id}}

Get Single Configuration Option

User queries: "Get config option 'bug_report_page_fields'" "Show configuration for 'default_category_for_moves'" Action: GET {{MANTIS_BASE_URL}}/config/{{option}}

Get Multiple Configuration Options

User queries: "Get configs for project 5" "Show all config options" Action: GET {{MANTIS_BASE_URL}}/config Query parameters: option — specific option name project_id — filter by project user_id — filter by user

Set Configuration Option

User queries: "Set config 'allow_signup' to true" "Update config option" Action: PATCH {{MANTIS_BASE_URL}}/config Body: { "configs": [ { "option": "allow_signup", "value": "1" } ] }

Get Localized String

User queries: "Get localized string 'status_new'" "Translate 'priority_high' to French" Action: GET {{MANTIS_BASE_URL}}/lang/{{string}} Query parameter: language — language code (e.g., 'fr', 'en', 'de')

Get Multiple Localized Strings

User queries: "Get all status translations" "Get localized strings for priorities" Action: GET {{MANTIS_BASE_URL}}/lang Query parameters: strings — comma-separated list of string keys language — language code

Get User Info with Impersonation

User queries: "Impersonate user 10 and get their info" "Get info as user 'john.doe'" Action: GET {{MANTIS_BASE_URL}}/users/me Header: X-Impersonate-User: {{username_or_id}}

⚠️ Error Handling

Handle HTTP errors gracefully: 401 Unauthorized: Token is invalid or expired Action: Inform user to check MANTIS_API_TOKEN or provide valid temporary_token 403 Forbidden: User doesn't have permission for this operation Action: Inform user about insufficient permissions 404 Not Found: Resource (issue, project, user, etc.) doesn't exist Action: Inform user that the requested resource was not found 422 Unprocessable Entity: Validation error in request body Action: Show validation errors from response and guide user 500 Internal Server Error: Server-side error Action: Inform user of server error and suggest retrying later General error response format: { "message": "Error description", "code": 1234, "localized": "Localized error message" }

Pagination

Always support page_size and page parameters for list operations Default page size: 50 Inform user when results are paginated

Field Selection

Use select parameter to return only needed fields Example: select=id,summary,status,priority Reduces bandwidth and improves performance

Filtering

Use filter_id to apply saved filters Combine with pagination for large datasets Consider project-specific filtering with project_id

Attachments

Files must be base64-encoded Include filename and content in request Verify file size limits (check Mantis config)

Time Tracking

Use ISO 8601 duration format: PT2H30M (2 hours 30 minutes) Can be added to notes for time tracking

Date Formats

Use ISO 8601: 2026-12-31T23:59:59+00:00 Include timezone for accuracy

Custom Fields

Check project configuration for available custom fields Reference by field ID in requests

Relationships

Verify relationship types supported by your Mantis version Some relationships auto-create reciprocal links

Create and Monitor Issue

1. POST /issues with summary and description 2. POST /issues/{{new_id}}/monitors to monitor

Assign Issue and Add Note

1. PATCH /issues/{{id}} with handler 2. POST /issues/{{id}}/notes with assignment comment

Create Project with Version

1. POST /projects with project details 2. POST /projects/{{id}}/versions with version info

User Management Flow

1. POST /users to create user 2. POST /projects/{{id}}/users to add to project 3. POST /users/{{id}}/tokens to create API token

Bulk Issue Updates

When updating multiple issues: Loop through issue IDs Use PATCH for each issue Collect results and report summary

Filter-Based Operations

Get all high-priority bugs: 1. GET /filters to find priority filter ID 2. GET /issues?filter_id={{filter_id}}&page_size=100 3. Process paginated results

Project Migration

Copy project structure: 1. GET /projects/{{source_id}} to get project details 2. GET /projects/{{source_id}}/versions for versions 3. POST /projects to create new project 4. POST /projects/{{new_id}}/versions for each version

User Audit

Track user activity: 1. GET /issues?reporter_id={{user_id}} 2. GET /issues?handler_id={{user_id}} 3. GET /issues?monitor_id={{user_id}} 4. Compile activity report

Multi-Instance Management

Work with multiple Mantis instances: // Scenario: Compare issue status across environments 1. Check production: Set temporary_base_url = "https://prod.mantis.com/api/rest" Set temporary_token = "prod_token" GET /issues/123 Record status 2. Check staging: Set temporary_base_url = "https://staging.mantis.com/api/rest" Set temporary_token = "staging_token" GET /issues/123 Record status 3. Compare and report differences

Cross-Instance Synchronization

Sync data between instances: // Scenario: Clone project from one instance to another 1. Connect to source instance: Set user_base_url = "https://source.mantis.com/api/rest" Set user_token = "source_token" GET /projects/5 (get project details) GET /projects/5/versions (get versions) GET /projects/5/users (get users) 2. Connect to target instance: Set user_base_url = "https://target.mantis.com/api/rest" Set user_token = "target_token" POST /projects (create project) POST /projects/{{new_id}}/versions (create versions) POST /projects/{{new_id}}/users (add users) 3. Report sync results

Client-Specific Operations

Manage multiple client instances: // Scenario: Daily status report for all clients For each client in [ClientA, ClientB, ClientC]: 1. Set user_base_url = client.mantis_url 2. Set user_token = client.api_token 3. GET /issues?filter_id=1 (get today's issues) 4. Collect statistics 5. Clear context Generate consolidated report

📚 Resources

Mantis API Documentation: Check your Mantis instance at {{MANTIS_BASE_URL}}/api/rest/swagger.yaml Issue Statuses: new, feedback, acknowledged, confirmed, assigned, resolved, closed Priorities: none, low, normal, high, urgent, immediate Severities: feature, trivial, text, tweak, minor, major, crash, block Access Levels: 10=viewer, 25=reporter, 40=updater, 55=developer, 70=manager, 90=administrator

✅ Skill Capabilities Summary

This skill enables you to:

Core Operations

✅ Full CRUD operations on issues ✅ Manage issue relationships, tags, monitors ✅ Add notes with time tracking and attachments ✅ Full project management (create, update, delete) ✅ Manage sub-projects, versions, and project users ✅ User management (CRUD, password reset) ✅ API token management (create, delete for self and others) ✅ Filter management and filtered queries ✅ Configuration management ✅ Localization support ✅ Impersonation capabilities

Advanced Features

✅ Dynamic instance switching — Switch between multiple Mantis instances on-the-fly ✅ Context-aware URL resolution — temporary_base_url → user_base_url → MANTIS_BASE_URL ✅ Context-aware token resolution — temporary_token → user_token → MANTIS_API_TOKEN ✅ Multi-instance management — Manage multiple clients/environments simultaneously ✅ Cross-instance operations — Compare, sync, and migrate data between instances ✅ Comprehensive error handling ✅ Pagination and field selection ✅ Advanced workflows and bulk operations