CAcardda
Company role

Retrieve a company role

Returns a single company role belonging to the company, including its permissions (only id and name per permission).

get/v1/companies/{company_id}/company_roles/{id}

Request

  • Base URL
    https://api.cardda.com
  • URL
    https://api.cardda.com/v1/companies/{company_id}/company_roles/{id}
  • Auth
    HTTP bearer

Path parameters

company_idstring uuid required

The UUID of the company the nested resource belongs to.

idstring required

The id of the resource. This is a UUID for most resources, but for user endpoints it is the user's Firebase UID (an opaque string), so no uuid format is asserted here.

Parameters

#/paths/~1v1~1users/get/parameters/0 (unresolved $ref)

Response

The requested company role.

idstring uuid required
company_idstring uuid required
namestring required
descriptionstring nullable
created_atstring date-time
updated_atstring date-time

Example response

{
  "name": "Finance",
  "permissions": [
    {
      "name": "cards_view"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.