Hashnode API reference

New to Corsair? See API access, authentication, and error handling.

Comments

list

comments.list List comments on a post Risk: read

await corsair.hashnode.api.comments.list({});

Input

Name	Type	Required	Description
`postId`	`string`	Yes	—
`first`	`number`	No	Defaults to 10.
`after`	`string`	No	—

Output

Name	Type	Required	Description
`post`	`object`	Yes	—

post full type

{
  comments: {
    edges: {
      node: {
        id: string,
        content: {
          html?: string,
          markdown?: string,
          text?: string
        },
        author?: {
          id: string,
          name: string,
          username: string,
          profilePicture?: string | null,
          coverImage?: string | null,
          bio?: {
            text?: string | null,
            html?: string,
            markdown?: string
          } | null,
          socialMediaLinks?: {
            twitter?: string | null,
            github?: string | null,
            linkedin?: string | null,
            website?: string | null
          } | null,
          location?: string | null,
          dateJoined?: string | null
        } | null,
        totalReactions: number,
        dateAdded: string
      },
      cursor: string
    }[],
    pageInfo: {
      hasNextPage: boolean,
      endCursor: string | null
    }
  }
}

Drafts

create

drafts.create Create a new draft Risk: write

await corsair.hashnode.api.drafts.create({});

Input

Name	Type	Required	Description
`publicationId`	`string`	Yes	—
`title`	`string`	No	—
`subtitle`	`string`	No	—
`contentMarkdown`	`string`	No	—
`slug`	`string`	No	—
`tags`	`object[]`	No	—
`seriesId`	`string`	No	—
`disableComments`	`boolean`	No	—
`originalArticleURL`	`string`	No	—
`publishedAt`	`string`	No	—
`settings`	`object`	No	—
`metaTags`	`object`	No	—
`coverImageOptions`	`object`	No	—
`publishAs`	`string`	No	—
`coAuthors`	`string[]`	No	—

tags full type

{
  slug: string,
  name?: string
}[]

settings full type

{
  enableTableOfContent?: boolean,
  delist?: boolean,
  activateNewsletter?: boolean,
  slugOverridden?: boolean
}

metaTags full type

{
  title?: string,
  description?: string,
  image?: string
}

coverImageOptions full type

{
  coverImageURL?: string,
  coverImageAttribution?: string,
  coverImagePhotographer?: string,
  isCoverAttributionHidden?: boolean,
  stickCoverToBottom?: boolean
}

Output

Name	Type	Required	Description
`createDraft`	`object`	Yes	—

createDraft full type

{
  draft: {
    id: string,
    title?: string | null,
    subtitle?: string | null,
    slug?: string | null,
    content?: {
      markdown?: string,
      html?: string,
      text?: string
    } | null,
    author?: {
      id: string,
      name: string,
      username: string,
      profilePicture?: string | null,
      coverImage?: string | null,
      bio?: {
        text?: string | null,
        html?: string,
        markdown?: string
      } | null,
      socialMediaLinks?: {
        twitter?: string | null,
        github?: string | null,
        linkedin?: string | null,
        website?: string | null
      } | null,
      location?: string | null,
      dateJoined?: string | null
    } | null,
    coverImage?: {
      url?: string | null,
      attribution?: string | null
    } | null,
    tags?: {
      id: string,
      name: string,
      slug: string
    }[] | null,
    publication?: {
      id: string,
      title: string
    } | null,
    series?: {
      id: string,
      name: string,
      slug: string
    } | null,
    updatedAt: string,
    scheduledDate?: string | null,
    readTimeInMinutes?: number,
    isSubmittedForReview?: boolean
  }
}

delete

drafts.delete Delete a draft [DESTRUCTIVE - IRREVERSIBLE] Risk: destructive · Irreversible

await corsair.hashnode.api.drafts.delete({});

Input

Name	Type	Required	Description
`draftId`	`string`	Yes	—

Output

Name	Type	Required	Description
`deleteDraft`	`object`	Yes	—

deleteDraft full type

{
  draft: {
    id: string
  } | null
}

get

drafts.get Get a draft by ID Risk: read

