Contents
Schema #
The schema defines all the fields that exist within a group record. Any response from these endpoints can be expected to contain the fields below unless the `_filter` query parameter is used or the schema field only appears in a specific context.
date string, null, datetime (details) |
The date the object was published, in the site's timezone. Context: |
date_gmt string, null, datetime (details) |
The date the object was published, as GMT. Context: |
guid object |
The globally unique identifier for the object. Read only Context: |
id integer |
Unique identifier for the object. Read only Context: |
link string, uri |
URL to the object. Read only Context: |
modified string, datetime (details) |
The date the object was last modified, in the site's timezone. Read only Context: |
modified_gmt string, datetime (details) |
The date the object was last modified, as GMT. Read only Context: |
slug string |
An alphanumeric identifier for the object unique to its type. Context: |
status string |
A named status for the object. Context: One of: |
type string |
Type of Post for the object. Read only Context: |
password string |
A password to protect access to the content and excerpt. Context: |
permalink_template string |
Permalink template for the object. Read only Context: |
generated_slug string |
Slug automatically generated from the object title. Read only Context: |
parent integer |
The ID for the parent of the object. Context: |
title object |
The title for the object. Context: |
content object |
The content for the object. Context: |
author integer |
The ID for the author of the object. Context: |
featured_media integer |
The ID of the featured media for the object. Context: |
template string |
The theme file to use to display the object. Context: |
categories array |
The terms assigned to the object in the category taxonomy. Context: |
tags array |
The terms assigned to the object in the post_tag taxonomy. Context: |
ld_group_category array |
The terms assigned to the object in the ld_group_category taxonomy. Context: |
ld_group_tag array |
The terms assigned to the object in the ld_group_tag taxonomy. Context: |
List Groups #
Query this endpoint to retrieve a collection of groups. The response you receive can be controlled and filtered using the URL query parameters below.
Definition #
GET /ldlms/v1/groups
Example Request #
$ curl https://example.com/wp-json/ldlms/v1/groups
Arguments #
context |
Scope under which the request is made; determines fields present in response.
Default: One of: |
page |
Current page of the collection.
Default: |
per_page |
Maximum number of items to be returned in result set.
Default: |
search |
Limit results to those matching a string. |
after |
Limit response to posts published after a given ISO8601 compliant date. |
modified_after |
Limit response to posts modified after a given ISO8601 compliant date. |
author |
Limit result set to posts assigned to specific authors. |
author_exclude |
Ensure result set excludes posts assigned to specific authors. |
before |
Limit response to posts published before a given ISO8601 compliant date. |
modified_before |
Limit response to posts modified before a given ISO8601 compliant date. |
exclude |
Ensure result set excludes specific IDs. |
include |
Limit result set to specific IDs. |
offset |
Offset the result set by a specific number of items. |
order |
Order sort attribute ascending or descending.
Default: One of: |
orderby |
Sort collection by object attribute.
Default: One of: |
parent |
Limit result set to items with particular parent IDs. |
parent_exclude |
Limit result set to all items except those of a particular parent ID. |
slug |
Limit result set to posts with one or more specific slugs. |
status |
Limit result set to posts assigned one or more statuses.
Default: |
tax_relation |
Limit result set based on relationship between multiple taxonomies. One of: |
categories |
Limit result set to items with specific terms assigned in the categories taxonomy. |
categories_exclude |
Limit result set to items except those with specific terms assigned in the categories taxonomy. |
tags |
Limit result set to items with specific terms assigned in the tags taxonomy. |
tags_exclude |
Limit result set to items except those with specific terms assigned in the tags taxonomy. |
ld_group_category |
Limit result set to items with specific terms assigned in the ld_group_category taxonomy. |
ld_group_category_exclude |
Limit result set to items except those with specific terms assigned in the ld_group_category taxonomy. |
ld_group_tag |
Limit result set to items with specific terms assigned in the ld_group_tag taxonomy. |
ld_group_tag_exclude |
Limit result set to items except those with specific terms assigned in the ld_group_tag taxonomy. |
Create a Group #
Arguments #
date |
The date the object was published, in the site's timezone. |
date_gmt |
The date the object was published, as GMT. |
slug |
An alphanumeric identifier for the object unique to its type. |
status |
A named status for the object. One of: |
password |
A password to protect access to the content and excerpt. |
parent |
The ID for the parent of the object. |
title |
The title for the object. |
content |
The content for the object. |
author |
The ID for the author of the object. |
featured_media |
The ID of the featured media for the object. |
template |
The theme file to use to display the object. |
categories |
The terms assigned to the object in the category taxonomy. |
tags |
The terms assigned to the object in the post_tag taxonomy. |
ld_group_category |
The terms assigned to the object in the ld_group_category taxonomy. |
ld_group_tag |
The terms assigned to the object in the ld_group_tag taxonomy. |
Definition #
POST /ldlms/v1/groups
Retrieve a Group #
Definition & Example Request #
GET /ldlms/v1/groups/<id>
Query this endpoint to retrieve a specific group record.
$ curl https://example.com/wp-json/ldlms/v1/groups/<id>
Sample Response #
{ "id": 19195, "date": "2018-04-19T13:19:38", "date_gmt": "2018-04-19T20:19:38", "guid": { "rendered": "https://example.com/?post_type=groups&p=19195" }, "modified": "2018-06-18T09:18:26", "modified_gmt": "2018-06-18T16:18:26", "slug": "health-coach-training-program-2017-2018", "status": "publish", "type": "groups", "link": "http://learndash.test/groups/health-coach-training-program-2017-2018/", "title": { "rendered": "Health Coach Training Program – 2017-2018" }, "content": { "rendered": "", "protected": false }, "template": "", "_links": { "self": [ { "href": "http://learndash.test/wp-json/ldlms/v1/groups/19195" } ], "collection": [ { "href": "http://learndash.test/wp-json/ldlms/v1/groups" } ], "about": [ { "href": "http://learndash.test/wp-json/wp/v2/types/groups" } ], "wp:attachment": [ { "href": "http://learndash.test/wp-json/wp/v2/media?parent=19195" } ], "curies": [ { "name": "wp", "href": "https://api.w.org/{rel}", "templated": true } ] } }
Arguments #
id |
Unique identifier for the object. Required: 1 |
context |
Scope under which the request is made; determines fields present in response.
Default: One of: |
password |
The password for the post if it is password protected. |
Update a Group #
Arguments #
id |
Unique identifier for the object. Required: 1 |
date |
The date the object was published, in the site's timezone. |
date_gmt |
The date the object was published, as GMT. |
slug |
An alphanumeric identifier for the object unique to its type. |
status |
A named status for the object. One of: |
password |
A password to protect access to the content and excerpt. |
parent |
The ID for the parent of the object. |
title |
The title for the object. |
content |
The content for the object. |
author |
The ID for the author of the object. |
featured_media |
The ID of the featured media for the object. |
template |
The theme file to use to display the object. |
categories |
The terms assigned to the object in the category taxonomy. |
tags |
The terms assigned to the object in the post_tag taxonomy. |
ld_group_category |
The terms assigned to the object in the ld_group_category taxonomy. |
ld_group_tag |
The terms assigned to the object in the ld_group_tag taxonomy. |