MetaVerb API Reference

InQ.Social MetaVerbs define actions that can be performed by a customer towards your product. Combinations of the MetaVerb & MetaProduct ids are stored in another object, called MetaTag. MetaTags then can be assigned to query options, beacons and action links.

MetaVerbs Fields returned by the API

Name Description Type
Id Verb Id string(GUID)
Name Verb Name string
IsPublic Indicates that the verb is public boolean
DateCreated Creation Date Date
ExecutionsCounter Number of time this verb been reported integer

 

Security

Each API request must be executed with a set of authentication details, set up in your InQ.Social administration area. Read more on InQ.Social API security options.

 

Endpoints

The InQ.Social API provides the following endpoints:

Get List of MetaVerbs in Organization

GET: https://api.inq.social/organizations/{organization-id}/metaactions

Optional parameters: see paged list paging parameters.
Returns a paged list of MetaVerbs for the given organization id.

 

Get MetaVerb Profile

GET: https://api.inq.social/organizations/{organization-id}/metaactions/{metaverb-id}

Returns the MetaVerb object.

 

Create

POST: https://api.inq.social/organizations/{organization-id}/metaactions

Request Fields

Name Mandatory Description Type
Name Yes Verb Name string

Response: if successful, the API will return status 200 and the new metaverb Id.

 

Update

PUT: https://api.inq.social/organizations/{organization-id}/metaactions

Request Fields

Name Mandatory Description Type
Id Yes Verb Id string(GUID)
Name Yes Verb Name string

Response: if successful, the API will return status 200.

 

Delete

DELETE: https://api.inq.social/organizations/{organization-id}/metaactions/{metaverb-id}

Response: if successful, the API will return status 200.