HawkShift

HawkShift API

HawkShift API as documented publicly: 5 operations. Contract generated from the documentation by API Evangelist (2026-11-11); not the provider's own document.

Documentation GitHub OpenAPI

Operations 5

POST /api/futurehawk/v1/conversations POST /api/futurehawk/v1/conversations #

POST /stream POST /stream #

POST /v1/conversations POST /v1/conversations #

POST /v1/conversations/{id}/stream POST /v1/conversations/{id}/stream #

POST /v1/widget-tokens POST /v1/widget-tokens #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/hawkshift-com/openapi/_ae-authored/hawkshift-com-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/hawkshift-com/json-schema/hawkshift-com-post-stream-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/hawkshift-com/json-schema/hawkshift-com-post-v1-widget-tokens-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/hawkshift-com/json-schema/hawkshift-com-post-v1-conversations-id-stream-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/hawkshift-com/json-schema/hawkshift-com-post-api-futurehawk-v1-conversations-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/hawkshift-com:hawkshift-com-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: HawkShift API
  version: '2026-11-11'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-11: 5 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; HawkShift has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 4
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-11'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://hawkshift.com/developers
paths:
  /api/futurehawk/v1/conversations:
    post:
      operationId: post_api_futurehawk_v1_conversations
      tags:
      - Api
      summary: POST /api/futurehawk/v1/conversations
      x-source: https://hawkshift.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiFuturehawkV1ConversationsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -N -X POST https://hawkshift.com/api/futurehawk/v1/conversations/ $ID /stream  -H "Authorization: Bearer fhk_…"  -H "Content-Type:
          application/json"  -d ''{"message":"Waterproof running shoes, 10 wide"}'' Response stream streaming Three ways to build From no code
          to all code. No code Shopify app Install the app, approve scopes, enable the theme block. Concierge reads your catalogue, prices and '
  /stream:
    post:
      operationId: post_stream
      tags:
      - Stream
      summary: POST /stream
      x-source: https://hawkshift.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostStreamRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/conversations:
    post:
      operationId: post_v1_conversations
      tags:
      - Conversations
      summary: POST /v1/conversations
      x-source: https://hawkshift.com/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/conversations/{id}/stream:
    post:
      operationId: post_v1_conversations_id_stream
      tags:
      - Conversations
      summary: POST /v1/conversations/{id}/stream
      x-source: https://hawkshift.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ConversationsIdStreamRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/widget-tokens:
    post:
      operationId: post_v1_widget_tokens
      tags:
      - Widget Tokens
      summary: POST /v1/widget-tokens
      x-source: https://hawkshift.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1WidgetTokensRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiFuturehawkV1ConversationsRequest:
      type: object
      properties:
        message:
          type: string
    PostStreamRequest:
      type: object
      properties:
        message:
          type: string
          description: Message to send.
        history:
          type: array
          description: Optional conversation history.
        memory:
          type: object
          description: Optional memory context.
        current_products:
          type: array
          description: Optional current product list.
        attachments:
          type: array
          description: Optional attachments.
      required:
      - message
    PostV1ConversationsIdStreamRequest:
      type: object
      properties:
        message:
          type: string
          description: Message to send to the conversation.
      required:
      - message
    PostV1WidgetTokensRequest:
      type: object
      properties:
        origin:
          type: string
          description: The allowed origin for the widget token.
        customer:
          type: string
          description: Optional shopper identifier to bind to the token.
      required:
      - origin
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Conversations
- name: Stream
- name: Widget Tokens