await corsair.hashnode.api.drafts.get({});

Input

Name	Type	Required	Description
`id`	`string`	Yes	—

Output

Name	Type	Required	Description
`draft`	`object \| null`	Yes	—

draft full type

{
  id: string,
  title?: string | null,
  subtitle?: string | null,
  slug?: string | null,
  content?: {
    markdown?: string,
    html?: string,
    text?: string
  } | null,
  author?: {
    id: string,
    name: string,
    username: string,
    profilePicture?: string | null,
    coverImage?: string | null,
    bio?: {
      text?: string | null,
      html?: string,
      markdown?: string
    } | null,
    socialMediaLinks?: {
      twitter?: string | null,
      github?: string | null,
      linkedin?: string | null,
      website?: string | null
    } | null,
    location?: string | null,
    dateJoined?: string | null
  } | null,
  coverImage?: {
    url?: string | null,
    attribution?: string | null
  } | null,
  tags?: {
    id: string,
    name: string,
    slug: string
  }[] | null,
  publication?: {
    id: string,
    title: string
  } | null,
  series?: {
    id: string,
    name: string,
    slug: string
  } | null,
  updatedAt: string,
  scheduledDate?: string | null,
  readTimeInMinutes?: number,
  isSubmittedForReview?: boolean
} | null

publish

drafts.publish Publish a draft as a post Risk: write

await corsair.hashnode.api.drafts.publish({});

Input

Name	Type	Required	Description
`draftId`	`string`	Yes	—

Output

Name	Type	Required	Description
`publishDraft`	`object`	Yes	—

publishDraft full type

{
  post: {
    id: string,
    title: string,
    subtitle?: string | null,
    slug: string,
    brief: string,
    url: string,
    coverImage?: {
      url?: string | null,
      isPortrait?: boolean,
      attribution?: string | null
    } | null,
    author?: {
      id: string,
      name: string,
      username: string,
      profilePicture?: string | null,
      coverImage?: string | null,
      bio?: {
        text?: string | null,
        html?: string,
        markdown?: string
      } | null,
      socialMediaLinks?: {
        twitter?: string | null,
        github?: string | null,
        linkedin?: string | null,
        website?: string | null
      } | null,
      location?: string | null,
      dateJoined?: string | null
    } | null,
    publication?: {
      id: string,
      title: string,
      url?: string | null,
      displayTitle?: string | null
    } | null,
    tags?: {
      id: string,
      name: string,
      slug: string
    }[] | null,
    content?: {
      html?: string,
      markdown?: string,
      text?: string
    } | null,
    seo?: {
      title?: string | null,
      description?: string | null
    } | null,
    ogMetaData?: {
      image?: string | null
    } | null,
    publishedAt: string,
    updatedAt?: string | null,
    readTimeInMinutes: number,
    reactionCount: number,
    responseCount: number,
    replyCount?: number,
    series?: {
      id: string,
      name: string,
      slug: string
    } | null,
    featured?: boolean
  }
}

update

drafts.update Update an existing draft Risk: write

await corsair.hashnode.api.drafts.update({});

Input

Name	Type	Required	Description
`draftId`	`string`	Yes	—
`title`	`string`	No	—
`subtitle`	`string`	No	—
`contentMarkdown`	`string`	No	—
`slug`	`string`	No	—
`tags`	`object[]`	No	—
`seriesId`	`string`	No	—
`disableComments`	`boolean`	No	—
`originalArticleURL`	`string`	No	—
`publishedAt`	`string`	No	—
`settings`	`object`	No	—
`metaTags`	`object`	No	—
`coverImageOptions`	`object`	No	—
`publishAs`	`string`	No	—
`coAuthors`	`string[]`	No	—

tags full type

{
  slug: string,
  name?: string
}[]

settings full type

{
  enableTableOfContent?: boolean,
  delist?: boolean,
  activateNewsletter?: boolean,
  slugOverridden?: boolean
}

metaTags full type

{
  title?: string,
  description?: string,
  image?: string
}

coverImageOptions full type

