create_post
Creates a post on the authenticated user’s profile.
Parameters
authorId (required)
authorId is the user id of the authenticated user.
Type: string
$body
Creates a post for user.
Type: object
{
"license" : "The license of the post. Valid values are `all-rights-reserved`, `cc-40-by`, `cc-40-by-sa`, `cc-40-by-nd`, `cc-40-by-nc`, `cc-40-by-nc-nd`, `cc-40-by-nc-sa`, `cc-40-zero`, `public-domain`. The default is `all-rights-reserved`.",
"canonicalUrl" : "The original home of this content, if it was originally published elsewhere.",
"contentFormat" : "The format of the \"content\" field. There are two valid values, \"html\", and \"markdown\"",
"title" : "The title of the post. Note that this title is used for SEO and when rendering the post as a listing, but will not appear in the actual post—for that, the title must be specified in the content field as well. Titles longer than 100 characters will be ignored. In that case, a title will be synthesized from the first content in the post when it is published.",
"content" : "The body of the post, in a valid, semantic, HTML fragment, or Markdown. Further markups may be supported in the future. For a full list of accepted HTML tags, see here. If you want your title to appear on the post page, you must also include it as part of the post content.",
"publishStatus" : "The status of the post. Valid values are `public`, `draft`, or `unlisted`. The default is `public`.",
"tags" : [ "string" ]
}
create_publication_post
creating a post and associating it with a publication on Medium. The request also shows this association, considering posts a collection of resources under a publication
There are additional rules around publishing that each request to this API must respect:
- If the authenticated user is an 'editor' for the publication, they can create posts with any publish status. Posts published as 'public' or 'unlisted' will appear in collection immediately, while posts created as 'draft' will remain in pending state under publication.
- If the authenticated user is a 'writer' for the chosen publication, they can only create a post as a 'draft'. That post will remain in pending state under publication until an editor for the publication approves it.
- If the authenticated user is neither a 'writer' nor an 'editor', they are not allowed to create any posts in a publication.
Parameters
publicationId (required)
Here publicationId is the id of the publication the post is being created under. The publicationId can be acquired from the API for listing user’s publications.
Type: string
$body
Creates a post for publication.
Type: object
{
"license" : "The license of the post. Valid values are `all-rights-reserved`, `cc-40-by`, `cc-40-by-sa`, `cc-40-by-nd`, `cc-40-by-nc`, `cc-40-by-nc-nd`, `cc-40-by-nc-sa`, `cc-40-zero`, `public-domain`. The default is `all-rights-reserved`.",
"canonicalUrl" : "The original home of this content, if it was originally published elsewhere.",
"contentFormat" : "The format of the \"content\" field. There are two valid values, \"html\", and \"markdown\"",
"title" : "The title of the post. Note that this title is used for SEO and when rendering the post as a listing, but will not appear in the actual post—for that, the title must be specified in the content field as well. Titles longer than 100 characters will be ignored. In that case, a title will be synthesized from the first content in the post when it is published.",
"content" : "The body of the post, in a valid, semantic, HTML fragment, or Markdown. Further markups may be supported in the future. For a full list of accepted HTML tags, see here. If you want your title to appear on the post page, you must also include it as part of the post content.",
"publishStatus" : "The status of the post. Valid values are `public`, `draft`, or `unlisted`. The default is `public`.",
"tags" : [ "string" ]
}
get_my_profile
This operation has no parameters
get_my_publications
Returns a full list of publications that the user is related to in some way. This includes all publications the user is subscribed to, writes to, or edits.
Parameters
userId (required)
A unique identifier for the user.
Type: string
get_publication_contributors
This endpoint returns a list of contributors for a given publication. In other words, a list of Medium users who are allowed to publish under a publication, as well as a description of their exact role in the publication (for now, either an editor or a writer).
Parameters
publicationId (required)
A unique identifier for the publication.
Type: string