Blogs Last updated: 2026-03-03

The Blog resource stores a blog article, used in the blog section of your website.

What you can do with blogs:

GET/api/v3/blogs?tag=Bob
Search for blogs that match a supplied query
GET/api/v3/blogs/{blog_oid}
Retrieve a single blog
GET/api/v3/blogs
List all blogs for a marketAgility site
POST/api/v3/blogs
Create a blog
PUT/api/v3/blogs/{blog_oid}
Update a blog

Blog Properties

Property	Description
OID	"OID": 12321 The marketAgility ID for the blog
SiteID	"SiteID": 1 The marketAgility Site Id for the blog
Title	"Title": "How to Be Successful" The title of the blog
Created	"Created": "2019-04-21T12:43:12" The date the blog was created
Modified	"Modified": "2020-05-12T08:03:00" The date the blog was last modified
Status	"Status": "Active" Defines whether a blog is active or inactive
OnlineStatus	"OnlineStatus": "Migrating" The live status of a blog (Staging, Migrating, Production)
OnlineDate	"OnlineDate": "2020-05-05T18:03:00" The date and time this blog was last updated in the production environment
Article Date	"ArticleDate": "2019-04-21T12:43:12" The date of the blog article
ShortDescription	"ShortDescription": "Click here to read our privacy policy" Limited text description of the blog (255 characters)
Content	"Content": "This is the Privacy policay" The actual content of the blog (up to 1GB)
Keywords	"Keywords": "Keyword1, Keyword 2" Keywords for searching and meta tags
Tags	"Tags": "success,how to" Tags for searching and filtering
URL	"URL": "https://www.virid.com" External link to more information
Url Identifier	"UrlIdentifier": "how-to-be-successful" What us the url handle of this articl
FullImage	"FullImage": "https://mabaseline.blob.core.windows.net/images/blogs/1_2649.jpg"" The Url of the full sized default image for the blog
PreviewImage	"PreviewImage": "https://mabaseline.blob.core.windows.net/images/blogs/1_2649_m.jpg" The Url of the mobile/preview sized default image for the bloge

Search blogs

Retrieves a list of blogs that share a common element(s). The following parameters are available:

GET	/api/v3/blogs?Title=Privacy+Policy

Parameter	Description
Title	Type: String The blog title
ShortDescription	Type: String A word or phrase in the short descriptio number
Tags	Type: String A tag used by the article
Keywords	Type: String A kewyord from the keywords field

View Sample Response


    HTTP/1.1 200 OK
    [
    {
    "OID": 2649,
    "SiteID": 1,
    "Created": "2018-02-07T16:40:03.43Z",
    "Modified": "2018-02-07T16:40:03.43Z",
    "Status": "Active",
    "OnlineStatus": "Migrating",
    "OnlineDate": "2018-02-07T16:40:03.43Z",
    "Title": "How To Be Successfuly",
    "ArticleDate": "2018-02-07T16:40:03.43Z",
    "ShortDescription": "Short Description",
    "Content": "The Content",
    "Keywords": "Key, Words",
    "Tags": "tag1, tag2",
    "URL": "https://www.virid.com",
    "UrlIdentifier": "how-to-be-successful",
    "FullImage": "https://mabaseline.blob.core.windows.net/images/blogs/1_2649.jpg",
    "PreviewImage": "https://mabaseline.blob.core.windows.net/images/blogs/1_2649_m.jpg",
    }
    ]

Get Blog

Gets a single blog by Id

GET	/api/v3/blogs/2649

View Sample Response


    HTTP/1.1 200 OK
    {
    "OID": 2649,
    "SiteID": 1,
    "Created": "2018-02-07T16:40:03.43Z",
    "Modified": "2018-02-07T16:40:03.43Z",
    "Status": "Active",
    "OnlineStatus": "Migrating",
    "OnlineDate": "2018-02-07T16:40:03.43Z",
    "Title": "How To Be Successfuly",
    "ArticleDate": "2018-02-07T16:40:03.43Z",
    "ShortDescription": "Short Description",
    "Content": "The Content",
    "Keywords": "Key, Words",
    "Tags": "tag1, tag2",
    "URL": "https://www.virid.com",
    "UrlIdentifier": "how-to-be-successful",
    "FullImage": "https://mabaseline.blob.core.windows.net/images/blogs/1_2649.jpg",
    "PreviewImage": "https://mabaseline.blob.core.windows.net/images/blogs/1_2649_m.jpg",
    }

List Blogs

Retrieves a list of blogs for a marketAgility site.

GET	/api/v3/blogs/