{
  coverImageURL?: string,
  coverImageAttribution?: string,
  coverImagePhotographer?: string,
  isCoverAttributionHidden?: boolean,
  stickCoverToBottom?: boolean
}

Output

Name	Type	Required	Description
`updateDraft`	`object`	Yes	—

updateDraft full type

{
  draft: {
    id: string,
    title?: string | null,
    subtitle?: string | null,
    slug?: string | null,
    content?: {
      markdown?: string,
      html?: string,
      text?: string
    } | null,
    author?: {
      id: string,
      name: string,
      username: string,
      profilePicture?: string | null,
      coverImage?: string | null,
      bio?: {
        text?: string | null,
        html?: string,
        markdown?: string
      } | null,
      socialMediaLinks?: {
        twitter?: string | null,
        github?: string | null,
        linkedin?: string | null,
        website?: string | null
      } | null,
      location?: string | null,
      dateJoined?: string | null
    } | null,
    coverImage?: {
      url?: string | null,
      attribution?: string | null
    } | null,
    tags?: {
      id: string,
      name: string,
      slug: string
    }[] | null,
    publication?: {
      id: string,
      title: string
    } | null,
    series?: {
      id: string,
      name: string,
      slug: string
    } | null,
    updatedAt: string,
    scheduledDate?: string | null,
    readTimeInMinutes?: number,
    isSubmittedForReview?: boolean
  }
}

Feed

list

feed.list Get the global feed of posts Risk: read

await corsair.hashnode.api.feed.list({});

Input

Name	Type	Required	Description
`first`	`number`	No	Defaults to 10.
`after`	`string`	No	—
`filter`	`object`	No	—

filter full type

{
  tags?: string[],
  excludeTags?: string[],
  publications?: string[],
  excludePublications?: string[]
}

Output

Name	Type	Required	Description
`feed`	`object`	Yes	—

feed full type

{
  edges: {
    node: {
      id: string,
      title: string,
      subtitle?: string | null,
      slug: string,
      brief: string,
      url: string,
      coverImage?: {
        url?: string | null,
        isPortrait?: boolean,
        attribution?: string | null
      } | null,
      author?: {
        id: string,
        name: string,
        username: string,
        profilePicture?: string | null,
        coverImage?: string | null,
        bio?: {
          text?: string | null,
          html?: string,
          markdown?: string
        } | null,
        socialMediaLinks?: {
          twitter?: string | null,
          github?: string | null,
          linkedin?: string | null,
          website?: string | null
        } | null,
        location?: string | null,
        dateJoined?: string | null
      } | null,
      publication?: {
        id: string,
        title: string,
        url?: string | null,
        displayTitle?: string | null
      } | null,
      tags?: {
        id: string,
        name: string,
        slug: string
      }[] | null,
      content?: {
        html?: string,
        markdown?: string,
        text?: string
      } | null,
      seo?: {
        title?: string | null,
        description?: string | null
      } | null,
      ogMetaData?: {
        image?: string | null
      } | null,
      publishedAt: string,
      updatedAt?: string | null,
      readTimeInMinutes: number,
      reactionCount: number,
      responseCount: number,
      replyCount?: number,
      series?: {
        id: string,
        name: string,
        slug: string
      } | null,
      featured?: boolean
    },
    cursor: string
  }[],
  pageInfo: {
    hasNextPage: boolean,
    endCursor: string | null
  }
}

Images

createUploadURL

images.createUploadURL Create a presigned image upload URL Risk: write

await corsair.hashnode.api.images.createUploadURL({});

Input

Name	Type	Required	Description
`contentType`	`string`	Yes	—

Output

Name	Type	Required	Description
`createImageUploadURL`	`object`	Yes	—

createImageUploadURL full type

{
  presignedPost: {
    url: string,
    fields: Record<string, any>
  }
}

Me

me

me Get the current authenticated user Risk: read

await corsair.hashnode.api.me({});

Input: empty object Output

Name	Type	Required	Description
`me`	`object`	Yes	—

me full type

