Hamloy API

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

GitHub OpenAPI

Operations 15

GET /api/v1/projects GET /api/v1/projects #
GET /api/v1/projects/$PROJECT/items GET /api/v1/projects/$PROJECT/items #
POST /api/v1/projects/$PROJECT/items POST /api/v1/projects/$PROJECT/items #
GET /api/v1/projects/$PROJECT/items/B-k3f9 GET /projects/:id/items/:key is one item. #
PATCH /api/v1/projects/$PROJECT/items/B-k3f9 PATCH /api/v1/projects/$PROJECT/items/B-k3f9 #
GET /projects GET /projects lists the projects you are on: #
GET /projects/{id} GET /projects/:id is one project, with its lists: #
GET /projects/{id}/items GET /projects/:id/items lists what the list tool would, in list order, subtasks right after their parent: #
POST /projects/{id}/items POST /projects/:id/items with a JSON body adds an item: #
DELETE /projects/{id}/items/{key} DELETE /projects/:id/items/:key deletes an item with its subtasks: #
GET /projects/{id}/items/{key} GET /projects/:id/items/:key is one item. #
PATCH /projects/{id}/items/{key} PATCH /projects/:id/items/:key with any of title, summary, section, fields, needs, notes, add_note, list, options, recommended, before and after changes an item: #
POST /projects/{id}/items/{key}/answer POST /projects/:id/items/:key/answer, with answer and optional why, records an answer to a question: #
POST /projects/{id}/items/{key}/restore POST /projects/:id/items/:key/restore brings a deleted item back: #
POST /projects/{id}/items/{key}/tick POST /projects/:id/items/:key/tick, with an optional note, marks a task or request done: #

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/hamloy-com:hamloy-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.

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

OpenAPI Specification

hamloy-com-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: Hamloy API
  version: '2026-11-11'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-11: 15 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Hamloy has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 4
    documentation: 11
    pages-with-code: 2
    pages-read: 2
  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://hamloy.com/docs/api
  - https://hamloy.com/docs/api.md
