naftiko: 1.0.0-alpha2
info:
  label: Dev.to Forem API
  description: The Dev.to Forem API (v1) is a RESTful API that provides programmatic access to the Dev.to developer community
    platform, which is built on the open-source Forem framework. The API enables developers to create, read, update, and manage
    articles, comments, users, organizations, tags, followers, listings, podcast episodes, pages, display ads, reactions,
    reading lists, and webhooks. It uses API key authentication, requires an accept header of application/vnd.forem.api-v1+json,
    and returns JSON responses. Unauthenticated endpoints are CORS-enabled, making it possible to fetch public content directl
  tags:
  - Dev
  - To
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: dev-to
    baseUri: https://dev.to/api
    description: Dev.to Forem API HTTP API.
    authentication:
      type: apikey
      in: header
      name: api-key
      value: '{{DEV_TO_TOKEN}}'
    resources:
    - name: articles
      path: /articles
      operations:
      - name: createarticle
        method: POST
        description: Publish article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getarticles
        method: GET
        description: Published articles
        inputParameters:
        - name: tag
          in: query
          type: string
          description: Filter articles by a single tag name.
        - name: tags
          in: query
          type: string
          description: Filter articles by a comma-separated list of tag names (articles must have all specified tags).
        - name: tags_exclude
          in: query
          type: string
          description: Exclude articles with these comma-separated tag names.
        - name: username
          in: query
          type: string
          description: Filter articles by the author's username.
        - name: state
          in: query
          type: string
          description: Filter articles by state. Defaults to the most popular articles.
        - name: top
          in: query
          type: integer
          description: Return the most popular articles published in the last N days.
        - name: collection_id
          in: query
          type: integer
          description: Return articles belonging to the specified collection.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: articles-latest
      path: /articles/latest
      operations:
      - name: getlatestarticles
        method: GET
        description: Published articles sorted by published date
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: articles-id
      path: /articles/{id}
      operations:
      - name: getarticlebyid
        method: GET
        description: Published article by id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatearticle
        method: PUT
        description: Update an article by id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: articles-username-slug
      path: /articles/{username}/{slug}
      operations:
      - name: getarticlebypath
        method: GET
        description: Published article by path
        inputParameters:
        - name: username
          in: path
          type: string
          required: true
          description: The username of the article's author.
        - name: slug
          in: path
          type: string
          required: true
          description: The slug of the article.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: articles-me
      path: /articles/me
      operations:
      - name: getuserarticles
        method: GET
        description: User's articles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: articles-me-published
      path: /articles/me/published
      operations:
      - name: getuserpublishedarticles
        method: GET
        description: User's published articles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: articles-me-unpublished
      path: /articles/me/unpublished
      operations:
      - name: getuserunpublishedarticles
        method: GET
        description: User's unpublished articles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: articles-me-all
      path: /articles/me/all
      operations:
      - name: getuserallarticles
        method: GET
        description: User's all articles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: articles-id-unpublish
      path: /articles/{id}/unpublish
      operations:
      - name: unpublisharticle
        method: PUT
        description: Unpublish an article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: comments
      path: /comments
      operations:
      - name: getcommentsbyarticleid
        method: GET
        description: Comments
        inputParameters:
        - name: a_id
          in: query
          type: integer
          description: The article ID to retrieve comments for.
        - name: p_id
          in: query
          type: integer
          description: The podcast episode ID to retrieve comments for.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: comments-id
      path: /comments/{id}
      operations:
      - name: getcommentbyid
        method: GET
        description: Comment by id
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: The ID of the comment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: display-ads
      path: /display_ads
      operations:
      - name: getdisplayads
        method: GET
        description: Display ads
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createdisplayad
        method: POST
        description: Create display ad
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: display-ads-id
      path: /display_ads/{id}
      operations:
      - name: getdisplayadbyid
        method: GET
        description: Display ad
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: The ID of the display ad.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatedisplayad
        method: PUT
        description: Update display ad
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: The ID of the display ad.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: display-ads-id-unpublish
      path: /display_ads/{id}/unpublish
      operations:
      - name: unpublishdisplayad
        method: PUT
        description: Unpublish display ad
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: The ID of the display ad.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: follows-tags
      path: /follows/tags
      operations:
      - name: getfollowedtags
        method: GET
        description: Followed Tags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: followers-users
      path: /followers/users
      operations:
      - name: getfollowers
        method: GET
        description: Followers
        inputParameters:
        - name: sort
          in: query
          type: string
          description: Sort order for followers.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: organizations-username
      path: /organizations/{username}
      operations:
      - name: getorganization
        method: GET
        description: An organization
        inputParameters:
        - name: username
          in: path
          type: string
          required: true
          description: The username (slug) of the organization.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: organizations-username-users
      path: /organizations/{username}/users
      operations:
      - name: getorgusers
        method: GET
        description: Organization's users
        inputParameters:
        - name: username
          in: path
          type: string
          required: true
          description: The username (slug) of the organization.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: organizations-username-articles
      path: /organizations/{username}/articles
      operations:
      - name: getorgarticles
        method: GET
        description: Organization's Articles
        inputParameters:
        - name: username
          in: path
          type: string
          required: true
          description: The username (slug) of the organization.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pages
      path: /pages
      operations:
      - name: getpages
        method: GET
        description: Show details for all pages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createpage
        method: POST
        description: Create a new page
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pages-id
      path: /pages/{id}
      operations:
      - name: getpagebyid
        method: GET
        description: Show details for a page
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: The ID of the page.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatepage
        method: PUT
        description: Update details for a page
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: The ID of the page.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletepage
        method: DELETE
        description: Remove a page
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: The ID of the page.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: podcast-episodes
      path: /podcast_episodes
      operations:
      - name: getpodcastepisodes
        method: GET
        description: Podcast Episodes
        inputParameters:
        - name: username
          in: query
          type: string
          description: Filter podcast episodes by the podcast owner's username.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: profile-images-username
      path: /profile_images/{username}
      operations:
      - name: getprofileimage
        method: GET
        description: A Users or organizations profile image
        inputParameters:
        - name: username
          in: path
          type: string
          required: true
          description: The username of the user or organization.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: reactions-toggle
      path: /reactions/toggle
      operations:
      - name: togglereaction
        method: POST
        description: Toggle reaction
        inputParameters:
        - name: category
          in: query
          type: string
          required: true
          description: The category of reaction.
        - name: reactable_id
          in: query
          type: integer
          required: true
          description: The ID of the reactable entity.
        - name: reactable_type
          in: query
          type: string
          required: true
          description: The type of entity being reacted to.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: reactions
      path: /reactions
      operations:
      - name: createreaction
        method: POST
        description: Create reaction
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: readinglist
      path: /readinglist
      operations:
      - name: getreadinglist
        method: GET
        description: Readinglist
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: tags
      path: /tags
      operations:
      - name: gettags
        method: GET
        description: Tags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: users-me
      path: /users/me
      operations:
      - name: getuserme
        method: GET
        description: The authenticated user
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: users-id
      path: /users/{id}
      operations:
      - name: getuser
        method: GET
        description: A User
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: The ID of the user.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: users-id-unpublish
      path: /users/{id}/unpublish
      operations:
      - name: unpublishuser
        method: PUT
        description: Unpublish a User's Articles and Comments
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: The ID of the user.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: users-id-suspend
      path: /users/{id}/suspend
      operations:
      - name: suspenduser
        method: PUT
        description: Suspend a User
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: The ID of the user.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: webhooks
      path: /webhooks
      operations:
      - name: getwebhooks
        method: GET
        description: Webhooks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createwebhook
        method: POST
        description: Create a webhook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: webhooks-id
      path: /webhooks/{id}
      operations:
      - name: getwebhookbyid
        method: GET
        description: A webhook endpoint
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: The ID of the webhook.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletewebhook
        method: DELETE
        description: Delete a webhook endpoint
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: The ID of the webhook.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: dev-to-rest
    description: REST adapter for Dev.to Forem API.
    resources:
    - path: /articles
      name: createarticle
      operations:
      - method: POST
        name: createarticle
        description: Publish article
        call: dev-to.createarticle
        outputParameters:
        - type: object
          mapping: $.
    - path: /articles
      name: getarticles
      operations:
      - method: GET
        name: getarticles
        description: Published articles
        call: dev-to.getarticles
        outputParameters:
        - type: object
          mapping: $.
    - path: /articles/latest
      name: getlatestarticles
      operations:
      - method: GET
        name: getlatestarticles
        description: Published articles sorted by published date
        call: dev-to.getlatestarticles
        outputParameters:
        - type: object
          mapping: $.
    - path: /articles/{id}
      name: getarticlebyid
      operations:
      - method: GET
        name: getarticlebyid
        description: Published article by id
        call: dev-to.getarticlebyid
        outputParameters:
        - type: object
          mapping: $.
    - path: /articles/{id}
      name: updatearticle
      operations:
      - method: PUT
        name: updatearticle
        description: Update an article by id
        call: dev-to.updatearticle
        outputParameters:
        - type: object
          mapping: $.
    - path: /articles/{username}/{slug}
      name: getarticlebypath
      operations:
      - method: GET
        name: getarticlebypath
        description: Published article by path
        call: dev-to.getarticlebypath
        with:
          username: rest.username
          slug: rest.slug
        outputParameters:
        - type: object
          mapping: $.
    - path: /articles/me
      name: getuserarticles
      operations:
      - method: GET
        name: getuserarticles
        description: User's articles
        call: dev-to.getuserarticles
        outputParameters:
        - type: object
          mapping: $.
    - path: /articles/me/published
      name: getuserpublishedarticles
      operations:
      - method: GET
        name: getuserpublishedarticles
        description: User's published articles
        call: dev-to.getuserpublishedarticles
        outputParameters:
        - type: object
          mapping: $.
    - path: /articles/me/unpublished
      name: getuserunpublishedarticles
      operations:
      - method: GET
        name: getuserunpublishedarticles
        description: User's unpublished articles
        call: dev-to.getuserunpublishedarticles
        outputParameters:
        - type: object
          mapping: $.
    - path: /articles/me/all
      name: getuserallarticles
      operations:
      - method: GET
        name: getuserallarticles
        description: User's all articles
        call: dev-to.getuserallarticles
        outputParameters:
        - type: object
          mapping: $.
    - path: /articles/{id}/unpublish
      name: unpublisharticle
      operations:
      - method: PUT
        name: unpublisharticle
        description: Unpublish an article
        call: dev-to.unpublisharticle
        outputParameters:
        - type: object
          mapping: $.
    - path: /comments
      name: getcommentsbyarticleid
      operations:
      - method: GET
        name: getcommentsbyarticleid
        description: Comments
        call: dev-to.getcommentsbyarticleid
        outputParameters:
        - type: object
          mapping: $.
    - path: /comments/{id}
      name: getcommentbyid
      operations:
      - method: GET
        name: getcommentbyid
        description: Comment by id
        call: dev-to.getcommentbyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /display_ads
      name: getdisplayads
      operations:
      - method: GET
        name: getdisplayads
        description: Display ads
        call: dev-to.getdisplayads
        outputParameters:
        - type: object
          mapping: $.
    - path: /display_ads
      name: createdisplayad
      operations:
      - method: POST
        name: createdisplayad
        description: Create display ad
        call: dev-to.createdisplayad
        outputParameters:
        - type: object
          mapping: $.
    - path: /display_ads/{id}
      name: getdisplayadbyid
      operations:
      - method: GET
        name: getdisplayadbyid
        description: Display ad
        call: dev-to.getdisplayadbyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /display_ads/{id}
      name: updatedisplayad
      operations:
      - method: PUT
        name: updatedisplayad
        description: Update display ad
        call: dev-to.updatedisplayad
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /display_ads/{id}/unpublish
      name: unpublishdisplayad
      operations:
      - method: PUT
        name: unpublishdisplayad
        description: Unpublish display ad
        call: dev-to.unpublishdisplayad
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /follows/tags
      name: getfollowedtags
      operations:
      - method: GET
        name: getfollowedtags
        description: Followed Tags
        call: dev-to.getfollowedtags
        outputParameters:
        - type: object
          mapping: $.
    - path: /followers/users
      name: getfollowers
      operations:
      - method: GET
        name: getfollowers
        description: Followers
        call: dev-to.getfollowers
        outputParameters:
        - type: object
          mapping: $.
    - path: /organizations/{username}
      name: getorganization
      operations:
      - method: GET
        name: getorganization
        description: An organization
        call: dev-to.getorganization
        with:
          username: rest.username
        outputParameters:
        - type: object
          mapping: $.
    - path: /organizations/{username}/users
      name: getorgusers
      operations:
      - method: GET
        name: getorgusers
        description: Organization's users
        call: dev-to.getorgusers
        with:
          username: rest.username
        outputParameters:
        - type: object
          mapping: $.
    - path: /organizations/{username}/articles
      name: getorgarticles
      operations:
      - method: GET
        name: getorgarticles
        description: Organization's Articles
        call: dev-to.getorgarticles
        with:
          username: rest.username
        outputParameters:
        - type: object
          mapping: $.
    - path: /pages
      name: getpages
      operations:
      - method: GET
        name: getpages
        description: Show details for all pages
        call: dev-to.getpages
        outputParameters:
        - type: object
          mapping: $.
    - path: /pages
      name: createpage
      operations:
      - method: POST
        name: createpage
        description: Create a new page
        call: dev-to.createpage
        outputParameters:
        - type: object
          mapping: $.
    - path: /pages/{id}
      name: getpagebyid
      operations:
      - method: GET
        name: getpagebyid
        description: Show details for a page
        call: dev-to.getpagebyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /pages/{id}
      name: updatepage
      operations:
      - method: PUT
        name: updatepage
        description: Update details for a page
        call: dev-to.updatepage
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /pages/{id}
      name: deletepage
      operations:
      - method: DELETE
        name: deletepage
        description: Remove a page
        call: dev-to.deletepage
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /podcast_episodes
      name: getpodcastepisodes
      operations:
      - method: GET
        name: getpodcastepisodes
        description: Podcast Episodes
        call: dev-to.getpodcastepisodes
        outputParameters:
        - type: object
          mapping: $.
    - path: /profile_images/{username}
      name: getprofileimage
      operations:
      - method: GET
        name: getprofileimage
        description: A Users or organizations profile image
        call: dev-to.getprofileimage
        with:
          username: rest.username
        outputParameters:
        - type: object
          mapping: $.
    - path: /reactions/toggle
      name: togglereaction
      operations:
      - method: POST
        name: togglereaction
        description: Toggle reaction
        call: dev-to.togglereaction
        outputParameters:
        - type: object
          mapping: $.
    - path: /reactions
      name: createreaction
      operations:
      - method: POST
        name: createreaction
        description: Create reaction
        call: dev-to.createreaction
        outputParameters:
        - type: object
          mapping: $.
    - path: /readinglist
      name: getreadinglist
      operations:
      - method: GET
        name: getreadinglist
        description: Readinglist
        call: dev-to.getreadinglist
        outputParameters:
        - type: object
          mapping: $.
    - path: /tags
      name: gettags
      operations:
      - method: GET
        name: gettags
        description: Tags
        call: dev-to.gettags
        outputParameters:
        - type: object
          mapping: $.
    - path: /users/me
      name: getuserme
      operations:
      - method: GET
        name: getuserme
        description: The authenticated user
        call: dev-to.getuserme
        outputParameters:
        - type: object
          mapping: $.
    - path: /users/{id}
      name: getuser
      operations:
      - method: GET
        name: getuser
        description: A User
        call: dev-to.getuser
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /users/{id}/unpublish
      name: unpublishuser
      operations:
      - method: PUT
        name: unpublishuser
        description: Unpublish a User's Articles and Comments
        call: dev-to.unpublishuser
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /users/{id}/suspend
      name: suspenduser
      operations:
      - method: PUT
        name: suspenduser
        description: Suspend a User
        call: dev-to.suspenduser
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /webhooks
      name: getwebhooks
      operations:
      - method: GET
        name: getwebhooks
        description: Webhooks
        call: dev-to.getwebhooks
        outputParameters:
        - type: object
          mapping: $.
    - path: /webhooks
      name: createwebhook
      operations:
      - method: POST
        name: createwebhook
        description: Create a webhook
        call: dev-to.createwebhook
        outputParameters:
        - type: object
          mapping: $.
    - path: /webhooks/{id}
      name: getwebhookbyid
      operations:
      - method: GET
        name: getwebhookbyid
        description: A webhook endpoint
        call: dev-to.getwebhookbyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /webhooks/{id}
      name: deletewebhook
      operations:
      - method: DELETE
        name: deletewebhook
        description: Delete a webhook endpoint
        call: dev-to.deletewebhook
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: dev-to-mcp
    transport: http
    description: MCP adapter for Dev.to Forem API for AI agent use.
    tools:
    - name: createarticle
      description: Publish article
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: dev-to.createarticle
      outputParameters:
      - type: object
        mapping: $.
    - name: getarticles
      description: Published articles
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getarticles
      with:
        tag: tools.tag
        tags: tools.tags
        tags_exclude: tools.tags_exclude
        username: tools.username
        state: tools.state
        top: tools.top
        collection_id: tools.collection_id
      inputParameters:
      - name: tag
        type: string
        description: Filter articles by a single tag name.
      - name: tags
        type: string
        description: Filter articles by a comma-separated list of tag names (articles must have all specified tags).
      - name: tags_exclude
        type: string
        description: Exclude articles with these comma-separated tag names.
      - name: username
        type: string
        description: Filter articles by the author's username.
      - name: state
        type: string
        description: Filter articles by state. Defaults to the most popular articles.
      - name: top
        type: integer
        description: Return the most popular articles published in the last N days.
      - name: collection_id
        type: integer
        description: Return articles belonging to the specified collection.
      outputParameters:
      - type: object
        mapping: $.
    - name: getlatestarticles
      description: Published articles sorted by published date
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getlatestarticles
      outputParameters:
      - type: object
        mapping: $.
    - name: getarticlebyid
      description: Published article by id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getarticlebyid
      outputParameters:
      - type: object
        mapping: $.
    - name: updatearticle
      description: Update an article by id
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: dev-to.updatearticle
      outputParameters:
      - type: object
        mapping: $.
    - name: getarticlebypath
      description: Published article by path
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getarticlebypath
      with:
        username: tools.username
        slug: tools.slug
      inputParameters:
      - name: username
        type: string
        description: The username of the article's author.
        required: true
      - name: slug
        type: string
        description: The slug of the article.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: getuserarticles
      description: User's articles
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getuserarticles
      outputParameters:
      - type: object
        mapping: $.
    - name: getuserpublishedarticles
      description: User's published articles
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getuserpublishedarticles
      outputParameters:
      - type: object
        mapping: $.
    - name: getuserunpublishedarticles
      description: User's unpublished articles
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getuserunpublishedarticles
      outputParameters:
      - type: object
        mapping: $.
    - name: getuserallarticles
      description: User's all articles
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getuserallarticles
      outputParameters:
      - type: object
        mapping: $.
    - name: unpublisharticle
      description: Unpublish an article
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: dev-to.unpublisharticle
      outputParameters:
      - type: object
        mapping: $.
    - name: getcommentsbyarticleid
      description: Comments
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getcommentsbyarticleid
      with:
        a_id: tools.a_id
        p_id: tools.p_id
      inputParameters:
      - name: a_id
        type: integer
        description: The article ID to retrieve comments for.
      - name: p_id
        type: integer
        description: The podcast episode ID to retrieve comments for.
      outputParameters:
      - type: object
        mapping: $.
    - name: getcommentbyid
      description: Comment by id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getcommentbyid
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: string
        description: The ID of the comment.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: getdisplayads
      description: Display ads
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getdisplayads
      outputParameters:
      - type: object
        mapping: $.
    - name: createdisplayad
      description: Create display ad
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: dev-to.createdisplayad
      outputParameters:
      - type: object
        mapping: $.
    - name: getdisplayadbyid
      description: Display ad
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getdisplayadbyid
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: integer
        description: The ID of the display ad.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: updatedisplayad
      description: Update display ad
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: dev-to.updatedisplayad
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: integer
        description: The ID of the display ad.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: unpublishdisplayad
      description: Unpublish display ad
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: dev-to.unpublishdisplayad
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: integer
        description: The ID of the display ad.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: getfollowedtags
      description: Followed Tags
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getfollowedtags
      outputParameters:
      - type: object
        mapping: $.
    - name: getfollowers
      description: Followers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getfollowers
      with:
        sort: tools.sort
      inputParameters:
      - name: sort
        type: string
        description: Sort order for followers.
      outputParameters:
      - type: object
        mapping: $.
    - name: getorganization
      description: An organization
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getorganization
      with:
        username: tools.username
      inputParameters:
      - name: username
        type: string
        description: The username (slug) of the organization.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: getorgusers
      description: Organization's users
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getorgusers
      with:
        username: tools.username
      inputParameters:
      - name: username
        type: string
        description: The username (slug) of the organization.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: getorgarticles
      description: Organization's Articles
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getorgarticles
      with:
        username: tools.username
      inputParameters:
      - name: username
        type: string
        description: The username (slug) of the organization.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: getpages
      description: Show details for all pages
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getpages
      outputParameters:
      - type: object
        mapping: $.
    - name: createpage
      description: Create a new page
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: dev-to.createpage
      outputParameters:
      - type: object
        mapping: $.
    - name: getpagebyid
      description: Show details for a page
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getpagebyid
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: integer
        description: The ID of the page.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: updatepage
      description: Update details for a page
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: dev-to.updatepage
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: integer
        description: The ID of the page.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: deletepage
      description: Remove a page
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: dev-to.deletepage
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: integer
        description: The ID of the page.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: getpodcastepisodes
      description: Podcast Episodes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getpodcastepisodes
      with:
        username: tools.username
      inputParameters:
      - name: username
        type: string
        description: Filter podcast episodes by the podcast owner's username.
      outputParameters:
      - type: object
        mapping: $.
    - name: getprofileimage
      description: A Users or organizations profile image
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getprofileimage
      with:
        username: tools.username
      inputParameters:
      - name: username
        type: string
        description: The username of the user or organization.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: togglereaction
      description: Toggle reaction
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: dev-to.togglereaction
      with:
        category: tools.category
        reactable_id: tools.reactable_id
        reactable_type: tools.reactable_type
      inputParameters:
      - name: category
        type: string
        description: The category of reaction.
        required: true
      - name: reactable_id
        type: integer
        description: The ID of the reactable entity.
        required: true
      - name: reactable_type
        type: string
        description: The type of entity being reacted to.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: createreaction
      description: Create reaction
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: dev-to.createreaction
      outputParameters:
      - type: object
        mapping: $.
    - name: getreadinglist
      description: Readinglist
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getreadinglist
      outputParameters:
      - type: object
        mapping: $.
    - name: gettags
      description: Tags
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.gettags
      outputParameters:
      - type: object
        mapping: $.
    - name: getuserme
      description: The authenticated user
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getuserme
      outputParameters:
      - type: object
        mapping: $.
    - name: getuser
      description: A User
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getuser
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: string
        description: The ID of the user.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: unpublishuser
      description: Unpublish a User's Articles and Comments
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: dev-to.unpublishuser
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: integer
        description: The ID of the user.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: suspenduser
      description: Suspend a User
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: dev-to.suspenduser
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: integer
        description: The ID of the user.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: getwebhooks
      description: Webhooks
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getwebhooks
      outputParameters:
      - type: object
        mapping: $.
    - name: createwebhook
      description: Create a webhook
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: dev-to.createwebhook
      outputParameters:
      - type: object
        mapping: $.
    - name: getwebhookbyid
      description: A webhook endpoint
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dev-to.getwebhookbyid
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: integer
        description: The ID of the webhook.
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: deletewebhook
      description: Delete a webhook endpoint
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: dev-to.deletewebhook
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: integer
        description: The ID of the webhook.
        required: true
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    DEV_TO_TOKEN: DEV_TO_TOKEN