{
  id: string,
  name: string,
  username: string,
  email: string,
  profilePicture?: string | null,
  coverImage?: string | null,
  bio?: {
    text?: string | null,
    html?: string,
    markdown?: string
  } | null,
  socialMediaLinks?: {
    twitter?: string | null,
    github?: string | null,
    linkedin?: string | null,
    website?: string | null
  } | null,
  location?: string | null,
  dateJoined?: string | null
}

Pages

get

pages.get Get a static page by slug Risk: read

await corsair.hashnode.api.pages.get({});

Input

Name	Type	Required	Description
`host`	`string`	Yes	—
`slug`	`string`	Yes	—

Output

Name	Type	Required	Description
`publication`	`object`	Yes	—

publication full type

{
  staticPage: {
    id: string,
    title: string,
    slug: string,
    content?: {
      html?: string,
      markdown?: string,
      text?: string
    } | null,
    hidden?: boolean,
    ogMetaData?: {
      image?: string | null
    } | null,
    seo?: {
      title?: string | null,
      description?: string | null
    } | null
  } | null
}

list

pages.list List static pages in a publication Risk: read

await corsair.hashnode.api.pages.list({});

Input

Name	Type	Required	Description
`host`	`string`	Yes	—
`first`	`number`	No	Defaults to 10.
`after`	`string`	No	—

Output

Name	Type	Required	Description
`publication`	`object`	Yes	—

publication full type

{
  staticPages: {
    edges: {
      node: {
        id: string,
        title: string,
        slug: string,
        content?: {
          html?: string,
          markdown?: string,
          text?: string
        } | null,
        hidden?: boolean,
        ogMetaData?: {
          image?: string | null
        } | null,
        seo?: {
          title?: string | null,
          description?: string | null
        } | null
      },
      cursor: string
    }[],
    pageInfo: {
      hasNextPage: boolean,
      endCursor: string | null
    }
  }
}

Posts

get

posts.get Get a single post by ID Risk: read

await corsair.hashnode.api.posts.get({});

Input

Name	Type	Required	Description
`id`	`string`	Yes	—

Output

Name	Type	Required	Description
`post`	`object \| null`	Yes	—

post full type

{
  id: string,
  title: string,
  subtitle?: string | null,
  slug: string,
  brief: string,
  url: string,
  coverImage?: {
    url?: string | null,
    isPortrait?: boolean,
    attribution?: string | null
  } | null,
  author?: {
    id: string,
    name: string,
    username: string,
    profilePicture?: string | null,
    coverImage?: string | null,
    bio?: {
      text?: string | null,
      html?: string,
      markdown?: string
    } | null,
    socialMediaLinks?: {
      twitter?: string | null,
      github?: string | null,
      linkedin?: string | null,
      website?: string | null
    } | null,
    location?: string | null,
    dateJoined?: string | null
  } | null,
  publication?: {
    id: string,
    title: string,
    url?: string | null,
    displayTitle?: string | null
  } | null,
  tags?: {
    id: string,
    name: string,
    slug: string
  }[] | null,
  content?: {
    html?: string,
    markdown?: string,
    text?: string
  } | null,
  seo?: {
    title?: string | null,
    description?: string | null
  } | null,
  ogMetaData?: {
    image?: string | null
  } | null,
  publishedAt: string,
  updatedAt?: string | null,
  readTimeInMinutes: number,
  reactionCount: number,
  responseCount: number,
  replyCount?: number,
  series?: {
    id: string,
    name: string,
    slug: string
  } | null,
  featured?: boolean
} | null

getBySlug

posts.getBySlug Get a post by publication host and slug Risk: read

await corsair.hashnode.api.posts.getBySlug({});

Input

Name	Type	Required	Description
`host`	`string`	Yes	—
`slug`	`string`	Yes	—

Output

Name	Type	Required	Description
`publication`	`object`	Yes	—

publication full type

