Group

A group represent a collection of candidates.

Create

Create a new group.

Request

POST /api/groups
Host:          api.happyrmatch.com
Authorization: Bearer eyJ0eXAi1QiLCJ...
Accept:        application/vnd.api+json

Response

HTTP/1.0 201 Created
Cache-Control: no-cache, private
Content-Type:  application/vnd.api+json
Date:          Fri, 13 May 2022 10:33:54 GMT

{
    "data": {
        "type": "group",
        "id": "8922133b-c74a-4e0f-99c7-9cfff10dc7a8",
        "attributes": []
    }
}

You can also create a group while adding candidates

Request

POST /api/groups
Host:          api.happyrmatch.com
Authorization: Bearer eyJ0eXAi1QiLCJ...
Accept:        application/vnd.api+json

{
    "candidates": [
        "[candidate_id]",
        "[candidate_id]"
    ]
}

Response

HTTP/1.0 201 Created
Cache-Control: no-cache, private
Content-Type:  application/vnd.api+json
Date:          Fri, 13 May 2022 10:33:54 GMT

{
    "data": {
        "type": "group",
        "id": "8922133b-c74a-4e0f-99c7-9cfff10dc7a8",
        "attributes": []
    }
}

Add candidates

Add candidates to a group.

Request

POST /api/groups/[group_id]/candidates
Host:          api.happyrmatch.com
Authorization: Bearer eyJ0eXAi1QiLCJ...
Accept:        application/vnd.api+json

{
    "candidates": [
        "[candidate_id]",
        "[candidate_id]"
    ]
}

Response

HTTP/1.0 202 Accepted
Cache-Control: no-cache, private
Content-Type:  application/vnd.api+json
Date:          Fri, 13 May 2022 10:33:54 GMT

{
    "meta": {
        "message": "Accepted"
    }
}

Remove candidates

Remove a candidate from a group.

Request

DELETE /api/groups/[group_id]/candidates/[candidate_id]
Host:          api.happyrmatch.com
Authorization: Bearer eyJ0eXAi1QiLCJ...
Accept:        application/vnd.api+json

Response

HTTP/1.0 202 Accepted
Cache-Control: no-cache, private
Content-Type:  application/vnd.api+json
Date:          Fri, 13 May 2022 10:33:54 GMT

{
    "meta": {
        "message": "Accepted"
    }
}