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"
        }
    }
}

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 MembershipLink
• 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/LearnCenterLink"
            }
        },
        "userId":{
            "type":"number",
            "example":112900
        },
        "user":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/UserLink"
            }
        },
        "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/UserLink"
            }
        },
        "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/MembershipLink"
        }
    }
}

Nested Schema : learnCenter

Type: array

Show Source

• Array of: object LearnCenterLink
  Object containing Learn Center Links.

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

Nested Schema : MembershipLink

Type: object

Show Source

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

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

Nested Schema : statusChangedByUser

Type: array

Show Source

• Array of: object UserLink

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

Nested Schema : user

Type: array

Show Source

• Array of: object UserLink

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

Nested Schema : LearnCenterLink

Type: object

Object containing Learn Center Links.

Show Source

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

{
    "type":"object",
    "description":"Object containing Learn Center Links.",
    "properties":{
        "rel":{
            "type":"string",
            "example":"canonical"
        },
        "href":{
            "type":"string",
            "example":"{url}/learn.rest/v1/learnCenters/178409"
        }
    }
}

Nested Schema : UserLink

Type: object

Show Source

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

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "example":"canonical"
        },
        "href":{
            "type":"string",
            "example":"{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