{
  post: {
    id: string,
    title: string,
    subtitle?: string | null,
    slug: string,
    brief: string,
    url: string,
    coverImage?: {
      url?: string | null,
      isPortrait?: boolean,
      attribution?: string | null
    } | null,
    author?: {
      id: string,
      name: string,
      username: string,
      profilePicture?: string | null,
      coverImage?: string | null,
      bio?: {
        text?: string | null,
        html?: string,
        markdown?: string
      } | null,
      socialMediaLinks?: {
        twitter?: string | null,
        github?: string | null,
        linkedin?: string | null,
        website?: string | null
      } | null,
      location?: string | null,
      dateJoined?: string | null
    } | null,
    publication?: {
      id: string,
      title: string,
      url?: string | null,
      displayTitle?: string | null
    } | null,
    tags?: {
      id: string,
      name: string,
      slug: string
    }[] | null,
    content?: {
      html?: string,
      markdown?: string,
      text?: string
    } | null,
    seo?: {
      title?: string | null,
      description?: string | null
    } | null,
    ogMetaData?: {
      image?: string | null
    } | null,
    publishedAt: string,
    updatedAt?: string | null,
    readTimeInMinutes: number,
    reactionCount: number,
    responseCount: number,
    replyCount?: number,
    series?: {
      id: string,
      name: string,
      slug: string
    } | null,
    featured?: boolean
  } | null
}

list

posts.list List posts in a publication Risk: read

await corsair.hashnode.api.posts.list({});

Input

Name	Type	Required	Description
`host`	`string`	Yes	—
`first`	`number`	No	Defaults to 10.
`after`	`string`	No	—
`filter`	`object`	No	—

filter full type

{
  tagSlugs?: string[]
}

Output

Name	Type	Required	Description
`publication`	`object`	Yes	—

publication full type

{
  posts: {
    edges: {
      node: {
        id: string,
        title: string,
        subtitle?: string | null,
        slug: string,
        brief: string,
        url: string,
        coverImage?: {
          url?: string | null,
          isPortrait?: boolean,
          attribution?: string | null
        } | null,
        author?: {
          id: string,
          name: string,
          username: string,
          profilePicture?: string | null,
          coverImage?: string | null,
          bio?: {
            text?: string | null,
            html?: string,
            markdown?: string
          } | null,
          socialMediaLinks?: {
            twitter?: string | null,
            github?: string | null,
            linkedin?: string | null,
            website?: string | null
          } | null,
          location?: string | null,
          dateJoined?: string | null
        } | null,
        publication?: {
          id: string,
          title: string,
          url?: string | null,
          displayTitle?: string | null
        } | null,
        tags?: {
          id: string,
          name: string,
          slug: string
        }[] | null,
        content?: {
          html?: string,
          markdown?: string,
          text?: string
        } | null,
        seo?: {
          title?: string | null,
          description?: string | null
        } | null,
        ogMetaData?: {
          image?: string | null
        } | null,
        publishedAt: string,
        updatedAt?: string | null,
        readTimeInMinutes: number,
        reactionCount: number,
        responseCount: number,
        replyCount?: number,
        series?: {
          id: string,
          name: string,
          slug: string
        } | null,
        featured?: boolean
      },
      cursor: string
    }[],
    pageInfo: {
      hasNextPage: boolean,
      endCursor: string | null
    },
    totalDocuments?: number
  }
}

publish

posts.publish Publish a new post Risk: write

await corsair.hashnode.api.posts.publish({});

Input

Name	Type	Required	Description
`title`	`string`	Yes	—
`publicationId`	`string`	Yes	—
`contentMarkdown`	`string`	Yes	—
`subtitle`	`string`	No	—
`slug`	`string`	No	—
`coverImage`	`string`	No	—
`tags`	`object[]`	No	—
`originalArticleURL`	`string`	No	—
`metaTitle`	`string`	No	—
`metaDescription`	`string`	No	—
`ogImage`	`string`	No	—
`disableComments`	`boolean`	No	—
`isDelisted`	`boolean`	No	—
`enableToc`	`boolean`	No	—
`publishAs`	`string`	No	—
`coAuthors`	`string[]`	No	—
`seriesId`	`string`	No	—
`publishedAt`	`string`	No	—

tags full type

{
  slug: string,
  name?: string
}[]

Output

Name	Type	Required	Description
`publishPost`	`object`	Yes	—

publishPost full type