View Sample Response


    HTTP/1.1 200 OK
    [
    {
    "OID": 2649,
    "SiteID": 1,
    "Created": "2018-02-07T16:40:03.43Z",
    "Modified": "2018-02-07T16:40:03.43Z",
    "Status": "Active",
    "OnlineStatus": "Migrating",
    "OnlineDate": "2018-02-07T16:40:03.43Z",
    "Title": "How To Be Successfuly",
    "ArticleDate": "2018-02-07T16:40:03.43Z",
    "ShortDescription": "Short Description",
    "Content": "The Content",
    "Keywords": "Key, Words",
    "Tags": "tag1, tag2",
    "URL": "https://www.virid.com",
    "UrlIdentifier": "how-to-be-successful",
    "FullImage": "https://mabaseline.blob.core.windows.net/images/blogs/1_2649.jpg",
    "PreviewImage": "https://mabaseline.blob.core.windows.net/images/blogs/1_2649_m.jpg",
    }
    ]

Create a new blog

Create a blog.

POST	/api/v3/blogs/
{ "Title": "How To Be Successful", "Content": "This is the artcle body", "UrlIdentifier": "how-to-be-successful", "ArticleDate": "9-15-2020", }

View Sample Response


    HTTP/1.1 201 Created
    {
    "OID": 2649,
    "SiteID": 1,
    "Created": "2018-02-07T16:40:03.43Z",
    "Modified": "2018-02-07T16:40:03.43Z",
    "Status": "Active",
    "OnlineStatus": "Migrating",
    "OnlineDate": "2018-02-07T16:40:03.43Z",
    "Title": "How To Be Successfuly",
    "ArticleDate": "2018-02-07T16:40:03.43Z",
    "ShortDescription": "Short Description",
    "Content": "The Content",
    "Keywords": "Key, Words",
    "Tags": "tag1, tag2",
    "URL": "https://www.virid.com",
    "UrlIdentifier": "how-to-be-successful",
    "FullImage": "https://mabaseline.blob.core.windows.net/images/blogs/1_2649.jpg",
    "PreviewImage": "https://mabaseline.blob.core.windows.net/images/blogs/1_2649_m.jpg",
    }

Update Blog

Update an existing blog

PUT	/api/v3/blogs/2649
{ "PublicationDate": "9-22-2020", "Content": "This is the new privacy policy" }

View Sample Response


HTTP/1.1 204 No Content

Assets

The different assets available for a blog. These are most commonly images, but can be links to videos or other digital asset types

What you can do with an Asset:

GET/api/v3/blogs/{blog_oid}/assets/{asset_oid}
Retrieves a single Asset for a blog
GET/api/v3/blogs/{blog_oid}/assets
Lists all Assets for a blog
POST/api/v3/blogs/{blog_oid}/assets
Creates an Asset for a blog
PUT/api/v3/blogs/{blog_oid}/assets/{asset_oid}
Updates an Asset for a blog

Asset Properties

Property	Description
OID	"OID": 42608 The marketAgility ID for an asset
Name	"Name": "Back" The name of the asset
RelationCode	"RelationCode": "Back View" The alt tag of the view, or the link text if the asset is an external link
URL	"URL": "https://www.viridi.com" Optional Link to external content
Image	"ThumbImage": "https://mabaseline.blob.core.windows.net/..../1_42668_Back.JPG" The URL for the asset's image

Get Assets

Get an asset for a blog.

GET	api/v3/blogs/2649/assets/41317

View Sample Response


HTTP/1.1 200 OK
{
            "OID": 41317,
            "Name": "Back View",
            "RelationCode": "Back",
            "URL": ,
            "Image": "https://mabaseline.blob.core.windows.net/images/blogs/1_42668_Back%20View.jpg",
    
}

List Assets

Get all assets for a blog.

GET	api/v3/blogs/42668/assets

View Sample Response


HTTP/1.1 200 OK
[
    {
            "OID": 41317,
            "Name": "Back View",
            "RelationCode": "Back",
            "URL": ,
            "Image": "https://mabaseline.blob.core.windows.net/images/blogs/1_42668_Back%20View.jpg",
    
    }
]

Create Asset

Create an asset for a blog.

POST	/api/v3/blogs/2649/assets
{ "Name": "Back View", "Image": "https://somesite.com/source_image.png", }

View Sample Response


HTTP/1.1 201 Created
{
            "OID": 41317,
            "Name": "Back View",
            "RelationCode": "Back",
            "URL": ,
            "Image": "https://mabaseline.blob.core.windows.net/images/blogs/1_42668_Back%20View.jpg",
}

Update Asset

Update an existing blog asset View

PUT	/api/v3/blogs/2649/assets/41317
{ "Name": "Back View", "Image": "https://somesite.com/new_source_view.png", }

View Sample Response


HTTP/1.1 204 No Content