Expertise tags

With expertise tags, you can sort out the particular skills or knowledge areas of your contacts. For instance, Homer Simpson could attribute a "Capitalism" expertise tag to his contact, Mr. Burns.

View expertise tags

Fetch a list of expertise tags

GET https://web.r0app.com/api/v1/orgs/:org_id/expertises

Returns a paginated list of an organization's expertise tags.

Query Parameters

Name	Type	Description
include[]	String	If set to deleted all active and deleted records will be returned in the response.
page	Integer	For more info, see the pagination section in the Getting started guide.
limit	Integer	For more info, see the pagination section in the Getting started guide.
search	String	Optional: can be used to search for expertise tags. (Don't forget to URL encode query parameters)

Example request

curl

curl https://web.r0app.com/api/v1/orgs/:org_id/expertises \
    -X GET \
    -H 'Authorization: Bearer <token>'

View contacts associated with an expertise tag

Fetch a list of contacts with a given expertise tag

GET https://web.r0app.com/api/v1/orgs/:org_id/expertises/:expertise_id/contacts

Returns a paginated list of an contacts that have a given expertise tag associated with them.

Path Parameters

Name	Type	Description
:expertise_id*	String

Query Parameters

Name	Type	Description
include[]	String	If set to deleted all active and deleted records will be returned in the response.
page	Integer	For more info, see the pagination section in the Getting started guide.

Example request

curl

curl https://web.r0app.com/api/v1/orgs/:org_id/expertises/:expertise_id/contacts \
    -X GET \
    -H 'Authorization: Bearer <token>'

Create an expertise tag

Create an expertise tag

POST https://web.r0app.com/api/v1/orgs/:org_id/expertises

Request Body

Name	Type	Description
expertise[name]*	String

Example request

curl

curl https://web.r0app.com/api/v1/orgs/:org_id/expertises \
    -X POST \
    -H 'Authorization: Bearer <token>' \
    -d 'expertise[name]=Management'

Update a expertise tag

Update an expertise tag

PATCH https://web.r0app.com/api/v1/orgs/:org_id/expertises/:expertise_id

Path Parameters

Name	Type	Description
:expertise_id*	String

Request Body

Name	Type	Description
expertise[name]*	String

Example request

curl

curl https://web.r0app.com/api/v1/orgs/:org_id/expertises/:expertise_id \
    -X PATCH \
    -H 'Authorization: Bearer <token>' \
    -d 'expertise[name]=Leadership'

Delete a expertise tag

Delete an expertise tag

DELETE https://web.r0app.com/api/v1/orgs/:org_id

Path Parameters

Name	Type	Description
:expertise_id*	String

Request Body

Name	Type	Description
soft_delete	String	Learn more about deleting records.

Example request

curl

curl https://web.r0app.com/api/v1/orgs/:org_id/expertises/:expertise_id \
    -X DELETE \
    -H 'Authorization: Bearer <token>'