paths:
  /api/v1/projects:
    get:
      operationId: get_api_v1_projects
      tags:
      - Api
      summary: GET /api/v1/projects
      x-source: https://hamloy.com/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://hamloy.com/api/v1/projects  -H \"Authorization: Bearer $HAMLOY_TOKEN\"\n A token reaches every project you are\
          \ on, with what you may do there. What a program changes is signed api in the history and in the agents' news (\"The API ticked B-k3f9\"\
          , or \"Sara's api\" on a shared project), so you can always tell what a program did from what you did yourself. \n Projects \n GET /projects\
          \ lists the "
  /api/v1/projects/$PROJECT/items:
    get:
      operationId: get_api_v1_projects_PROJECT_items
      tags:
      - Api
      summary: GET /api/v1/projects/$PROJECT/items
      x-source: https://hamloy.com/docs/api
      parameters:
      - name: kind
        in: query
        required: false
        schema:
          type: string
      - name: status
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"https://hamloy.com/api/v1/projects/$PROJECT/items?kind=task&status=ready\"  -H \"Authorization: Bearer $HAMLOY_TOKEN\"\
          \n {\n \"project\": { \"id\": \"4f0c2a9e-…\", \"name\": \"Pebble\" },\n \"total\": 12, \"from\": 0, \"next\": null,\n \"items\": [\n\
          \ {\n \"key\": \"B-k3f9\", \"version\": \"B-k3f9@3\", \"kind\": \"task\", \"list\": \"backlog\",\n \"title\": \"Streak counter on the\
          \ habit card\", \"summary\": null, \"section\": \"This week\",\n \"no"
    post:
      operationId: post_api_v1_projects_PROJECT_items
      tags:
      - Api
      summary: POST /api/v1/projects/$PROJECT/items
      x-source: https://hamloy.com/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ProjectsProjectItemsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://hamloy.com/api/v1/projects/$PROJECT/items  -H \"Authorization: Bearer $HAMLOY_TOKEN\" -H \"Content-Type: application/json\"\
          \  -d '{\"title\": \"Checkout fails for cards from Brazil\", \"kind\": \"task\", \"section\": \"Bugs\",\n \"summary\": \"Stripe declines\
          \ with a currency error\", \"notes\": \"Seen 14 times since Monday.\",\n \"fields\": {\"area\": \"billing\", \"prio\": \"high\"}}'\n\
          \ Field \n title \n required, one line"
  /api/v1/projects/$PROJECT/items/B-k3f9:
    get:
      operationId: get_api_v1_projects_PROJECT_items_B_k3f9
      tags:
      - Api
      summary: GET /projects/:id/items/:key is one item.
      description: Retrieves a single item identified by its key within a project.
      x-source: https://hamloy.com/docs/api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1ProjectsProjectItemsBK3F9Response'
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_api_v1_projects_PROJECT_items_B_k3f9
      tags:
      - Api
      summary: PATCH /api/v1/projects/$PROJECT/items/B-k3f9
      x-source: https://hamloy.com/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchApiV1ProjectsProjectItemsBK3F9Request'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X PATCH https://hamloy.com/api/v1/projects/$PROJECT/items/B-k3f9  -H \"Authorization: Bearer $HAMLOY_TOKEN\" -H \"Content-Type:\
          \ application/json\"  -d '{\"version\": \"B-k3f9@3\", \"fields\": {\"prio\": \"high\"}, \"add_note\": \"Two more reports today.\"}'\n\
          \ Ticking, answering, deleting \n POST /projects/:id/items/:key/tick , with an optional note : marks a task or request done. {\"done\"\
          : false} opens it again."
  /projects:
    get:
      operationId: get_projects
      tags:
      - Projects
      summary: 'GET /projects lists the projects you are on:'
      x-source: https://hamloy.com/docs/api.md
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetProjectsResponse'
      x-evidence:
        kind: documentation
  /projects/{id}:
    get:
      operationId: get_projects_id
      tags:
      - Projects
      summary: 'GET /projects/:id is one project, with its lists:'
      x-source: https://hamloy.com/docs/api.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetProjectsIdResponse'
      x-evidence:
        kind: documentation
  /projects/{id}/items:
    get:
      operationId: get_projects_id_items
      tags:
      - Projects
      summary: 'GET /projects/:id/items lists what the list tool would, in list order, subtasks right after their parent:'
      x-source: https://hamloy.com/docs/api.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: kind
        in: query
        required: false
        schema:
          type: string
      - name: status
        in: query
        required: false
        schema:
          type: string
      - name: section
        in: query
        required: false
        schema:
          type: string
      - name: find
        in: query
        required: false
        schema:
          type: string
      - name: from
        in: query
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetProjectsIdItemsResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_projects_id_items
      tags:
      - Projects
      summary: 'POST /projects/:id/items with a JSON body adds an item:'
      x-source: https://hamloy.com/docs/api.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostProjectsIdItemsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostProjectsIdItemsResponse'
      x-evidence:
        kind: documentation
  /projects/{id}/items/{key}:
    delete:
      operationId: delete_projects_id_items_key
      tags:
      - Projects
      summary: 'DELETE /projects/:id/items/:key deletes an item with its subtasks:'
      x-source: https://hamloy.com/docs/api.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: key
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteProjectsIdItemsKeyResponse'
      x-evidence:
        kind: documentation
    get:
      operationId: get_projects_id_items_key
      tags:
      - Projects
      summary: GET /projects/:id/items/:key is one item.
      x-source: https://hamloy.com/docs/api.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: key
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetProjectsIdItemsKeyResponse'
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_projects_id_items_key
      tags:
      - Projects
      summary: 'PATCH /projects/:id/items/:key with any of title, summary, section, fields, needs, notes, add_note, list, options, recommended,
        before and after changes an item:'
      x-source: https://hamloy.com/docs/api.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: key
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchProjectsIdItemsKeyRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchProjectsIdItemsKeyResponse'
      x-evidence:
        kind: documentation
  /projects/{id}/items/{key}/answer:
    post:
      operationId: post_projects_id_items_key_answer
      tags:
      - Projects
      summary: 'POST /projects/:id/items/:key/answer, with answer and optional why, records an answer to a question:'
      x-source: https://hamloy.com/docs/api.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: key
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostProjectsIdItemsKeyAnswerRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostProjectsIdItemsKeyAnswerResponse'
      x-evidence:
        kind: documentation
  /projects/{id}/items/{key}/restore:
    post:
      operationId: post_projects_id_items_key_restore
      tags:
      - Projects
      summary: 'POST /projects/:id/items/:key/restore brings a deleted item back:'
      x-source: https://hamloy.com/docs/api.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: key
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostProjectsIdItemsKeyRestoreResponse'
      x-evidence:
        kind: documentation
  /projects/{id}/items/{key}/tick:
    post:
      operationId: post_projects_id_items_key_tick
      tags:
      - Projects
      summary: 'POST /projects/:id/items/:key/tick, with an optional note, marks a task or request done:'
      x-source: https://hamloy.com/docs/api.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: key
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostProjectsIdItemsKeyTickRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostProjectsIdItemsKeyTickResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiV1ProjectsProjectItemsRequest:
      type: object
      properties:
        title:
          type: string
        kind:
          type: string
        section:
          type: string
        summary:
          type: string
        notes:
          type: string
        fields:
          type: object
          properties:
            area:
              type: string
            prio:
              type: string
    GetApiV1ProjectsProjectItemsBK3F9Response:
      type: object
      properties:
        project:
          type: object
          description: Project information containing id and name.
        total:
          type: integer
          description: Total number of items matching the query.
        from:
          type: integer
          description: Paging offset of the first returned item.
        next:
          type: integer
          description: Paging offset for the next page, or null if last.
        items:
          type: array
          description: Array containing the requested item(s).
        items[].key:
          type: string
          description: Item key.
        items[].version:
          type: string
          description: Version string of the item.
        items[].kind:
          type: string
          description: Kind of the item (task, request, etc.).
        items[].list:
          type: string
          description: List name the item belongs to.
        items[].title:
          type: string
          description: Title of the item.
        items[].summary:
          type: string
          description: Short summary.
        items[].section:
          type: string
          description: Section heading.
        items[].notes:
          type: string
          description: Notes text.
        items[].fields:
          type: object
          description: Custom fields as key/value pairs.
        items[].parent:
          type: string
          description: Parent item key if this is a subtask.
        items[].subtasks:
          type: array
          description: Array of subtask keys.
        items[].needs:
          type: array
          description: Keys this item waits on.
        items[].ready:
          type: boolean
          description: Whether the item is ready.
        items[].claimed_by:
          type: string
          description: User who claimed the item.
        items[].done:
          type: boolean
          description: Completion status.
        items[].done_at:
          type: string
          description: Timestamp when marked done.
        items[].done_by:
          type: string
          description: User who marked it done.
        items[].added_at:
          type: string
          description: Timestamp when the item was added.
        items[].added_by:
          type: string
          description: User who added the item.
        items[].url:
          type: string
          description: Web URL for the item.
    PatchApiV1ProjectsProjectItemsBK3F9Request:
      type: object
      properties:
        version:
          type: string
        fields:
          type: object
          properties:
            prio:
              type: string
        add_note:
          type: string
    GetProjectsResponse:
      type: object
      properties:
        projects:
          type: array
          description: list of project objects
    GetProjectsIdResponse:
      type: object
      properties:
        project:
          type: object
          description: project details including lists
    GetProjectsIdItemsResponse:
      type: object
      properties:
        project:
          type: object
        total:
          type: integer
        from:
          type: integer
        next:
          type: integer
        items:
          type: array
          description: list of item objects
    PostProjectsIdItemsRequest:
      type: object
      properties:
        title:
          type: string
        kind:
          type: string
        section:
          type: string
        summary:
          type: string
        notes:
          type: string
        fields:
          type: object
        needs:
          type: array
        parent:
          type: string
        subtasks:
          type: array
        options:
          type: array
        recommended:
          type: integer
      required:
      - title
    PostProjectsIdItemsResponse:
      type: object
      properties:
        item:
          type: object
          description: the created item
    DeleteProjectsIdItemsKeyResponse:
      type: object
      properties:
        item:
          type: object
    GetProjectsIdItemsKeyResponse:
      type: object
      properties:
        item:
          type: object
          description: the requested item
    PatchProjectsIdItemsKeyRequest:
      type: object
      properties:
        version:
          type: string
        title:
          type: string
        summary:
          type: string
        section:
          type: string
        fields:
          type: object
        needs:
          type: array
        notes:
          type: array
        add_note:
          type: string
        list:
          type: string
        options:
          type: array
        recommended:
          type: integer
        before:
          type: string
        after:
          type: string
      required:
      - version
    PatchProjectsIdItemsKeyResponse:
      type: object
      properties:
        item:
          type: object
          description: the updated item
    PostProjectsIdItemsKeyAnswerRequest:
      type: object
      properties:
        answer:
          type: string
        why:
          type: string
      required:
      - answer
    PostProjectsIdItemsKeyAnswerResponse:
      type: object
      properties:
        item:
          type: object
    PostProjectsIdItemsKeyRestoreResponse:
      type: object
      properties:
        item:
          type: object
    PostProjectsIdItemsKeyTickRequest:
      type: object
      properties:
        note:
          type: string
        done:
          type: boolean
    PostProjectsIdItemsKeyTickResponse:
      type: object
      properties:
        item:
          type: object
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Projects