> ## Documentation Index > Fetch the complete documentation index at: https://docs.hookie.ai/llms.txt > Use this file to discover all available pages before exploring further. # Retry a workflow instance > Cloudflare engine (failed, timed_out or cancelled): restart() runs the instance again from the first step under a new run_attempt, with the context reset to the entry record; records an earlier attempt emitted are not emitted again. Legacy engine (failed or timed_out): continues from the step that failed (a timed-out wait parks again). Audited as retry_workflow_instance. ## OpenAPI ````yaml /openapi.json post /admin/api/projects/{project_id}/workflow-instances/{instance_id}/retry openapi: 3.1.0 info: title: Hookie API version: 1.0.0 summary: Capture, route and deliver webhooks. description: >- Hookie exposes three HTTP surfaces. **Ingest + streaming** is the public plane. A path-form endpoint URL authenticates by its own high-entropy slug — there is no key, token or cookie — and an `ik_live_…` ingest key authenticates the `/v1/*` routes. Whenever the URL names a dataset the payload is stored whole into it; project mapping rules are evaluated on exactly one shape, `POST /v1/ingest/{ingest_key}` with no dataset segment. **The customer portal API** is a separate, token-authed surface for your end customers, scoped to one portal and one customer. **The admin API** drives the console. It accepts either a browser session or an OAuth bearer token from a connected coding agent — the same routes, the same validation, the same audit trail. An agent's authority is its user's workspace role narrowed to the scopes granted in the console. This document is generated from the request handlers and adversarially verified against them. contact: name: Hookie url: https://hookie.ai license: name: Proprietary url: https://hookie.ai/legal/terms servers: - url: https://app.hookie.ai description: Production - url: https://app.preview.hookie.ai description: Preview security: [] tags: - name: Ingest description: Send events to Hookie. - name: Streaming description: Tail events in real time over SSE or WebSocket. - name: Portal description: Token-authed surface for your end customers. - name: Projects description: Projects and their settings. - name: Routing description: Rules, endpoints, datasets and records. - name: Delivery description: Destinations, deliveries and replay. - name: Workflows description: Multi-step workflows, triggers and AI agents. - name: Observability description: Search, correlation, stats and the audit log. - name: Workspace description: Members, connected agents, SSO and billing. - name: Data API description: >- Read-only access to the datasets and columns a project exposes, with per-project keys. - name: Broadcast Logs description: >- Forward a project's logs and traces over OTLP/HTTP (JSON) to Datadog, Grafana Cloud, an OpenTelemetry Collector, PostHog or Sentry. paths: /admin/api/projects/{project_id}/workflow-instances/{instance_id}/retry: post: tags: - Workflows summary: Retry a workflow instance description: >- Cloudflare engine (failed, timed_out or cancelled): restart() runs the instance again from the first step under a new run_attempt, with the context reset to the entry record; records an earlier attempt emitted are not emitted again. Legacy engine (failed or timed_out): continues from the step that failed (a timed-out wait parks again). Audited as retry_workflow_instance. operationId: retryWorkflowInstance parameters: - name: project_id in: path required: true schema: type: string - name: instance_id in: path required: true schema: type: string responses: '200': description: >- Retried. `state` is `pending` for a Cloudflare instance (it runs asynchronously); for a legacy instance, the state after it ran as far as it could. content: application/json: schema: type: object required: - ok - state properties: ok: type: boolean enum: - true state: type: string '401': description: Not signed in. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: >- `Insufficient role` (write capability required), or `Missing X-Requested-With header`. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: >- `Instance not found` (including an instance of another project or workspace), or `Project not found`. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: >- `A instance cannot be retried (only failed, timed_out, cancelled)` — or, for a legacy instance, only failed and timed_out. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: '`Internal error`.' content: application/json: schema: $ref: '#/components/schemas/Error' '502': description: Cloudflare refused the operation; nothing was changed. Try again. content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: >- `Cloudflare Workflows is not configured` (a Cloudflare instance on a Worker without the WORKFLOW binding). content: application/json: schema: $ref: '#/components/schemas/Error' security: - session: [] - bearerAuth: [] components: schemas: Error: type: object required: - error properties: error: type: string description: Human-readable reason. retry_after: type: integer description: Seconds to wait. Present on 429. upgrade_url: type: string format: uri description: Present only on a monthly-quota 429. securitySchemes: session: type: apiKey in: cookie name: hookie_session description: >- The console's sealed session cookie, set by WorkOS AuthKit. Mutating requests also require the `X-Requested-With` CSRF header. bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- An OAuth 2.1 access token from a connected agent, audienced at the `/mcp` resource URI. The agent acts as its user, with that user's role narrowed to the granted `hookie:*` scopes. No CSRF header is required — a bearer token is not ambient credentials. ````