CAcardda
Company role

Delete a company role

Deletes a custom company role. A role that is still assigned to one or more memberships cannot be deleted and returns 422.

delete/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 role was deleted.

messagestring

Example response

{
  "message": "Company role deleted"
}

Changes

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