{
  post: {
    id: string,
    title: string,
    subtitle?: string | null,
    slug: string,
    brief: string,
    url: string,
    coverImage?: {
      url?: string | null,
      isPortrait?: boolean,
      attribution?: string | null
    } | null,
    author?: {
      id: string,
      name: string,
      username: string,
      profilePicture?: string | null,
      coverImage?: string | null,
      bio?: {
        text?: string | null,
        html?: string,
        markdown?: string
      } | null,
      socialMediaLinks?: {
        twitter?: string | null,
        github?: string | null,
        linkedin?: string | null,
        website?: string | null
      } | null,
      location?: string | null,
      dateJoined?: string | null
    } | null,
    publication?: {
      id: string,
      title: string,
      url?: string | null,
      displayTitle?: string | null
    } | null,
    tags?: {
      id: string,
      name: string,
      slug: string
    }[] | null,
    content?: {
      html?: string,
      markdown?: string,
      text?: string
    } | null,
    seo?: {
      title?: string | null,
      description?: string | null
    } | null,
    ogMetaData?: {
      image?: string | null
    } | null,
    publishedAt: string,
    updatedAt?: string | null,
    readTimeInMinutes: number,
    reactionCount: number,
    responseCount: number,
    replyCount?: number,
    series?: {
      id: string,
      name: string,
      slug: string
    } | null,
    featured?: boolean
  }
}

search

posts.search Search posts within a publication Risk: read

await corsair.hashnode.api.posts.search({});

Input

Name	Type	Required	Description
`first`	`number`	No	Defaults to 10.
`after`	`string`	No	—
`sortBy`	`DATE_PUBLISHED_ASC \| DATE_PUBLISHED_DESC`	No	—
`filter`	`object`	Yes	—

filter full type

{
  query?: string,
  publicationId: string,
  deletedOnly?: boolean,
  authorIds?: string[],
  tagIds?: string[]
}

Output

Name	Type	Required	Description
`searchPostsOfPublication`	`object`	Yes	—

searchPostsOfPublication full type

{
  edges: {
    node: {
      id: string,
      title: string,
      subtitle?: string | null,
      slug: string,
      brief: string,
      url: string,
      coverImage?: {
        url?: string | null,
        isPortrait?: boolean,
        attribution?: string | null
      } | null,
      author?: {
        id: string,
        name: string,
        username: string,
        profilePicture?: string | null,
        coverImage?: string | null,
        bio?: {
          text?: string | null,
          html?: string,
          markdown?: string
        } | null,
        socialMediaLinks?: {
          twitter?: string | null,
          github?: string | null,
          linkedin?: string | null,
          website?: string | null
        } | null,
        location?: string | null,
        dateJoined?: string | null
      } | null,
      publication?: {
        id: string,
        title: string,
        url?: string | null,
        displayTitle?: string | null
      } | null,
      tags?: {
        id: string,
        name: string,
        slug: string
      }[] | null,
      content?: {
        html?: string,
        markdown?: string,
        text?: string
      } | null,
      seo?: {
        title?: string | null,
        description?: string | null
      } | null,
      ogMetaData?: {
        image?: string | null
      } | null,
      publishedAt: string,
      updatedAt?: string | null,
      readTimeInMinutes: number,
      reactionCount: number,
      responseCount: number,
      replyCount?: number,
      series?: {
        id: string,
        name: string,
        slug: string
      } | null,
      featured?: boolean
    },
    cursor: string
  }[],
  pageInfo: {
    hasNextPage: boolean,
    endCursor: string | null
  }
}

update

posts.update Update an existing post Risk: write

await corsair.hashnode.api.posts.update({});

Input

Name	Type	Required	Description
`id`	`string`	Yes	—
`title`	`string`	No	—
`subtitle`	`string`	No	—
`contentMarkdown`	`string`	No	—
`slug`	`string`	No	—
`coverImage`	`string`	No	—
`tags`	`object[]`	No	—
`originalArticleURL`	`string`	No	—
`metaTitle`	`string`	No	—
`metaDescription`	`string`	No	—
`ogImage`	`string`	No	—
`disableComments`	`boolean`	No	—
`isDelisted`	`boolean`	No	—
`enableToc`	`boolean`	No	—
`publishAs`	`string`	No	—
`coAuthors`	`string[]`	No	—
`seriesId`	`string`	No	—
`publishedAt`	`string`	No	—

