Create / Update Profile-Company Role

This API allows you to send bulk role (profile-to-company assignments) updates to Releva. Any profile which do not exist in Releva will be created.

Any change will be available according to our SLA.

Do I need to call it? #

This API should be integrated if you intend to use Releva in a B2B context. For B2C, you only need the APIs for creating / updating / deleting profiles.

Request Parameters #

You may perform requests to the API using the following curl equivalent:

curl -H 'Content-Type: application/json' -H 'Authorization: Bearer <secretKey>' -XPOST https://releva.ai/api/v0/roles -d'{
    "roles": [
        {
                "companyId": "123",
                "role": "CTO",
                "profile": {
                  "email": "yavor@releva.ai",
                  "phoneNumber": "+359123"
                },
            
        },
        {
                "companyId": "123",
                "role": "CEO",
                "profile": {
                  "email": "georgi@releva.ai",
                  "phoneNumber": "+359234"
                },
            
        },
    ]
}'

The roles Object #

A successful response will return HTTP Status 202 with an empty response body ({}).

Response Format #

An error response will return a HTTP 4xx or 5xx status code and have the following structure:

{
  "message": "A description of the error and how to fix it, if it's a client error."
}