Jump to

• Request
• Response

Creates a new membership

post

/learn.rest/v1/memberships

Request

Supported Media Types

• application/json

Body ()

Membership object that needs to be created.

Root Schema : MembershipRequest

Type: object

Show Source

• learnCenterId: number(int32)
  Minimum Value: 178409

  Maximum Value: 1.0E18

  Example: 178784
• status: string
  Example: approved
• userId: number
  Minimum Value: 112867

  Maximum Value: 1.0E18

  Example: 112900
• validFromDate(optional): string(date-time)
  Example: 2016-02-23T07:21:00-05:00
• validUntilDate(optional): string(date-time)
  Example: 2016-02-23T07:21:00-05:00

{
    "type":"object",
    "required":[
        "learnCenterId",
        "status",
        "userId"
    ],
    "properties":{
        "learnCenterId":{
            "type":"number",
            "format":"int32",
            "example":178784,
            "minimum":178409,
            "maximum":1.0E18
        },
        "userId":{
            "type":"number",
            "example":112900,
            "minimum":112867,
            "maximum":1.0E18
        },
        "status":{
            "type":"string",
            "example":"approved"
        },
        "validFromDate":{
            "type":"string",
            "format":"date-time",
            "example":"2016-02-23T07:21:00-05:00"
        },
        "validUntilDate":{
            "type":"string",
            "format":"date-time",
            "example":"2016-02-23T07:21:00-05:00"
        }
    },
    "example":{
        "learnCenterId":178784,
        "userId":112900,
        "status":"approved",
        "validFromDate":"2016-02-23T07:21:00-05:00",
        "validUntilDate":"2016-02-23T07:21:00-05:00"
    }
}

Example:

{
    "learnCenterId":178784,
    "userId":112900,
    "status":"approved",
    "validFromDate":"2016-02-23T07:21:00-05:00",
    "validUntilDate":"2016-02-23T07:21:00-05:00"
}

Security

• auth: basic
  Type: basic

  Description: Basic Authentication

Back to Top

Response

Supported Media Types

• application/json

201 Response

New membership resource created.

Body ()

Root Schema : MembershipResponse

Type: object

Show Source

• createdDate(optional): string
  Example: 2016-02-23T07:21:00-05:00
• id(optional): number(int32)
  Example: 1345
• learnCenter(optional): array learnCenter
• learnCenterId(optional): number(int32)
  Example: 178784
• links(optional): object MembershipLinkItem
  Link to a Membership item.
• status(optional): string
  Example: approved
• statusChangedByUser(optional): array statusChangedByUser
• statusChangedByUserId(optional): string
  Example: 135131
• statusChangedDate(optional): string
  Example: 2016-02-23T07:21:00-05:00
• user(optional): array user
• userId(optional): number
  Example: 112900
• validFromDate(optional): string(datetime)
  Example: 2016-02-23T07:21:00-05:00
• validUntilDate(optional): string(datetime)
  Example: 2016-02-23T07:21:00-05:00

{
    "type":"object",
    "properties":{
        "id":{
            "type":"number",
            "format":"int32",
            "example":1345
        },
        "learnCenterId":{
            "type":"number",
            "format":"int32",
            "example":178784
        },
        "learnCenter":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/LearnCenterLinkItem"
            }
        },
        "userId":{
            "type":"number",
            "example":112900
        },
        "user":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/UserLinkItem"
            }
        },
        "createdDate":{
            "type":"string",
            "example":"2016-02-23T07:21:00-05:00"
        },
        "status":{
            "type":"string",
            "example":"approved"
        },
        "statusChangedDate":{
            "type":"string",
            "example":"2016-02-23T07:21:00-05:00"
        },
        "statusChangedByUserId":{
            "type":"string",
            "example":"135131"
        },
        "statusChangedByUser":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/UserLinkItem"
            }
        },
        "validFromDate":{
            "type":"string",
            "format":"datetime",
            "example":"2016-02-23T07:21:00-05:00"
        },
        "validUntilDate":{
            "type":"string",
            "format":"datetime",
            "example":"2016-02-23T07:21:00-05:00"
        },
        "links":{
            "$ref":"#/definitions/MembershipLinkItem"
        }
    }
}

Nested Schema : learnCenter

Type: array

Show Source

• Array of: object LearnCenterLinkItem

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/LearnCenterLinkItem"
    }
}

Nested Schema : MembershipLinkItem

Type: object

Link to a Membership item.

Show Source

• href(optional): string
  Example: {url}/learn.rest/v1/memberships/456
• rel(optional): string
  Example: canonical

{
    "description":"Link to a Membership item.",
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "example":"canonical"
        },
        "href":{
            "type":"string",
            "example":"{url}/learn.rest/v1/memberships/456"
        }
    },
    "example":{
        "rel":"canonical",
        "href":"{url}/learn.rest/v1/memberships/456"
    }
}

Example:

{
    "rel":"canonical",
    "href":"{url}/learn.rest/v1/memberships/456"
}

Nested Schema : statusChangedByUser

Type: array

Show Source

• Array of: object UserLinkItem
  Object of the User Link Item.

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/UserLinkItem"
    }
}

Nested Schema : user

Type: array

Show Source

• Array of: object UserLinkItem
  Object of the User Link Item.

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/UserLinkItem"
    }
}

Nested Schema : LearnCenterLinkItem

Type: object

Show Source

• href(optional): string
  Example: {url}/learn.rest/v1/learncenters/123456
• rel(optional): string
  Example: canonical

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "example":"canonical"
        },
        "href":{
            "type":"string",
            "example":"{url}/learn.rest/v1/learncenters/123456"
        }
    },
    "example":{
        "rel":"canonical",
        "href":"{url}/learn.rest/v1/learncenters/123456"
    }
}

Example:

{
    "rel":"canonical",
    "href":"{url}/learn.rest/v1/learncenters/123456"
}

Nested Schema : UserLinkItem

Type: object

Object of the User Link Item.

Show Source

• href(optional): string
  Example: {url}/learn.rest/v1/users/456
• rel(optional): string
  Example: canonical

{
    "description":"Object of the User Link Item.",
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "example":"canonical"
        },
        "href":{
            "type":"string",
            "example":"{url}/learn.rest/v1/users/456"
        }
    },
    "example":{
        "rel":"canonical",
        "href":"{url}/learn.rest/v1/users/456"
    }
}

Example:

{
    "rel":"canonical",
    "href":"{url}/learn.rest/v1/users/456"
}

400 Response

Request has incorrect syntax or does not contain a field that is required.

409 Response

Another resource with the same identifier already exists.

500 Response

Internal server error.

Back to Top