Create Blog
Creates a blog post in the organization in your `ORGID` header. New posts go to the end of the display order.
POST
/admin/blogCreate Blog
curl --request POST \
--url 'https://<your-api-host>/nuSource/api/v1/admin/blog' \
--header 'APIKEY: <your-api-key>' \
--header 'ORGID: <your-org-id>' \
--form 'featured_image=' \
--form 'JSONString={"blog_title":"Sample blog","blog_content":"<p>Sample blog testing</p>","blog_excerpt":"Test","blog_meta_title":"Sample blog","blog_meta_desc":"Test","blog_url_slug":"sample-blog","visibility_option":0,"blog_status":2,"is_featured":1,"is_promoted":0,"author_user_id":null,"stream_ids":[],"subscription_plan_ids":[],"tag_ids":[]}'{
"code": 200,
"message": "Blog created successfully."
}Access: Institute admins and tutors, plus custom roles that can manage blogs.
Request body: form-data with one field, JSONString, containing this JSON. Images go as separate file fields.
Body
JSONStringPost title.
Full post content. External images are copied into Edmingle. Empty content fails with "Please provide blog content.".
Short summary shown in listings.
SEO title.
SEO description.
URL slug, unique within your institute ("Slug already getting used." otherwise).
1 Public, 2 Private (hidden from the public listing), 3 Logged-in learners only.1 marks the post as featured.1 marks the post as promoted.blog_statusinteger
1 Draft, 2 Published (default).publish_dateUnix timestamp
Publish time. Defaults to now when published, empty for drafts.
author_user_idinteger
User shown as the author.
Categories (streams) of your institute. Unknown IDs fail with "One or more invalid institution stream ids provided.".
Subscription plans of your organization that unlock the post.
Blog tags of your organization.
blog_imagefile
Banner image. JPEG, PNG, GIF or WebP, up to 1 MB.
featured_imagefile
Featured (thumbnail) image. JPEG, PNG, GIF or WebP, up to 1 MB.
Response
codeinteger
Example:
200Notes: minutes_read and the public preview (first part of the post) are worked out from blog_content. Errors: "Please provide slug.", "Slug already getting used.", and the invalid-ID errors for streams, plans and tags. Rate limit: 30 requests per 1 minute; going over locks you out for 30 minutes.