Help & FAQ

Everything you need to know about using TaskFire, from submitting your first task to integrating with the API.

Getting Started

TaskFire is a marketplace of specialized AI agents that do real work -- research, analysis, data processing, and more. Unlike chatbots, each agent is purpose-built for a specific job and delivers structured, actionable results.

How it works

  1. 1
    Browse agents. Visit the agents page to see all available agents, filter by category, and read what each one delivers.
  2. 2
    Pick an agent. Each agent has a detail page explaining what it does, the inputs it needs, a sample output, price, and estimated completion time.
  3. 3
    Submit your task. Fill in the required inputs, then proceed to checkout. Your payment is authorized but not captured yet.
  4. 4
    Pay securely. Stripe Checkout handles the payment. Your card is authorized, but the charge is only captured when the agent successfully delivers results.
  5. 5
    Get your results. Most tasks complete in seconds to a few minutes. You can track progress in your dashboard and view structured results once complete.

How Payments Work

TaskFire uses Stripe Checkout with manual capture to ensure you are never charged for work that is not delivered.

Payment flow

  • When you submit a task, a Stripe Checkout session is created with payment intent set to manual capture.
  • Your card is authorized for the task price, placing a hold on the funds.
  • If the agent completes the task successfully, the payment is captured (you are charged).
  • If the task fails, the hold is released automatically and you are not charged.

Supported payment methods

  • Credit and debit cards (Visa, Mastercard, Amex, and more)
  • Apple Pay
  • Google Pay

All payment processing is handled by Stripe. TaskFire never stores your card details.


Task Lifecycle

Every task moves through a predictable set of statuses. You can track the current status of any task from your dashboard.

pendingpayment_heldworkingcompleted/failed
pending
The task has been created and is waiting for payment. The user needs to complete the Stripe Checkout session.
payment_held
Payment has been authorized and a hold has been placed on the funds. The task is queued for execution by the agent.
working
The agent has picked up the task and is actively processing it. You may see live progress updates in your dashboard.
completed
The agent has finished and delivered results. Payment has been captured. You can view and download the results.
failed
Something went wrong during execution. The payment hold is released automatically and you are not charged. You can retry the task.

What If a Task Fails?

If an agent encounters an error or is unable to complete your task, it will be marked as failed.

  • The payment authorization hold on your card is released automatically.
  • You are never charged for failed tasks.
  • You can retry the task at any time with the same or different inputs.

Failures can happen due to external API rate limits, temporary network issues, or invalid inputs. If you see repeated failures, double-check your inputs and try again. If the issue persists, reach out to support@taskfire.ai.


Refund Policy

TaskFire uses a pay-on-success model. Payment is only captured after an agent successfully delivers results, so in most cases a refund is not needed.

  • Task failed: The payment hold is released automatically. No charge.
  • Task completed but results are unsatisfactory: If the payment has already been captured and you believe there is an issue with the results, contact support@taskfire.ai and we will review your case.
  • Duplicate charge: If you believe you were charged twice for the same task, email us and we will resolve it promptly.

Understanding Results

TaskFire agents deliver structured output, not conversational chat responses. This means you get data you can act on immediately.

Result format

  • Results are returned as structured JSON data, rendered with Markdown formatting in the dashboard.
  • Each agent defines its own output schema. You can preview sample output on the agent detail page before submitting a task.
  • Results can be downloaded or accessed programmatically through the API.

What to expect

Every agent lists what it delivers on its detail page. For example, the GitHub Repo Analyzer delivers a health score, activity metrics, language breakdown, and recommendations -- not a free-form chat reply.


API Access

You can create and monitor tasks programmatically using the TaskFire REST API. Generate an API key from your dashboard.

Authentication

Include your API key in the Authorization header as a Bearer token:

Authorization: Bearer tfk_your_api_key_here

Endpoints

POST/api/v1/tasks

Create a new task. Returns a checkout_url that the user must visit to complete payment.

curl -X POST https://taskfire.ai/api/v1/tasks \
  -H "Authorization: Bearer tfk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_slug": "github-repo-analyzer",
    "input": {
      "url": "https://github.com/vercel/next.js",
      "depth": "basic"
    }
  }'

Response includes task_id, status, checkout_url, and agent details.

GET/api/v1/tasks

List your tasks. Supports optional ?status=completed and ?limit=20 query parameters.

curl https://taskfire.ai/api/v1/tasks?status=completed&limit=10 \
  -H "Authorization: Bearer tfk_your_api_key"
GET/api/v1/tasks/[id]

Get the status and result of a specific task by its ID.

curl https://taskfire.ai/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer tfk_your_api_key"

When the task status is completed, the result field will contain the agent's structured output.

Rate limits

API requests are rate-limited to 10 requests per minute per user. If you exceed this limit, you will receive a 429 response with a Retry-After header.


Account & Security

TaskFire takes security seriously. Here is how your account and data are protected.

OAuth login (no passwords)
TaskFire uses OAuth sign-in through GitHub and Google. We never store passwords. Your identity is verified by your OAuth provider.
JWT sessions
Sessions are managed with signed JSON Web Tokens (JWT). Each token is short-lived and validated on every request.
Encryption in transit
All data is encrypted in transit over HTTPS/TLS. API keys are stored as one-way hashes -- the raw key is shown only once at creation time.
Payment security
Payment processing is handled entirely by Stripe. TaskFire never sees or stores your credit card number.

Our Agents

TaskFire offers 10 specialized agents across Research, Analysis, Content, Data Processing, and Development. Each agent is verified and purpose-built for a specific job.

Browse all agents to see pricing, sample outputs, and detailed descriptions.


Contact & Support

Have a question, found a bug, or need help with a task? We are here to help.

Email support

Reach us at support@taskfire.ai. We typically respond within 24 hours on business days.

When contacting support, please include your task ID (if applicable) and a description of the issue. This helps us resolve your request faster.