tags full type

{
  slug: string,
  name?: string
}[]

Output

Name	Type	Required	Description
`updatePost`	`object`	Yes	—

updatePost full type

{
  post: {
    id: string,
    title: string,
    subtitle?: string | null,
    slug: string,
    brief: string,
    url: string,
    coverImage?: {
      url?: string | null,
      isPortrait?: boolean,
      attribution?: string | null
    } | null,
    author?: {
      id: string,
      name: string,
      username: string,
      profilePicture?: string | null,
      coverImage?: string | null,
      bio?: {
        text?: string | null,
        html?: string,
        markdown?: string
      } | null,
      socialMediaLinks?: {
        twitter?: string | null,
        github?: string | null,
        linkedin?: string | null,
        website?: string | null
      } | null,
      location?: string | null,
      dateJoined?: string | null
    } | null,
    publication?: {
      id: string,
      title: string,
      url?: string | null,
      displayTitle?: string | null
    } | null,
    tags?: {
      id: string,
      name: string,
      slug: string
    }[] | null,
    content?: {
      html?: string,
      markdown?: string,
      text?: string
    } | null,
    seo?: {
      title?: string | null,
      description?: string | null
    } | null,
    ogMetaData?: {
      image?: string | null
    } | null,
    publishedAt: string,
    updatedAt?: string | null,
    readTimeInMinutes: number,
    reactionCount: number,
    responseCount: number,
    replyCount?: number,
    series?: {
      id: string,
      name: string,
      slug: string
    } | null,
    featured?: boolean
  }
}

Publications

get

publications.get Get a publication by host Risk: read

await corsair.hashnode.api.publications.get({});

Input

Name	Type	Required	Description
`host`	`string`	Yes	—

Output

Name	Type	Required	Description
`publication`	`object \| null`	Yes	—

publication full type

{
  id: string,
  title: string,
  displayTitle?: string | null,
  url?: string | null,
  favicon?: string | null,
  about?: {
    text?: string | null,
    html?: string,
    markdown?: string
  } | null,
  seo?: {
    title?: string | null,
    description?: string | null
  } | null,
  author?: {
    id: string,
    name: string,
    username: string,
    profilePicture?: string | null,
    coverImage?: string | null,
    bio?: {
      text?: string | null,
      html?: string,
      markdown?: string
    } | null,
    socialMediaLinks?: {
      twitter?: string | null,
      github?: string | null,
      linkedin?: string | null,
      website?: string | null
    } | null,
    location?: string | null,
    dateJoined?: string | null
  } | null,
  ogMetaData?: {
    image?: string | null
  } | null,
  isTeam?: boolean,
  links?: {
    twitter?: string | null,
    github?: string | null,
    linkedin?: string | null,
    website?: string | null
  } | null,
  followersCount?: number | null
} | null

list

publications.list List publications for the authenticated user Risk: read

await corsair.hashnode.api.publications.list({});

Input

Name	Type	Required	Description
`first`	`number`	No	Defaults to 10.
`after`	`string`	No	—

Output

Name	Type	Required	Description
`me`	`object`	Yes	—

me full type

{
  publications: {
    edges: {
      node: {
        id: string,
        title: string,
        displayTitle?: string | null,
        url?: string | null,
        favicon?: string | null,
        about?: {
          text?: string | null,
          html?: string,
          markdown?: string
        } | null,
        seo?: {
          title?: string | null,
          description?: string | null
        } | null,
        author?: {
          id: string,
          name: string,
          username: string,
          profilePicture?: string | null,
          coverImage?: string | null,
          bio?: {
            text?: string | null,
            html?: string,
            markdown?: string
          } | null,
          socialMediaLinks?: {
            twitter?: string | null,
            github?: string | null,
            linkedin?: string | null,
            website?: string | null
          } | null,
          location?: string | null,
          dateJoined?: string | null
        } | null,
        ogMetaData?: {
          image?: string | null
        } | null,
        isTeam?: boolean,
        links?: {
          twitter?: string | null,
          github?: string | null,
          linkedin?: string | null,
          website?: string | null
        } | null,
        followersCount?: number | null
      },
      cursor: string
    }[],
    pageInfo: {
      hasNextPage: boolean,
      endCursor: string | null
    }
  }
}

