Skip to content
Skip to main content
API quickstart

Task Agent

API quickstart

Create a key, submit a task, and read execution results.

Use a personal API key to submit tasks from your server and follow progress through events. This guide uses the same public contract as the in-product Task Agent API documentation.

Prepare the URL and key

Create a personal key on the Manage API keys page. Task submission needs prompts:write; sessions and events need sessions:read. Save the full key and set these variables in your terminal:

export HAST_API_BASE='https://backend.hast.so/api/public/v1'
export HAST_API_KEY='<YOUR_PERSONAL_API_KEY>'

Submit your first task

curl --fail-with-body --request POST \
  --url "$HAST_API_BASE/prompts" \
  --header "Authorization: Bearer $HAST_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"request_id":"req_123","prompt":"Summarize the latest workspace files."}'

This asks the Agent to summarize workspace files. Replace prompt with your requirements.

Omitting session_id creates a session; sending the same identifier later continues it. request_id provides idempotency; use a new value for each new turn.

The API returns HTTP 202 after acceptance. Save session_id from the response and keep reading events for the outcome. See the API reference for complete fields and responses.

Read execution progress

Set the returned identifier as SESSION_ID:

export SESSION_ID='<SESSION_ID_FROM_RESPONSE>'
curl -N --fail-with-body \
  "$HAST_API_BASE/sessions/$SESSION_ID/events/stream?after=0" \
  --header "Authorization: Bearer $HAST_API_KEY" \
  --header 'Accept: text/event-stream'

SSE carries HAST Event v2. Display messages, tool progress, and run results according to event type. message.completed completes a message; use run events to determine whether the whole turn has ended. See event streaming.

Continue integration

The API reference covers sessions, files, Skills, memory, connectors, and secrets. Expand an endpoint for parameters and response schemas, or download OpenAPI JSON for tools supporting Swagger / OpenAPI 2.0.

Meet HastLearn about Hast AIP, Hast Agent, Hast GTM, and delivery with the FDE team.About AIPConfigure Agents and connect business systems using the FDE delivery workbench.Create your first AgentConfigure, save, and debug an Agent without external services.Configure and manage AgentsSet responsibilities, models, and capabilities, and maintain the active configuration.Manage SkillsWrite, import, and select the skill files used by Agents.Add a knowledge baseIndex URLs or files so an Agent can retrieve information from them.Manage business secretsStore credentials and bind them to Agents without exposing real values in examples.Connect business toolsLet Agents call HTTP services with explicit inputs and authentication.Configure long-term memoryChoose what memory an Agent can read and where new memory is written.Debug an AgentTest saved configurations, conversation continuity, and tool results.Import, export, and copyReuse configurations and recheck resources and credentials after migration.HTTP integrationInvoke an Agent from your server, continue conversations, read replies, and stop execution.MCP integrationConnect external Agent clients to AIP tools with a Public API Key.About Task AgentPlan, execute, and deliver complete tasks with tools, files, and lasting context.Complete your first taskSubmit a request, review the plan, and inspect the final output.Plan, execute, and manage conversationsRefine plans, stop execution, and manage conversation history.Upload, view, and download filesProvide inputs and keep the files created by your tasks.Connect apps and configure capabilitiesAuthorize external apps and maintain context across tasks.Create scheduled tasksSet recurrence and timezone, then inspect each run's result.Task Agent troubleshootingCheck access, connections, task state, and files.API quickstartCreate a key, submit a task, and read execution results.Event streamingRead SSE frames, resume after disconnection, and interpret Event v2.API referenceExplore public endpoint parameters, authentication, and response schemas.About GTMUse a shared website project for research, visibility analysis, and marketing drafts.Create your first GTM projectEnter a website, wait for initialization, and inspect the first results.Manage projects and website contextSwitch projects, refresh site information, and manage project settings.Company analysis and project documentsReview product, competitor, and marketing context before content tasks.SEO and website performanceRead PageSpeed reports for mobile and desktop.AI brand mentionsInspect buyer questions and whether model answers mention your brand.Connect Google AnalyticsAuthorize an account, choose a GA property, and inspect traffic reports.Generate and publish X draftsCreate posts, review previews, and finish publishing on X.Generate article draftsSet style, language, and audience, then review and copy Markdown.Use Growth AgentRead project context or start supported background operations in conversation.Run status and troubleshootingCheck queueing, dependencies, and results without treating unfinished work as missing data.Plans and usageCheck access, consumption, and billing for the current Profile.