Series

get

series.get Get a series by slug Risk: read

await corsair.hashnode.api.series.get({});

Input

Name	Type	Required	Description
`slug`	`string`	Yes	—

Output

Name	Type	Required	Description
`series`	`object \| null`	Yes	—

series full type

{
  id: string,
  name: string,
  slug: string,
  description?: {
    text?: string | null,
    html?: string,
    markdown?: string
  } | null,
  coverImage?: string | null,
  author?: {
    id: string,
    name: string,
    username: string,
    profilePicture?: string | null,
    coverImage?: string | null,
    bio?: {
      text?: string | null,
      html?: string,
      markdown?: string
    } | null,
    socialMediaLinks?: {
      twitter?: string | null,
      github?: string | null,
      linkedin?: string | null,
      website?: string | null
    } | null,
    location?: string | null,
    dateJoined?: string | null
  } | null
} | null

list

series.list List series in a publication Risk: read

await corsair.hashnode.api.series.list({});

Input

Name	Type	Required	Description
`host`	`string`	Yes	—
`first`	`number`	No	Defaults to 10.
`after`	`string`	No	—

Output

Name	Type	Required	Description
`publication`	`object`	Yes	—

publication full type

{
  seriesList: {
    edges: {
      node: {
        id: string,
        name: string,
        slug: string,
        description?: {
          text?: string | null,
          html?: string,
          markdown?: string
        } | null,
        coverImage?: string | null,
        author?: {
          id: string,
          name: string,
          username: string,
          profilePicture?: string | null,
          coverImage?: string | null,
          bio?: {
            text?: string | null,
            html?: string,
            markdown?: string
          } | null,
          socialMediaLinks?: {
            twitter?: string | null,
            github?: string | null,
            linkedin?: string | null,
            website?: string | null
          } | null,
          location?: string | null,
          dateJoined?: string | null
        } | null
      },
      cursor: string
    }[],
    pageInfo: {
      hasNextPage: boolean,
      endCursor: string | null
    }
  }
}

Name	Type	Required	Description
`tag`	`object \| null`	Yes	—

Users

get

users.get Get a user by username Risk: read

await corsair.hashnode.api.users.get({});

Input

Name	Type	Required	Description
`username`	`string`	Yes	—

Output

Name	Type	Required	Description
`user`	`object \| null`	Yes	—

user full type

{
  id: string,
  name: string,
  username: string,
  profilePicture?: string | null,
  coverImage?: string | null,
  bio?: {
    text?: string | null,
    html?: string,
    markdown?: string
  } | null,
  socialMediaLinks?: {
    twitter?: string | null,
    github?: string | null,
    linkedin?: string | null,
    website?: string | null
  } | null,
  location?: string | null,
  dateJoined?: string | null
} | null

Overview

Plugins

Hashnode API reference

Comments

list

Drafts

create

delete

get

publish

update

Feed

list

Images

createUploadURL

Me

me

Pages

get

list

Posts

get

getBySlug

list

publish

search

update

Publications

get

list

Series

get

list

Tags

get

Users

get

​Comments

​list

​Drafts

​create

​delete

​get

​publish

​update

​Feed

​list

​Images

​createUploadURL

​Me

​me

​Pages

​get

​list

​Posts

​get

​getBySlug

​list

​publish

​search

​update

​Publications

​get

​list

​Series

​get

​list

​Tags

​get

​Users

​get

Comments

list

Drafts

create

delete

get

publish

update

Feed

list

Images

createUploadURL

Me

me

Pages

get

list

Posts

get

getBySlug

list

publish

search

update

Publications

get

list

Series

get

list

Tags

get

Users

get